Simple Inventory MCP by usefulapi
Read items, stock, folders and events; change stock, items and event webhooks in Simple Inventory.
사용해야 할까요
품질 및 안전성
발견 사항 (4)
- LOWsimpleinventory_list_recent_events에서
- LOWsimpleinventory_bulk_update_stock에서
- LOWsimpleinventory_subscribe_webhook에서
- LOWsimpleinventory_unsubscribe_webhook에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"simple-inventory": {
"url": "https://simple-inventory.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://simple-inventory.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟢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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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"
}커뮤니티
증거