Zenventory MCP by usefulapi
Look up items, stock, orders and transfers; create items and orders in Zenventory.
使うべきか
品質と安全性
検出事項(6)
- LOWzenventory_list_customer_orders 内
- LOWzenventory_list_purchase_orders 内
- LOWzenventory_list_transfer_orders 内
- LOWzenventory_create_customer_order 内
- LOWzenventory_cancel_customer_order 内
- LOWzenventory_create_purchase_order 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"zenventory": {
"url": "https://zenventory.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://zenventory.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(14)
🟢zenventory_list_items(searchFor, clientId, clientName, category, active, ...)
Lists inventory items (products) with optional search and filters. Read-only. Zenventory API: GET /items.
入力スキーマ
{
"type": "object",
"properties": {
"searchFor": {
"description": "Matches item SKU, UPC or description (exact or partial).",
"type": "string"
},
"clientId": {
"description": "Only items of this client id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"clientName": {
"description": "Only items of the client with this name.",
"type": "string"
},
"category": {
"description": "Only items in this category.",
"type": "string"
},
"active": {
"description": "true = active items only, false = inactive items only.",
"type": "boolean"
},
"orderBy": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"id",
"sku",
"upc",
"category",
"unitCost",
"price"
]
},
"orderDir": {
"description": "Sort direction. Used only when orderBy is set (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_get_item(id, includeUnits, includeBom)
Gets one inventory item by id, optionally with its units and bill of materials. Read-only. Zenventory API: GET /items/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric Zenventory id."
},
"includeUnits": {
"description": "Include the item's units of measure.",
"type": "boolean"
},
"includeBom": {
"description": "Include the bill of materials for kits and assemblies.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_list_inventory(searchFor, warehouseId, warehouseName, category, inStock, ...)
Lists stock levels per item and warehouse, with optional filters for stock and low stock. Read-only. Zenventory API: GET /inventory.
入力スキーマ
{
"type": "object",
"properties": {
"searchFor": {
"description": "Matches item SKU, UPC or description.",
"type": "string"
},
"warehouseId": {
"description": "Only stock in this warehouse id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"warehouseName": {
"description": "Only stock in the warehouse with this name.",
"type": "string"
},
"category": {
"description": "Only items in this category.",
"type": "string"
},
"inStock": {
"description": "true = items with stock on hand.",
"type": "boolean"
},
"lowStock": {
"description": "true = items at or below their reorder level.",
"type": "boolean"
},
"orderBy": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"id",
"sku",
"upc",
"category",
"inStock",
"allocated"
]
},
"orderDir": {
"description": "Sort direction. Used only when orderBy is set (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_list_customer_orders(open, completed, draft, cancelled, page, ...)
Lists customer orders, optionally only open, completed, draft or cancelled ones. Read-only. Zenventory API: GET /customer-orders.
入力スキーマ
{
"type": "object",
"properties": {
"open": {
"description": "true = open orders only.",
"type": "boolean"
},
"completed": {
"description": "true = completed orders only.",
"type": "boolean"
},
"draft": {
"description": "true = draft orders only.",
"type": "boolean"
},
"cancelled": {
"description": "true = cancelled orders only.",
"type": "boolean"
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_get_customer_order(id, includePickedItemMetadata)
Gets one customer order by id, with its items and addresses. Read-only. Zenventory API: GET /customer-orders/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric Zenventory id."
},
"includePickedItemMetadata": {
"description": "Include picking details for each item.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_list_purchase_orders(orderNumber, supplierId, supplierName, open, completed, ...)
Lists purchase orders to suppliers, optionally filtered by supplier, order number or status. Read-only. Zenventory API: GET /purchase-orders.
入力スキーマ
{
"type": "object",
"properties": {
"orderNumber": {
"description": "Purchase order number.",
"type": "string"
},
"supplierId": {
"description": "Only orders for this supplier id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"supplierName": {
"description": "Only orders for the supplier with this name.",
"type": "string"
},
"open": {
"description": "true = open orders only.",
"type": "boolean"
},
"completed": {
"description": "true = completed orders only.",
"type": "boolean"
},
"draft": {
"description": "true = draft orders only.",
"type": "boolean"
},
"orderBy": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"id",
"orderNumber",
"createdDate",
"preparedDate",
"requiredByDate"
]
},
"orderDir": {
"description": "Sort direction. Used only when orderBy is set (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_get_purchase_order(id)
Gets one purchase order by id, with its items. Read-only. Zenventory API: GET /purchase-orders/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric Zenventory id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_list_transfer_orders(open, completed, draft, cancelled, originWarehouseId, ...)
Lists stock transfer orders between warehouses, optionally filtered by warehouse or status. Read-only. Zenventory API: GET /transfer-orders.
入力スキーマ
{
"type": "object",
"properties": {
"open": {
"description": "true = open transfers only.",
"type": "boolean"
},
"completed": {
"description": "true = completed transfers only.",
"type": "boolean"
},
"draft": {
"description": "true = draft transfers only.",
"type": "boolean"
},
"cancelled": {
"description": "true = cancelled transfers only.",
"type": "boolean"
},
"originWarehouseId": {
"description": "Only transfers from this warehouse id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"destinationWarehouseId": {
"description": "Only transfers to this warehouse id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"id",
"originWarehouse",
"destinationWarehouse",
"createdDate",
"requiredByDate"
]
},
"orderDir": {
"description": "Sort direction. Used only when orderBy is set (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_get_transfer_order(id)
Gets one transfer order by id, with its items. Read-only. Zenventory API: GET /transfer-orders/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric Zenventory id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢zenventory_list_cycle_counts(type, inProgress, completed, approved, warehouseId, ...)
Lists stock counts (cycle counts), optionally filtered by type, warehouse or status. Read-only. Zenventory API: GET /cycle-counts.
入力スキーマ
{
"type": "object",
"properties": {
"type": {
"description": "Count type.",
"type": "string",
"enum": [
"normal",
"adjustment"
]
},
"inProgress": {
"description": "true = counts still in progress.",
"type": "boolean"
},
"completed": {
"description": "true = completed counts only.",
"type": "boolean"
},
"approved": {
"description": "true = approved counts only.",
"type": "boolean"
},
"warehouseId": {
"description": "Only counts in this warehouse id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"id",
"createdDate"
]
},
"page": {
"description": "Page number of the results (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"perPage": {
"description": "Records per page, 20 to 100 (default 20).",
"type": "integer",
"minimum": 20,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zenventory_create_item(sku, description, upc, category, baseUom, ...)
CREATES a new inventory item (a new SKU) in the company's Zenventory account. It stays in the account until someone edits or deletes it in Zenventory. Zenventory API: POST /items.
入力スキーマ
{
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"description": "New item SKU. Must be unique in the account."
},
"description": {
"description": "Item description.",
"type": "string"
},
"upc": {
"description": "UPC or barcode.",
"type": "string"
},
"category": {
"description": "Item category.",
"type": "string"
},
"baseUom": {
"description": "Base unit of measure, for example each.",
"type": "string"
},
"unitCost": {
"description": "Unit cost.",
"type": "number"
},
"price": {
"description": "Selling price.",
"type": "number"
},
"rrp": {
"description": "Recommended retail price.",
"type": "number"
},
"active": {
"description": "Whether the item is active (default set by Zenventory).",
"type": "boolean"
},
"perishable": {
"type": "boolean"
},
"trackLot": {
"description": "Track lot numbers.",
"type": "boolean"
},
"serialized": {
"description": "Track serial numbers.",
"type": "boolean"
},
"nonInventory": {
"description": "Non-inventory item, not stocked.",
"type": "boolean"
},
"warehouseId": {
"description": "Warehouse id to assign the item to.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"reorderLevel": {
"description": "Stock level that triggers a reorder.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notes": {
"type": "string"
}
},
"required": [
"sku"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zenventory_create_customer_order(customer, shippingAddress, billingAddress, items, orderNumber, ...)
CREATES a customer order. It is saved as a DRAFT unless saveAsDraft is false; a non-draft order can trigger fulfilment and customer notices, so set saveAsDraft false only on purpose. Zenventory API: POST /customer-orders.
入力スキーマ
{
"type": "object",
"properties": {
"customer": {
"type": "object",
"properties": {
"id": {
"description": "Existing customer id. Leave out to create a new customer.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"company": {
"type": "string"
},
"email": {
"type": "string"
},
"accountNumber": {
"type": "string"
}
},
"description": "Customer the order is for."
},
"shippingAddress": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"company": {
"type": "string"
},
"line1": {
"type": "string"
},
"line2": {
"type": "string"
},
"line3": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
},
"countryCode": {
"description": "Country code, for example US.",
"type": "string"
},
"phone": {
"type": "string"
}
},
"description": "Postal address."
},
"billingAddress": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"company": {
"type": "string"
},
"line1": {
"type": "string"
},
"line2": {
"type": "string"
},
"line3": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
},
"countryCode": {
"description": "Country code, for example US.",
"type": "string"
},
"phone": {
"type": "string"
}
},
"description": "Postal address."
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Item id."
},
"sku": {
"type": "string",
"description": "Item SKU."
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Quantity to order."
},
"uom": {
"description": "Unit of measure.",
"type": "string"
},
"price": {
"description": "Unit price.",
"type": "number"
},
"discountPercentage": {
"description": "Line discount, in percent.",
"type": "number"
}
},
"required": [
"itemId",
"sku",
"quantity"
]
},
"description": "Order lines."
},
"orderNumber": {
"description": "Your own order number.",
"type": "string"
},
"clientName": {
"description": "Client (customer account) name, when the account has several.",
"type": "string"
},
"shipFromWarehouseId": {
"description": "Warehouse id to ship from.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"shipVia": {
"description": "Carrier or shipping method.",
"type": "string"
},
"orderReference": {
"description": "Customer reference.",
"type": "string"
},
"noteToCustomer": {
"description": "Note shown to the customer.",
"type": "string"
},
"internalNote": {
"description": "Internal note, not shown to the customer.",
"type": "string"
},
"notificationEmail": {
"description": "Email address for order notices.",
"type": "string"
},
"saveAsDraft": {
"description": "true = save as a draft (default true).",
"type": "boolean"
}
},
"required": [
"customer",
"shippingAddress",
"billingAddress",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zenventory_cancel_customer_order(id, cancelReason)
CANCELS a customer order. This changes the order's status in Zenventory and cannot be undone from this tool. Zenventory API: PUT /customer-orders/{id}/cancel.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric Zenventory id."
},
"cancelReason": {
"description": "Reason recorded with the cancellation.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴zenventory_create_purchase_order(supplierId, supplierName, warehouseId, warehouseName, orderNumber, ...)
CREATES a purchase order to a supplier. It is saved as a DRAFT unless draft is false; a sent order commits the company to the supplier, so set draft false only on purpose. Zenventory API: POST /purchase-orders.
入力スキーマ
{
"type": "object",
"properties": {
"supplierId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Supplier id."
},
"supplierName": {
"type": "string",
"minLength": 1,
"description": "Supplier name, as it appears in Zenventory."
},
"warehouseId": {
"description": "Warehouse id that receives the goods.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"warehouseName": {
"description": "Warehouse name that receives the goods.",
"type": "string"
},
"orderNumber": {
"description": "Your own purchase order number.",
"type": "string"
},
"requiredByDate": {
"description": "Date the goods are needed, as the Zenventory API accepts it.",
"type": "string"
},
"notes": {
"type": "string"
},
"items": {
"description": "Order lines. Leave out to create an order without lines.",
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Item id."
},
"sku": {
"type": "string",
"description": "Item SKU."
},
"description": {
"type": "string",
"description": "Item description."
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Quantity to order."
},
"uom": {
"description": "Unit of measure.",
"type": "string"
},
"unitCost": {
"description": "Unit cost from the supplier.",
"type": "number"
}
},
"required": [
"itemId",
"sku",
"description",
"quantity"
]
}
},
"draft": {
"description": "true = save as a draft (default true).",
"type": "boolean"
}
},
"required": [
"supplierId",
"supplierName"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス