# IdoSell MCP by usefulapi

> IdoSell MCP by usefulapi is an MCP server. Search orders, products, stock, customers and returns; set order status in IdoSell. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Search orders, products, stock, customers and returns; set order status in IdoSell.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `idosell_get_shop_config`: Get the panel configuration: owner company data, languages, base currency, warehouses (stocks) and shops with their ids. Good first call to learn shop ids and warehouse ids. API: GET /system/config.
- `idosell_search_orders`: Search orders by status, date range, customer, order ids or serial numbers. Returns order details with products, payments, dispatch data and the customer. Read-only (a POST search). API: POST /orders/orders/search.
- `idosell_get_orders`: Get orders by order ids or serial numbers (give at least one). Use idosell_search_orders for filters. API: GET /orders/orders.
- `idosell_list_order_statuses`: List the order statuses configured in the panel, with their ids and names. API: GET /orders/statuses.
- `idosell_get_order_packages`: Get the parcels (shipments) of orders: courier, tracking numbers and status. API: GET /orders/packages.
- `idosell_search_products`: Search products by text, code, availability, visibility or promotion. Returns prices, stock summary, images and categories. Read-only (a POST search). API: POST /products/products/search.
- `idosell_get_product_stocks`: Get stock quantities per warehouse and size for products. API: GET /products/stocks.
- `idosell_list_categories`: List the product categories of the shop with ids and names. API: GET /products/categories.
- `idosell_list_brands`: List the brands (producers) of the shop with ids and names. API: GET /products/brands.
- `idosell_search_customers`: Find customer accounts by text (name, e-mail, login), ids or active state. Returns contact data, addresses, balances and consents. API: GET /clients/clients.
- `idosell_list_returns`: List returns issued for orders, filterable by order serial number, return id or status id. API: GET /returns/returns.
- `idosell_list_couriers`: List the couriers available for a country, and whether each one handles pickup points. API: GET /couriers/couriers.
- `idosell_set_order_status`: WRITE: change the status of one order (for example to packed, ready or canceled). Setting the same status again has no further effect. The panel may send customer e-mails for some status changes. API: PUT /orders/orders.

## FAQ

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

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

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