Connecting

The MCP server runs at a single endpoint and authenticates with your easycart API token. Connect it once in your AI client, then talk to the assistant in natural language.

• Endpoint: https://mcp.easy.tools
• Transport: Streamable HTTP
• Authentication: Authorization: Bearer YOUR_API_TOKEN

Get your API token

The server uses your easycart API token — the same token used for the REST API. Generate one at cart.easy.tools/creator/store-settings/developer, then copy and store it securely.

The token belongs to your user account, not to a single store. If you are a team member who was granted API access to other stores, the assistant can reach all of those stores too — see Working across stores.

For more on tokens and access, see the easycart Authorization guide.

Connect your client

Claude Code

Add the server with claude mcp add:

claude mcp add --transport http easytools https://mcp.easy.tools \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Claude Desktop

Claude Desktop connects through the mcp-remote bridge. Open Settings → Developer → Edit Config and add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "easytools": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.easy.tools",
        "--header",
        "Authorization: Bearer ${TOKEN}"
      ],
      "env": {
        "TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Restart Claude Desktop after saving.

Other MCP clients

Any client that supports a remote MCP server over Streamable HTTP can connect with these details:

Setting	Value
URL	https://mcp.easy.tools
Transport	Streamable HTTP
Header	Authorization: Bearer YOUR_API_TOKEN

If your client supports only local (stdio) servers, use the mcp-remote bridge shown for Claude Desktop above.

Working across stores

Your API token can reach more than one store: your own store, plus any store whose team granted you API access. Ask the assistant which stores you can manage —

"Which stores can I manage?"

— and it will list them. By default it acts on your default store; name a specific store and it will switch to that one for the actions that follow.

This mirrors store selection in the REST API. For the underlying rules — how access is granted and what happens when it is revoked — see Store selection.

Rate limits

Requests are made against the easycart API, so the same per-store rate limit applies: 100 requests per 60 seconds. The assistant may make several requests to answer a single question. See Rate limiting for details.