ConsignCloud MCP by usefulapi is an MCP server published by io.usefulapi, hosted at consigncloud.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including consigncloud_get_store, consigncloud_list_items, consigncloud_get_item, consigncloud_create_item, consigncloud_list_sales.
Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.
3,968 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "consigncloud_get_store",
"title": "Get store",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get store",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| cursor | string | next_cursor from the previous page. Repeat the same filters with it. |
| search | string | Narrow items by a text query. |
| status | array | Only items with one of these statuses, e.g. 'active', 'sold', 'expired'. |
| account | array | Only items supplied by these account ids. |
| location | array | Only items at these location ids. |
{
"name": "consigncloud_list_items",
"title": "List items",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page. Repeat the same filters with it."
},
"search": {
"type": "string",
"description": "Narrow items by a text query."
},
"status": {
"type": "array",
"items": {
"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"
],
"type": "string"
},
"description": "Only items with one of these statuses, e.g. 'active', 'sold', 'expired'."
},
"account": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only items supplied by these account ids."
},
"location": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only items at these location ids."
}
}
},
"annotations": {
"title": "List items",
"readOnlyHint": true
}
}Get one inventory item by id: price, cost, quantity, status, account, location and history. ConsignCloud API: GET /items/{id}.
| Parameter | Type | Description |
|---|---|---|
| item_id * | string | The item id (a UUID from a list tool). |
{
"name": "consigncloud_get_item",
"title": "Get item",
"description": "Get one inventory item by id: price, cost, quantity, status, account, location and history. ConsignCloud API: GET /items/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"item_id"
],
"properties": {
"item_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The item id (a UUID from a list tool)."
}
}
},
"annotations": {
"title": "Get item",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sku | string | SKU. Leave empty to let ConsignCloud generate one. |
| size | string | |
| brand | string | |
| color | string | |
| split | number | Percent of the split price for the consignor. Consignment only. |
| title | string | Item title. If omitted, ConsignCloud builds it from the store template. |
| account | string | Account id of the supplier (consignor or vendor). |
| category | string | Item category id. |
| cost_per | integer | Cost per unit in cents (USD). Needed for buy-outright and retail items. |
| location | string | Location id. |
| quantity * | integer | Units in stock. |
| tag_price | integer | Tag price in cents (USD). |
| description | string | Longer description. May contain markdown. |
| split_price | integer | Split price in cents (USD). |
{
"name": "consigncloud_create_item",
"title": "Create item",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "SKU. Leave empty to let ConsignCloud generate one."
},
"size": {
"type": "string"
},
"brand": {
"type": "string"
},
"color": {
"type": "string"
},
"split": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Percent of the split price for the consignor. Consignment only."
},
"title": {
"type": "string",
"description": "Item title. If omitted, ConsignCloud builds it from the store template."
},
"account": {
"type": "string",
"description": "Account id of the supplier (consignor or vendor)."
},
"category": {
"type": "string",
"description": "Item category id."
},
"cost_per": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Cost per unit in cents (USD). Needed for buy-outright and retail items."
},
"location": {
"type": "string",
"description": "Location id."
},
"quantity": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Units in stock."
},
"tag_price": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tag price in cents (USD)."
},
"description": {
"type": "string",
"description": "Longer description. May contain markdown."
},
"split_price": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Split price in cents (USD)."
}
}
},
"annotations": {
"title": "Create item",
"destructiveHint": true
}
}List sales with totals, status, cashier, register and the consignor and store portions. Search by sale number. ConsignCloud API: GET /sales.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| cursor | string | next_cursor from the previous page. Repeat the same filters with it. |
| search | string | Narrow sales by sale number by a text query. |
| sort_by | string | Field to sort by. |
| sort_order | string | one of ["asc","desc"] |
{
"name": "consigncloud_list_sales",
"title": "List sales",
"description": "List sales with totals, status, cashier, register and the consignor and store portions. Search by sale number. ConsignCloud API: GET /sales.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page. Repeat the same filters with it."
},
"search": {
"type": "string",
"description": "Narrow sales by sale number by a text query."
},
"sort_by": {
"enum": [
"number",
"status",
"created",
"customer",
"register",
"cashier",
"finalized",
"parked",
"voided",
"subtotal",
"total",
"change",
"consignor_portion",
"store_portion"
],
"type": "string",
"description": "Field to sort by."
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
}
},
"annotations": {
"title": "List sales",
"readOnlyHint": true
}
}Get one sale by id: line items, payments, taxes, discounts, totals and status. ConsignCloud API: GET /sales/{id}.
| Parameter | Type | Description |
|---|---|---|
| sale_id * | string | The sale id (a UUID from a list tool). |
{
"name": "consigncloud_get_sale",
"title": "Get sale",
"description": "Get one sale by id: line items, payments, taxes, discounts, totals and status. ConsignCloud API: GET /sales/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sale_id"
],
"properties": {
"sale_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The sale id (a UUID from a list tool)."
}
}
},
"annotations": {
"title": "Get sale",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| channel | array | Only sales from these channels. Omit for all channels. |
| end_date * | string | End of the range (ISO date, yyyy-mm-dd). |
| start_date * | string | Start of the range (ISO date, yyyy-mm-dd). |
{
"name": "consigncloud_get_sales_summary",
"title": "Get sales summary",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"channel": {
"type": "array",
"items": {
"enum": [
"consign_cloud",
"shopify",
"square"
],
"type": "string"
},
"description": "Only sales from these channels. Omit for all channels."
},
"end_date": {
"type": "string",
"minLength": 1,
"description": "End of the range (ISO date, yyyy-mm-dd)."
},
"start_date": {
"type": "string",
"minLength": 1,
"description": "Start of the range (ISO date, yyyy-mm-dd)."
}
}
},
"annotations": {
"title": "Get sales summary",
"readOnlyHint": true
}
}List consignor and vendor accounts with balance, item count, default split and contact details. Search by name, email or number. ConsignCloud API: GET /accounts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| cursor | string | next_cursor from the previous page. Repeat the same filters with it. |
| search | string | Narrow accounts by a text query. |
{
"name": "consigncloud_list_accounts",
"title": "List accounts",
"description": "List consignor and vendor accounts with balance, item count, default split and contact details. Search by name, email or number. ConsignCloud API: GET /accounts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page. Repeat the same filters with it."
},
"search": {
"type": "string",
"description": "Narrow accounts by a text query."
}
}
},
"annotations": {
"title": "List accounts",
"readOnlyHint": true
}
}Get one account by id: balance, default split, contact details, locations and custom fields. ConsignCloud API: GET /accounts/{id}.
| Parameter | Type | Description |
|---|---|---|
| account_id * | string | The account id (a UUID from a list tool). |
{
"name": "consigncloud_get_account",
"title": "Get account",
"description": "Get one account by id: balance, default split, contact details, locations and custom fields. ConsignCloud API: GET /accounts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The account id (a UUID from a list tool)."
}
}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true
}
}Add a markdown note to an inventory item. Adds a record; it does not change the item. ConsignCloud API: POST /items/{id}/notes.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Note text. May contain markdown. |
| item_id * | string | The item id (a UUID from a list tool). |
{
"name": "consigncloud_add_item_note",
"title": "Add item note",
"description": "Add a markdown note to an inventory item. Adds a record; it does not change the item. ConsignCloud API: POST /items/{id}/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"item_id",
"body"
],
"properties": {
"body": {
"type": "string",
"minLength": 1,
"description": "Note text. May contain markdown."
},
"item_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The item id (a UUID from a list tool)."
}
}
},
"annotations": {
"title": "Add item note",
"destructiveHint": true
}
}List the store's locations (for example, shops or rooms). ConsignCloud API: GET /locations.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| cursor | string | next_cursor from the previous page. Repeat the same filters with it. |
{
"name": "consigncloud_list_locations",
"title": "List locations",
"description": "List the store's locations (for example, shops or rooms). ConsignCloud API: GET /locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page. Repeat the same filters with it."
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true
}
}List the store's item categories. Use the ids as the category field of consigncloud_create_item. ConsignCloud API: GET /item-categories.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| cursor | string | next_cursor from the previous page. Repeat the same filters with it. |
{
"name": "consigncloud_list_item_categories",
"title": "List item categories",
"description": "List the store's item categories. Use the ids as the category field of consigncloud_create_item. ConsignCloud API: GET /item-categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page. Repeat the same filters with it."
}
}
},
"annotations": {
"title": "List item categories",
"readOnlyHint": true
}
}Search across the store's records (items, accounts, sales and more) with one text query. ConsignCloud API: GET /search.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Text to search for, for example a SKU, a name or a sale number. |
{
"name": "consigncloud_search",
"title": "Search store",
"description": "Search across the store's records (items, accounts, sales and more) with one text query. ConsignCloud API: GET /search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Text to search for, for example a SKU, a name or a sale number."
}
}
},
"annotations": {
"title": "Search store",
"readOnlyHint": true
}
}Tools for ConsignCloud, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which items in our store are still active and priced above $100?"; "Show me the sales from last week and the consignor portion of each."; "Find the account for Jane Smith and tell me her current balance.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ConsignCloud data. Free plan: 50 tool calls per month. Run consigncloud_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run consigncloud_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run consigncloud_upgrade without a plan: it returns both plans, each with a payment link for the user to open. consigncloud_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.