# Apilo MCP by usefulapi

> Apilo MCP by usefulapi is a freemium MCP server for e-commerce. Hosted MCP server for reading Apilo orders and stock and updating statuses and notes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/apilo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/apilo
- **MCP Registry name:** io.usefulapi/apilo
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

Order desks that run on Apilo can hand routine lookups to an AI assistant through this hosted connector. It reads orders from a date range with filters for status, payment type and sales channel, opens a single order with its items and delivery address, and follows shipments through to carrier tracking.

Three tools change data: one moves an order to a new status, one adds an internal note that the customer does not see, and one sets a product's stock quantity. Apilo may push a new quantity on to connected marketplaces, so the stock tool is the one to confirm before it runs. Finance staff can also list invoices, receipts and corrections by type and invoice date.

Sign-in is OAuth. The login page asks for your Apilo address, a Client ID, a Client Secret and a single-use authorization code created under Administracja, Klucze API Apilo. The connection lasts 21 days, matching Apilo's access token lifetime, and then needs a fresh code.

## Features

- **Order review:** Lists orders by date, status, payment type or sales channel and opens one with items and delivery address.
- **Shipment tracing:** Reads an order's shipments and the carrier tracking status of each.
- **Warehouse lookup:** Searches products by SKU, EAN or name and reads stock quantity and shelf or bin.
- **Status and notes:** Changes one order's status and adds an internal note the customer cannot see.
- **Stock updates:** Sets a product's stock quantity, which Apilo may forward to connected marketplaces.
- **Accounting documents:** Lists invoices, receipts and corrections with numbers, amounts and currency.

## Good for

- List today's unpaid orders
- Look up shipments and tracking for one order
- Find products with stock below a threshold
- Add an internal note explaining a status change
- Check invoices and corrections for a date range

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `apilo_whoami`: The Apilo API key (application) this connection uses: client id, name and the date it is valid to. GET /rest/api/whoami/.
- `apilo_get_map`: Apilo's id lookup tables, each a list of { id, key, name, description }: `status` (order statuses, for apilo_list_orders and apilo_update_order_status), `payment` (payment types), `carrier`, `carrier_account`, `platform` (sales channels and their accounts), `tag`, `document` (document types), `shipment_status`. GET /rest/api/orders/<table>/map/.
- `apilo_list_orders`: List or search orders (all connected marketplaces and shops), with items, customer address and totals. Filter by date, status, payment, sales channel, carrier, email or phone. Status, payment, carrier and platform ids come from apilo_get_map. Page with limit/offset (reply has totalCount and next_offset). GET /rest/api/orders/.
- `apilo_get_order`: One order in full: status, payment, items (SKU, EAN, price, quantity), customer/delivery/invoice addresses, payments, notes, discounts, carrier and sales channel. GET /rest/api/orders/{id}/.
- `apilo_list_order_notes`: The notes of an order (internal notes and customer messages), with type 1 = customer message, 2 = internal note. GET /rest/api/orders/{id}/note/.
- `apilo_list_order_documents`: The documents attached to an order (invoices, receipts, labels). GET /rest/api/orders/{id}/documents/.
- `apilo_list_order_shipments`: The shipments created for an order (Apilo id and carrier's id). GET /rest/api/orders/{id}/shipment/.
- `apilo_get_shipment`: One shipment of an order with its details. GET /rest/api/orders/{id}/shipment/{shipment}/.
- `apilo_list_shipment_tracking`: Tracking status of shipments (status, status date and description, received date and days in transit), filtered by carrier account, post date, received date or status. Page with limit/offset (reply has totalCount and next_offset). GET /rest/api/shipping/shipment/tracking/.
- `apilo_list_products`: List warehouse products with SKU, EAN, name, stock quantity, prices, tax and location. Filter by id, SKU, name, EAN or status. GET /rest/api/warehouse/product/.
- `apilo_get_product`: One warehouse product by Apilo id. GET /rest/api/warehouse/product/{id}/.
- `apilo_list_categories`: Product categories with id, name and parent ids. GET /rest/api/warehouse/category/.
- `apilo_list_locations`: Warehouse locations (shelves, bins) with id, name and code. GET /rest/api/warehouse/location/.
- `apilo_list_finance_documents`: Accounting documents (invoices, receipts, corrections) with number, amounts, currency and dates. Filter by type and invoice date. GET /rest/api/finance/documents/.
- `apilo_update_order_status`: WRITE: set an order's status (id from apilo_get_map status). Apilo may run its own automations on a status change (emails, marketplace updates, shipping). Setting the current status changes nothing. PUT /rest/api/orders/{id}/status/.
- `apilo_add_order_note`: WRITE: add an INTERNAL note to an order (never a message to the customer). Not idempotent: calling twice adds two notes. POST /rest/api/orders/{id}/note/.
- `apilo_set_product_stock`: WRITE: set the stock quantity of one warehouse product to an absolute number (it replaces the current quantity, so read it with apilo_get_product first if unsure). Apilo may push the new quantity to connected marketplaces. PATCH /rest/api/warehouse/product/.

## FAQ

### How long does the Apilo connection last?

Twenty-one days, the lifetime of Apilo's access token. After that you connect again with a new single-use authorization code, which is valid for 3 hours.

### Does the customer see notes added through the connector?

No. The note is internal to Apilo; the customer does not see it.

### Is there a free tier?

Yes, 50 tool calls a month. Paid plans raise that to 10,000 or 100,000 calls and are per user.

### Can I use it with ChatGPT or Cursor?

Yes. The hosted endpoint works with Claude, ChatGPT, Cursor, VS Code, Codex and other clients that accept a remote Streamable HTTP server.

### Is Apilo MCP by usefulapi free?

Apilo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Apilo MCP by usefulapi?

The closest alternatives to Apilo MCP by usefulapi are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

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