Simple Inventory MCP by usefulapi

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

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
85%
Calidad de los nombres
73%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (4)

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

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,723Tokens (definiciones de herramientas)
~2.0 KBTamaño de respuesta típico
Impacto significativo en la atención (2.13% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

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

Puntos de conexión remotos

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

Qué puede hacer

Inventario de herramientas

Herramientas (11)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

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

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

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

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

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

Esquema de entrada

{
  "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"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada11 herramientas