@usecart/mcp-server

MCP (Model Context Protocol) server for the Cart e-commerce intelligence API. This server exposes Cart's full API as tools that AI agents can call directly.

Available Tools

| Tool | Description | |------|-------------| | search_stores | Search for e-commerce stores by keyword, platform, language, traffic | | get_store | Get full store details by domain | | get_store_products | List products for a store | | get_store_traffic | Get traffic analytics for a store | | get_store_tech | Get the technology stack for a store | | get_store_ads | Get ads detected for a store | | compare_stores | Compare 2-10 stores side by side | | search_products | Search for products across all tracked stores | | get_product | Get a single product by ID | | get_trending | Get trending products and growing stores | | search_ads | Search for e-commerce advertisements | | get_ad | Get a single ad by ID | | search_suppliers | Search for product suppliers and vendors | | get_niche_overview | Get a market overview for a niche keyword | | get_account | Get API key info and usage stats |

Prerequisites

• Node.js 18 or later
• A Cart API key (get one at usecart.com)

Setup

Claude Desktop

Add this to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cart": {
      "command": "npx",
      "args": ["@usecart/mcp-server"],
      "env": {
        "CART_API_KEY": "cart_sk_..."
      }
    }
  }
}

VS Code

Add this to your VS Code MCP settings (.vscode/mcp.json or user settings):

{
  "mcpServers": {
    "cart": {
      "command": "npx",
      "args": ["@usecart/mcp-server"],
      "env": {
        "CART_API_KEY": "cart_sk_..."
      }
    }
  }
}

Claude Code

claude mcp add cart -- npx @usecart/mcp-server

Set the environment variable before running:

export CART_API_KEY=cart_sk_...

Other MCP Clients

Any MCP-compatible client can use this server. The configuration is always:

• Command: npx
• Args: ["@usecart/mcp-server"]
• Environment: CART_API_KEY must be set

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CART_API_KEY | Yes | Your Cart API key (starts with cart_sk_) | | CART_API_BASE_URL | No | Override the API base URL (defaults to https://api.usecart.com/v1) |

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
CART_API_KEY=cart_sk_... node dist/index.js

License

MIT