# keyCRM MCP by usefulapi

> keyCRM MCP by usefulapi is an MCP server. Read orders, buyers, products and pipeline cards; add or remove order tags in keyCRM. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read orders, buyers, products and pipeline cards; add or remove order tags in keyCRM.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `keycrm_list_orders`: List orders with filters. For unfulfilled orders, first call keycrm_list_order_statuses, then pass the status id here. Use include=buyer,products.offer,status to get the customer and products in one call. One page per call; keyCRM allows 20 requests per minute per key. GET /order.
- `keycrm_get_order`: Get one order by id, with its products, buyer, status, payments and shipping when included. GET /order/{id}.
- `keycrm_list_order_statuses`: List the active order statuses with their ids and names. Call this first to find the status id for unfulfilled or new orders. GET /order/status.
- `keycrm_list_order_sources`: List order sources (sales channels) with their ids. GET /order/source.
- `keycrm_list_order_tags`: List order tags with their ids, for keycrm_add_order_tag and keycrm_remove_order_tag. GET /order/tag.
- `keycrm_list_buyers`: List buyers (customers) with filters by id, phone, email or date. Use include=company,manager,loyalty for related data. GET /buyer.
- `keycrm_get_buyer`: Get one buyer (customer) by id. GET /buyer/{id}.
- `keycrm_list_products`: List catalog products with filters by id, category or archive status. Use include=custom_fields for custom fields. GET /products.
- `keycrm_get_product`: Get one catalog product by id. GET /products/{id}.
- `keycrm_list_offers`: List product variants (offers) with their ids and SKUs. GET /offers.
- `keycrm_list_stock_levels`: List stock levels per product variant. Set details=true to get the stock per warehouse. GET /offers/stocks.
- `keycrm_list_pipeline_cards`: List sales pipeline cards (deals) with filters by pipeline, status, source or date. GET /pipelines/cards.
- `keycrm_list_users`: List team users (managers) with their ids, roles and status. Match a user id to the manager of an order from keycrm_list_orders with include=manager. GET /users.
- `keycrm_add_order_tag`: WRITE: add an existing tag to an order. Changes the order in the customer's keyCRM account. Get tag ids from keycrm_list_order_tags. POST /order/{id}/tag/{tag_id}.
- `keycrm_remove_order_tag`: WRITE: remove a tag from an order in the customer's keyCRM account. The tag itself is kept. DELETE /order/{id}/tag/{tag_id}.

## FAQ

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

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

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