Simple Inventory MCP by usefulapi

Read items, stock, folders and events; change stock, items and event webhooks in Simple Inventory.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
85%
Naming quality
73%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • LOWTool 'simpleinventory_list_recent_events' name length outside 3-30 rangein simpleinventory_list_recent_events
  • LOWTool 'simpleinventory_bulk_update_stock' name length outside 3-30 rangein simpleinventory_bulk_update_stock
  • LOWTool 'simpleinventory_subscribe_webhook' name length outside 3-30 rangein simpleinventory_subscribe_webhook
  • LOWTool 'simpleinventory_unsubscribe_webhook' name length outside 3-30 rangein simpleinventory_unsubscribe_webhook

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,723Tokens (tool definitions)
~2.0 KBTypical response size
Significant attention impact (2.13% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "simple-inventory": {
      "url": "https://simple-inventory.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://simple-inventory.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢simpleinventory_get_account

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢simpleinventory_list_folders

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢simpleinventory_list_items(limit, offset, after, include, sku, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Items to return, 1-500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Items to skip (default 0). Ignored when after is set.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "after": {
      "description": "Return items with an ID greater than this, lowest first. Start with 0. Use instead of offset to read all items.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "include": {
      "description": "\"leaves\" (default): standalone items and variations. \"groups\": items and variant groups. \"all\": both.",
      "type": "string",
      "enum": [
        "leaves",
        "groups",
        "all"
      ]
    },
    "sku": {
      "description": "Return only the item with this SKU (only with offset 0).",
      "type": "string",
      "maxLength": 100
    },
    "search": {
      "description": "Items whose name or SKU contains this text (not case-sensitive).",
      "type": "string",
      "maxLength": 255
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢simpleinventory_get_item(identifier, by)

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}.

Input Schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
    },
    "by": {
      "description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers.",
      "type": "string",
      "enum": [
        "auto",
        "id",
        "sku"
      ]
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢simpleinventory_list_recent_events(type, limit)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "inventory.updated",
        "inventory.low_stock",
        "inventory.out_of_stock",
        "item.created",
        "item.updated",
        "item.archived"
      ],
      "description": "The event type, such as inventory.updated."
    },
    "limit": {
      "description": "Events to return, 1-25 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴simpleinventory_create_item(name, sku, quantity, unitCost, salePrice, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Item name (1-255 characters)."
    },
    "sku": {
      "description": "SKU (up to 100 characters). Must not match another item's SKU.",
      "type": "string",
      "maxLength": 100
    },
    "quantity": {
      "description": "Opening stock (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000
    },
    "unitCost": {
      "description": "What one unit costs (default 0).",
      "type": "number",
      "minimum": 0,
      "maximum": 99999999.99
    },
    "salePrice": {
      "description": "What one unit sells for.",
      "type": "number",
      "minimum": 0,
      "maximum": 99999999.99
    },
    "lowStockThreshold": {
      "description": "Stock level that counts as low.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000
    },
    "description": {
      "description": "Free-text description.",
      "type": "string",
      "maxLength": 10000
    },
    "barcode": {
      "description": "Barcode value.",
      "type": "string",
      "maxLength": 255
    },
    "folderId": {
      "description": "Folder ID (from simpleinventory_list_folders).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡simpleinventory_update_item(identifier, by, name, sku, unitCost, ...)

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}.

Input Schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
    },
    "by": {
      "description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers.",
      "type": "string",
      "enum": [
        "auto",
        "id",
        "sku"
      ]
    },
    "name": {
      "description": "New name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "sku": {
      "description": "New SKU, or null to clear it.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "unitCost": {
      "description": "New unit cost (null sets it to 0).",
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "maximum": 99999999.99
        },
        {
          "type": "null"
        }
      ]
    },
    "salePrice": {
      "description": "New sale price, or null to clear it.",
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "maximum": 99999999.99
        },
        {
          "type": "null"
        }
      ]
    },
    "lowStockThreshold": {
      "description": "New low stock level, or null to clear it.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 1000000000
        },
        {
          "type": "null"
        }
      ]
    },
    "description": {
      "description": "New description, or null to clear it.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "barcode": {
      "description": "New barcode, or null to clear it.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 255
        },
        {
          "type": "null"
        }
      ]
    },
    "folderId": {
      "description": "Move to this folder, or null to unfile it.",
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴simpleinventory_change_stock(identifier, by, quantity, operation, reason, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The item's numeric ID or its SKU (from simpleinventory_list_items). Archived items are found too."
    },
    "by": {
      "description": "How to read identifier: \"auto\" (default), \"id\", or \"sku\". Use \"sku\" when SKUs are numbers.",
      "type": "string",
      "enum": [
        "auto",
        "id",
        "sku"
      ]
    },
    "quantity": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "The amount, 0 to 1,000,000,000. Stock cannot exceed 2,147,483,647."
    },
    "operation": {
      "description": "\"set\" (default), \"increment\" or \"decrement\".",
      "type": "string",
      "enum": [
        "set",
        "increment",
        "decrement"
      ]
    },
    "reason": {
      "description": "Note saved on the item's history entry.",
      "type": "string",
      "maxLength": 500
    },
    "idempotencyKey": {
      "description": "Optional key so a retry cannot apply the same change twice (up to 255 characters). Use one new key per change.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    }
  },
  "required": [
    "identifier",
    "quantity"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴simpleinventory_bulk_update_stock(items, idempotencyKey)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Item ID. Give id or sku.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "sku": {
            "description": "Item SKU. Give id or sku.",
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "quantity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "The amount, 0 to 1,000,000,000."
          },
          "operation": {
            "description": "\"set\" (default), \"increment\" or \"decrement\".",
            "type": "string",
            "enum": [
              "set",
              "increment",
              "decrement"
            ]
          },
          "reason": {
            "description": "Note saved on the item's history entry.",
            "type": "string",
            "maxLength": 500
          }
        },
        "required": [
          "quantity"
        ]
      },
      "description": "The stock changes, applied in order."
    },
    "idempotencyKey": {
      "description": "Optional key for the whole request. Change i is recorded as <key>:<i>, so resend the same list in the same order.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡simpleinventory_subscribe_webhook(targetUrl, event)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "targetUrl": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "The HTTPS URL that receives the events."
    },
    "event": {
      "type": "string",
      "enum": [
        "inventory.updated",
        "inventory.low_stock",
        "inventory.out_of_stock",
        "item.created",
        "item.updated",
        "item.archived"
      ],
      "description": "The one event type to deliver."
    }
  },
  "required": [
    "targetUrl",
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴simpleinventory_unsubscribe_webhook(id)

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}.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The subscription ID returned by simpleinventory_subscribe_webhook."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools