Simple Inventory MCP by usefulapi is an MCP server published by io.usefulapi, hosted at simple-inventory.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including simpleinventory_get_account, simpleinventory_list_folders, simpleinventory_list_items, simpleinventory_get_item, simpleinventory_list_recent_events.
Read items, stock, folders and events; change stock, items and event webhooks in Simple Inventory.
4,129 connections through 5 shared values. Tap any node.
Show the organization and API key this server uses, with the key's scopes (read, write). Good first call to check the connection. Simple Inventory API: GET /me.
No parameters.
{
"name": "simpleinventory_get_account",
"title": "Get the connected account",
"description": "Show the organization and API key this server uses, with the key's scopes (read, write). Good first call to check the connection. Simple Inventory API: GET /me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the connected account",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the organization's folders with their IDs and full paths. Use a folder ID as folderId when you create or move an item. Simple Inventory API: GET /folders.
No parameters.
{
"name": "simpleinventory_list_folders",
"title": "List folders",
"description": "List the organization's folders with their IDs and full paths. Use a folder ID as folderId when you create or move an item. Simple Inventory API: GET /folders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List folders",
"readOnlyHint": true
}
}List active (not archived) items with quantity, prices, SKU and folder. Search by name or SKU with search, or find one SKU with sku. To read every item, pass after=0 and then each response's pagination.nextAfter until hasMore is false. Simple Inventory API: GET /items.
| Parameter | Type | Description |
|---|---|---|
| sku | string | Return only the item with this SKU (only with offset 0). |
| after | integer | Return items with an ID greater than this, lowest first. Start with 0. Use instead of offset to read all items. |
| limit | integer | Items to return, 1-500 (default 100). |
| offset | integer | Items to skip (default 0). Ignored when after is set. |
| search | string | Items whose name or SKU contains this text (not case-sensitive). |
| include | string | "leaves" (default): standalone items and variations. "groups": items and variant groups. "all": both. |
{
"name": "simpleinventory_list_items",
"title": "List items",
"description": "List active (not archived) items with quantity, prices, SKU and folder. Search by name or SKU with search, or find one SKU with sku. To read every item, pass after=0 and then each response's pagination.nextAfter until hasMore is false. Simple Inventory API: GET /items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sku": {
"type": "string",
"maxLength": 100,
"description": "Return only the item with this SKU (only with offset 0)."
},
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Return items with an ID greater than this, lowest first. Start with 0. Use instead of offset to read all items."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Items to return, 1-500 (default 100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Items to skip (default 0). Ignored when after is set."
},
"search": {
"type": "string",
"maxLength": 255,
"description": "Items whose name or SKU contains this text (not case-sensitive)."
},
"include": {
"enum": [
"leaves",
"groups",
"all"
],
"type": "string",
"description": "\"leaves\" (default): standalone items and variations. \"groups\": items and variant groups. \"all\": both."
}
}
},
"annotations": {
"title": "List items",
"readOnlyHint": true
}
}Get one item by ID or SKU, including archived items (archived: true). A variant group also returns its variations. Simple Inventory API: GET /items/{identifier}.
| Parameter | Type | Description |
|---|---|---|
| by | string | How to read identifier: "auto" (default), "id", or "sku". Use "sku" when SKUs are numbers. |
| identifier * | string | The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too. |
{
"name": "simpleinventory_get_item",
"title": "Get an item",
"description": "Get one item by ID or SKU, including archived items (archived: true). A variant group also returns its variations. Simple Inventory API: GET /items/{identifier}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"by": {
"enum": [
"auto",
"id",
"sku"
],
"type": "string",
"description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers."
},
"identifier": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
}
}
},
"annotations": {
"title": "Get an item",
"readOnlyHint": true
}
}List the newest events of one type (stock changes, low or out-of-stock alerts, item created, updated or archived), newest first. Useful to test a webhook handler with real data. Simple Inventory API: GET /events.
| Parameter | Type | Description |
|---|---|---|
| type * | string | The event type, such as inventory.updated. |
| limit | integer | Events to return, 1-25 (default 10). |
{
"name": "simpleinventory_list_recent_events",
"title": "List recent events",
"description": "List the newest events of one type (stock changes, low or out-of-stock alerts, item created, updated or archived), newest first. Useful to test a webhook handler with real data. Simple Inventory API: GET /events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"inventory.updated",
"inventory.low_stock",
"inventory.out_of_stock",
"item.created",
"item.updated",
"item.archived"
],
"type": "string",
"description": "The event type, such as inventory.updated."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Events to return, 1-25 (default 10)."
}
}
},
"annotations": {
"title": "List recent events",
"readOnlyHint": true
}
}Create a standalone item, as adding it in the app would. It counts toward the plan's item limit and needs an organization that is not past due. Simple Inventory API: POST /items.
| Parameter | Type | Description |
|---|---|---|
| sku | string | SKU (up to 100 characters). Must not match another item's SKU. |
| name * | string | Item name (1-255 characters). |
| barcode | string | Barcode value. |
| folderId | integer | Folder ID (from simpleinventory_list_folders). |
| quantity | integer | Opening stock (default 0). |
| unitCost | number | What one unit costs (default 0). |
| salePrice | number | What one unit sells for. |
| description | string | Free-text description. |
| lowStockThreshold | integer | Stock level that counts as low. |
{
"name": "simpleinventory_create_item",
"title": "Create an item",
"description": "Create a standalone item, as adding it in the app would. It counts toward the plan's item limit and needs an organization that is not past due. Simple Inventory API: POST /items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 100,
"description": "SKU (up to 100 characters). Must not match another item's SKU."
},
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Item name (1-255 characters)."
},
"barcode": {
"type": "string",
"maxLength": 255,
"description": "Barcode value."
},
"folderId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Folder ID (from simpleinventory_list_folders).",
"exclusiveMinimum": 0
},
"quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "Opening stock (default 0)."
},
"unitCost": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "What one unit costs (default 0)."
},
"salePrice": {
"type": "number",
"maximum": 99999999.99,
"minimum": 0,
"description": "What one unit sells for."
},
"description": {
"type": "string",
"maxLength": 10000,
"description": "Free-text description."
},
"lowStockThreshold": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "Stock level that counts as low."
}
}
},
"annotations": {
"title": "Create an item",
"destructiveHint": true
}
}Change an item's details (not its stock). Send only the fields to change. null clears a field, except name. Archived items cannot be changed. Simple Inventory API: PATCH /items/{identifier}.
| Parameter | Type | Description |
|---|---|---|
| by | string | How to read identifier: "auto" (default), "id", or "sku". Use "sku" when SKUs are numbers. |
| sku | any | New SKU, or null to clear it. |
| name | string | New name. |
| barcode | any | New barcode, or null to clear it. |
| folderId | any | Move to this folder, or null to unfile it. |
| unitCost | any | New unit cost (null sets it to 0). |
| salePrice | any | New sale price, or null to clear it. |
| identifier * | string | The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too. |
| description | any | New description, or null to clear it. |
| lowStockThreshold | any | New low stock level, or null to clear it. |
{
"name": "simpleinventory_update_item",
"title": "Update an item's details",
"description": "Change an item's details (not its stock). Send only the fields to change. null clears a field, except name. Archived items cannot be changed. Simple Inventory API: PATCH /items/{identifier}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"by": {
"enum": [
"auto",
"id",
"sku"
],
"type": "string",
"description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers."
},
"sku": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
],
"description": "New SKU, or null to clear it."
},
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "New name."
},
"barcode": {
"anyOf": [
{
"type": "string",
"maxLength": 255
},
{
"type": "null"
}
],
"description": "New barcode, or null to clear it."
},
"folderId": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Move to this folder, or null to unfile it."
},
"unitCost": {
"anyOf": [
{
"type": "number",
"maximum": 99999999.99,
"minimum": 0
},
{
"type": "null"
}
],
"description": "New unit cost (null sets it to 0)."
},
"salePrice": {
"anyOf": [
{
"type": "number",
"maximum": 99999999.99,
"minimum": 0
},
{
"type": "null"
}
],
"description": "New sale price, or null to clear it."
},
"identifier": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 10000
},
{
"type": "null"
}
],
"description": "New description, or null to clear it."
},
"lowStockThreshold": {
"anyOf": [
{
"type": "integer",
"maximum": 1000000000,
"minimum": 0
},
{
"type": "null"
}
],
"description": "New low stock level, or null to clear it."
}
}
},
"annotations": {
"title": "Update an item's details",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Set, add to, or remove from one item's stock. operation "set" (default) makes stock exactly quantity; "increment" adds; "decrement" removes and stops at 0. Pass idempotencyKey so a retry cannot apply twice. Simple Inventory API: PATCH /items/{identifier}/quantity.
| Parameter | Type | Description |
|---|---|---|
| by | string | How to read identifier: "auto" (default), "id", or "sku". Use "sku" when SKUs are numbers. |
| reason | string | Note saved on the item's history entry. |
| quantity * | integer | The amount, 0 to 1,000,000,000. Stock cannot exceed 2,147,483,647. |
| operation | string | "set" (default), "increment" or "decrement". |
| identifier * | string | The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too. |
| idempotencyKey | string | Optional key so a retry cannot apply the same change twice (up to 255 characters). Use one new key per change. |
{
"name": "simpleinventory_change_stock",
"title": "Change an item's stock",
"description": "Set, add to, or remove from one item's stock. operation \"set\" (default) makes stock exactly quantity; \"increment\" adds; \"decrement\" removes and stops at 0. Pass idempotencyKey so a retry cannot apply twice. Simple Inventory API: PATCH /items/{identifier}/quantity.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier",
"quantity"
],
"properties": {
"by": {
"enum": [
"auto",
"id",
"sku"
],
"type": "string",
"description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers."
},
"reason": {
"type": "string",
"maxLength": 500,
"description": "Note saved on the item's history entry."
},
"quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "The amount, 0 to 1,000,000,000. Stock cannot exceed 2,147,483,647."
},
"operation": {
"enum": [
"set",
"increment",
"decrement"
],
"type": "string",
"description": "\"set\" (default), \"increment\" or \"decrement\"."
},
"identifier": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
},
"idempotencyKey": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Optional key so a retry cannot apply the same change twice (up to 255 characters). Use one new key per change."
}
}
},
"annotations": {
"title": "Change an item's stock",
"destructiveHint": true
}
}Change stock on 1-100 items in one request. Give each change an id or a sku. Each change applies on its own, so one failure does not stop the rest. A 200 reply can still list failed changes in errors: check success and errors. Simple Inventory API: POST /items/bulk-update.
| Parameter | Type | Description |
|---|---|---|
| items * | array | The stock changes, applied in order. |
| idempotencyKey | string | Optional key for the whole request. Change i is recorded as <key>:<i>, so resend the same list in the same order. |
{
"name": "simpleinventory_bulk_update_stock",
"title": "Change stock on many items",
"description": "Change stock on 1-100 items in one request. Give each change an id or a sku. Each change applies on its own, so one failure does not stop the rest. A 200 reply can still list failed changes in errors: check success and errors. Simple Inventory API: POST /items/bulk-update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item ID. Give id or sku.",
"exclusiveMinimum": 0
},
"sku": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Item SKU. Give id or sku."
},
"reason": {
"type": "string",
"maxLength": 500,
"description": "Note saved on the item's history entry."
},
"quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "The amount, 0 to 1,000,000,000."
},
"operation": {
"enum": [
"set",
"increment",
"decrement"
],
"type": "string",
"description": "\"set\" (default), \"increment\" or \"decrement\"."
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "The stock changes, applied in order."
},
"idempotencyKey": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Optional key for the whole request. Change i is recorded as <key>:<i>, so resend the same list in the same order."
}
}
},
"annotations": {
"title": "Change stock on many items",
"destructiveHint": true
}
}Send one event type to a URL you own, as a signed HTTP POST (HMAC-SHA256). The reply returns the signing secret only in the app (Settings → Integrations → Webhooks). Subscribing twice returns the existing subscription. Limit 50 API subscriptions per organization. Simple Inventory API: POST /hooks.
| Parameter | Type | Description |
|---|---|---|
| event * | string | The one event type to deliver. |
| targetUrl * | string | The HTTPS URL that receives the events. |
{
"name": "simpleinventory_subscribe_webhook",
"title": "Subscribe a URL to an event",
"description": "Send one event type to a URL you own, as a signed HTTP POST (HMAC-SHA256). The reply returns the signing secret only in the app (Settings → Integrations → Webhooks). Subscribing twice returns the existing subscription. Limit 50 API subscriptions per organization. Simple Inventory API: POST /hooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"targetUrl",
"event"
],
"properties": {
"event": {
"enum": [
"inventory.updated",
"inventory.low_stock",
"inventory.out_of_stock",
"item.created",
"item.updated",
"item.archived"
],
"type": "string",
"description": "The one event type to deliver."
},
"targetUrl": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "The HTTPS URL that receives the events."
}
}
},
"annotations": {
"title": "Subscribe a URL to an event",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Remove a subscription made with simpleinventory_subscribe_webhook, with its delivery log. Webhooks added in the app are not removed here. Simple Inventory API: DELETE /hooks/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The subscription ID returned by simpleinventory_subscribe_webhook. |
{
"name": "simpleinventory_unsubscribe_webhook",
"title": "Remove an API subscription",
"description": "Remove a subscription made with simpleinventory_subscribe_webhook, with its delivery log. Webhooks added in the app are not removed here. Simple Inventory API: DELETE /hooks/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The subscription ID returned by simpleinventory_subscribe_webhook.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Remove an API subscription",
"destructiveHint": true
}
}Tools for Simple Inventory, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which items are low on stock, and how many do we have left?"; "Take 3 blue mugs out of stock for order 1042."; "Show the folders in our warehouse and how many items each holds.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Simple Inventory data. Free plan: 50 tool calls per month. Run simpleinventory_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run simpleinventory_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run simpleinventory_upgrade without a plan: it returns both plans, each with a payment link for the user to open. simpleinventory_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.