ConsignCloud MCP by usefulapi
Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen consigncloud_list_item_categories
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
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": {
"consigncloud": {
"url": "https://consigncloud.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://consigncloud.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia