ConsignCloud MCP by usefulapi
Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.
我该使用它吗
质量与安全性
发现(1)
- LOW在 consigncloud_list_item_categories 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"consigncloud": {
"url": "https://consigncloud.usefulapi.io/mcp"
}
}
}远程端点
https://consigncloud.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具(13)
🟢consigncloud_get_store
Get the store the API key belongs to: name, currency, default split and terms, and billing details. Good first call to confirm which store is connected. ConsignCloud API: GET /store.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_list_items(search, status, account, location, limit, ...)
List inventory items with status, tag price, quantity, consignor account and location. Filter by status, account or location, or search text. Deleted items are hidden. ConsignCloud API: GET /items.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Narrow items by a text query.",
"type": "string"
},
"status": {
"description": "Only items with one of these statuses, e.g. 'active', 'sold', 'expired'.",
"type": "array",
"items": {
"type": "string",
"enum": [
"sold",
"active",
"expired",
"pending_on_shopify",
"sold_on_shopify",
"sold_on_square",
"sold_on_third_party",
"to_be_returned",
"returned_to_owner",
"donated",
"lost",
"stolen",
"damaged",
"parked",
"on_layaway",
"inactive"
]
}
},
"account": {
"description": "Only items supplied by these account ids.",
"type": "array",
"items": {
"type": "string"
}
},
"location": {
"description": "Only items at these location ids.",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Items per page, 1-100 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "next_cursor from the previous page. Repeat the same filters with it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_get_item(item_id)
Get one inventory item by id: price, cost, quantity, status, account, location and history. ConsignCloud API: GET /items/{id}.
输入模式
{
"type": "object",
"properties": {
"item_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The item id (a UUID from a list tool)."
}
},
"required": [
"item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴consigncloud_create_item(quantity, title, description, account, category, ...)
Create one inventory item. Prices and cost are integers in the smallest currency unit (cents for USD: 1250 = 12.50). Account is required for consignment and buy-outright items. Creates a new record each call; it does not check for duplicates. ConsignCloud API: POST /items.
输入模式
{
"type": "object",
"properties": {
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Units in stock."
},
"title": {
"description": "Item title. If omitted, ConsignCloud builds it from the store template.",
"type": "string"
},
"description": {
"description": "Longer description. May contain markdown.",
"type": "string"
},
"account": {
"description": "Account id of the supplier (consignor or vendor).",
"type": "string"
},
"category": {
"description": "Item category id.",
"type": "string"
},
"location": {
"description": "Location id.",
"type": "string"
},
"tag_price": {
"description": "Tag price in cents (USD).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"split_price": {
"description": "Split price in cents (USD).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"cost_per": {
"description": "Cost per unit in cents (USD). Needed for buy-outright and retail items.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"split": {
"description": "Percent of the split price for the consignor. Consignment only.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"sku": {
"description": "SKU. Leave empty to let ConsignCloud generate one.",
"type": "string"
},
"brand": {
"type": "string"
},
"color": {
"type": "string"
},
"size": {
"type": "string"
}
},
"required": [
"quantity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_list_sales(search, sort_by, sort_order, limit, cursor)
List sales with totals, status, cashier, register and the consignor and store portions. Search by sale number. ConsignCloud API: GET /sales.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Narrow sales by sale number by a text query.",
"type": "string"
},
"sort_by": {
"description": "Field to sort by.",
"type": "string",
"enum": [
"number",
"status",
"created",
"customer",
"register",
"cashier",
"finalized",
"parked",
"voided",
"subtotal",
"total",
"change",
"consignor_portion",
"store_portion"
]
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"description": "Items per page, 1-100 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "next_cursor from the previous page. Repeat the same filters with it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_get_sale(sale_id)
Get one sale by id: line items, payments, taxes, discounts, totals and status. ConsignCloud API: GET /sales/{id}.
输入模式
{
"type": "object",
"properties": {
"sale_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The sale id (a UUID from a list tool)."
}
},
"required": [
"sale_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_get_sales_summary(start_date, end_date, channel)
Get sales totals for the store over a date range, bucketed for a histogram. Use it for trends by day or week. ConsignCloud API: GET /reports/sales-summary.
输入模式
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"minLength": 1,
"description": "Start of the range (ISO date, yyyy-mm-dd)."
},
"end_date": {
"type": "string",
"minLength": 1,
"description": "End of the range (ISO date, yyyy-mm-dd)."
},
"channel": {
"description": "Only sales from these channels. Omit for all channels.",
"type": "array",
"items": {
"type": "string",
"enum": [
"consign_cloud",
"shopify",
"square"
]
}
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_list_accounts(search, limit, cursor)
List consignor and vendor accounts with balance, item count, default split and contact details. Search by name, email or number. ConsignCloud API: GET /accounts.
输入模式
{
"type": "object",
"properties": {
"search": {
"description": "Narrow accounts by a text query.",
"type": "string"
},
"limit": {
"description": "Items per page, 1-100 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "next_cursor from the previous page. Repeat the same filters with it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_get_account(account_id)
Get one account by id: balance, default split, contact details, locations and custom fields. ConsignCloud API: GET /accounts/{id}.
输入模式
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The account id (a UUID from a list tool)."
}
},
"required": [
"account_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴consigncloud_add_item_note(item_id, body)
Add a markdown note to an inventory item. Adds a record; it does not change the item. ConsignCloud API: POST /items/{id}/notes.
输入模式
{
"type": "object",
"properties": {
"item_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The item id (a UUID from a list tool)."
},
"body": {
"type": "string",
"minLength": 1,
"description": "Note text. May contain markdown."
}
},
"required": [
"item_id",
"body"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_list_locations(limit, cursor)
List the store's locations (for example, shops or rooms). ConsignCloud API: GET /locations.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-100 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "next_cursor from the previous page. Repeat the same filters with it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_list_item_categories(limit, cursor)
List the store's item categories. Use the ids as the category field of consigncloud_create_item. ConsignCloud API: GET /item-categories.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-100 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "next_cursor from the previous page. Repeat the same filters with it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢consigncloud_search(query)
Search across the store's records (items, accounts, sales and more) with one text query. ConsignCloud API: GET /search.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Text to search for, for example a SKU, a name or a sale number."
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社区
证据