Simple Inventory MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
85%
Qualität der Benennung
73%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (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

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,723Tokens (Tool-Definitionen)
~2.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.13% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

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

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (11)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

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

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

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

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

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

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

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

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

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

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

Eingabe-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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet11 Tools