# ConsignCloud MCP by usefulapi

> ConsignCloud MCP by usefulapi is an MCP server. Read items, sales, accounts and store totals; add items and item notes in ConsignCloud. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/consigncloud/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/consigncloud
- **MCP Registry name:** io.usefulapi/consigncloud
- **Listing updated:** 2026-11-13

## About

Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http consigncloud https://consigncloud.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://consigncloud.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "consigncloud": {
      "url": "https://consigncloud.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "consigncloud": {
      "type": "http",
      "url": "https://consigncloud.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "consigncloud": {
      "serverUrl": "https://consigncloud.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "consigncloud": {
      "type": "http",
      "url": "https://consigncloud.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.
- `consigncloud_list_items`: 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.
- `consigncloud_get_item`: Get one inventory item by id: price, cost, quantity, status, account, location and history. ConsignCloud API: GET /items/{id}.
- `consigncloud_create_item`: 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.
- `consigncloud_list_sales`: List sales with totals, status, cashier, register and the consignor and store portions. Search by sale number. ConsignCloud API: GET /sales.
- `consigncloud_get_sale`: Get one sale by id: line items, payments, taxes, discounts, totals and status. ConsignCloud API: GET /sales/{id}.
- `consigncloud_get_sales_summary`: 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.
- `consigncloud_list_accounts`: List consignor and vendor accounts with balance, item count, default split and contact details. Search by name, email or number. ConsignCloud API: GET /accounts.
- `consigncloud_get_account`: Get one account by id: balance, default split, contact details, locations and custom fields. ConsignCloud API: GET /accounts/{id}.
- `consigncloud_add_item_note`: Add a markdown note to an inventory item. Adds a record; it does not change the item. ConsignCloud API: POST /items/{id}/notes.
- `consigncloud_list_locations`: List the store's locations (for example, shops or rooms). ConsignCloud API: GET /locations.
- `consigncloud_list_item_categories`: List the store's item categories. Use the ids as the category field of consigncloud_create_item. ConsignCloud API: GET /item-categories.
- `consigncloud_search`: Search across the store's records (items, accounts, sales and more) with one text query. ConsignCloud API: GET /search.

## FAQ

### How do I add ConsignCloud MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http consigncloud https://consigncloud.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/consigncloud-mcp-by-usefulapi
