ConsignCloud MCP by usefulapi
Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWconsigncloud_list_item_categories에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거