English Français العربية

io.github.ByteBunny-io/nanocart-mcp

Official registry E-commerce

Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http nanocart-mcp 'https://mcp.nanocart.io/mcp' --header 'Authorization: <Bearer <your sc_live_ API key>>' --header 'X-Store-Id: <Your store ID (or append ?store=your-store-id to the URL)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "nanocart-mcp": {
            "type": "http",
            "url": "https://mcp.nanocart.io/mcp",
            "headers": {
                "Authorization": "<Bearer <your sc_live_ API key>>",
                "X-Store-Id": "<Your store ID (or append ?store=your-store-id to the URL)>"
            }
        }
    }
}
NPM package nanocart-mcp
Claude Code 
claude mcp add nanocart-mcp -e 'NANOCART_API_KEY=<your nanocart_api_key>' -e 'NANOCART_STORE_ID=<NANOCART_STORE_ID>' -- npx -y nanocart-mcp@1.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "nanocart-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "nanocart-mcp@1.2.0"
            ],
            "env": {
                "NANOCART_API_KEY": "<your nanocart_api_key>",
                "NANOCART_STORE_ID": "<NANOCART_STORE_ID>"
            }
        }
    }
}

Environment variables

  • NANOCART_API_KEY required secret Your NanoCart Admin API key (portal.nanocart.io -> Settings -> API Keys)
  • NANOCART_STORE_ID required Your store ID / slug (portal.nanocart.io -> Settings -> Store Information)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. nanocart-mcp
  2. Credentials
  3. Option A — Local (recommended)
  4. Option B — Hosted (no install)
  5. Example prompts
  6. Safety

nanocart-mcp

Official NanoCart MCP server — run your store from any MCP-capable AI agent (Claude Code, Claude Desktop, Cursor, Codex, and friends). List and update products (with variants and images), manage orders, coupons, categories, subscribers and settings, and pull sales reports — by asking.

39 tools. Reads are marked read-only; destructive tools (archive product, delete coupon) are annotated so your agent asks before acting. Refunds, billing changes, and API-key management are deliberately NOT exposed — do those in your dashboard.

Credentials

From your dashboard: Settings → API Keys (sc_live_..., keep secret) and Settings → Store Information (your store ID). The key grants full admin access to your store — treat it like a password.

Claude Code:

claude mcp add nanocart --env NANOCART_API_KEY=sc_live_... --env NANOCART_STORE_ID=your-store-id -- npx -y nanocart-mcp

Any client that speaks stdio MCP (JSON config style):

{
  "mcpServers": {
    "nanocart": {
      "command": "npx",
      "args": ["-y", "nanocart-mcp"],
      "env": {
        "NANOCART_API_KEY": "sc_live_...",
        "NANOCART_STORE_ID": "your-store-id"
      }
    }
  }
}

Option B — Hosted (no install)

Endpoint: https://mcp.nanocart.io/mcp?store=your-store-id with header Authorization: Bearer sc_live_... (Streamable HTTP).

Claude Code:

claude mcp add nanocart --transport http "https://mcp.nanocart.io/mcp?store=your-store-id" --header "Authorization: Bearer sc_live_..."

Note: web clients that only support OAuth-based custom connectors (e.g. claude.ai's connector UI) can't send API-key headers yet — use Option A there.

Example prompts

  • "List my draft products and publish the ones with images"
  • "Create a SUMMER20 coupon — 20% off, min order $50, expires end of August"
  • "What did I sell last week? Any orders I still need to ship?"
  • "Mark order NCT-1042 shipped with tracking 9400 1000 0000 0000 0000 00"
  • "Upload the photos in ./shots and create products from them at $24 each"

Safety

  • Secrets are redacted from every response; your key is never echoed or logged.
  • Destructive tools carry MCP destructiveHint annotations — well-behaved clients prompt before running them.
  • Prices are explicit price_cents integers (no dollars/cents ambiguity).

Pairs with the NanoCart skill (integration knowledge for building the cart into websites). Docs: https://docs.nanocart.io/#ai-build · AI-readable: https://docs.nanocart.io/llms-full.txt

MIT · © 2026 NanoCart · a ByteBunny, LLC company

Frequently asked questions

What is io.github.ByteBunny-io/nanocart-mcp?

Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.

How do I install io.github.ByteBunny-io/nanocart-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http nanocart-mcp 'https://mcp.nanocart.io/mcp' --header 'Authorization: <Bearer <your sc_live_ API key>>' --header 'X-Store-Id: <Your store ID (or append ?store=your-store-id to the URL)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ByteBunny-io/nanocart-mcp need an API key?

Yes. It expects NANOCART_API_KEY, NANOCART_STORE_ID, Authorization, X-Store-Id, which you set in its configuration.

Is io.github.ByteBunny-io/nanocart-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ByteBunny-io/nanocart-mcp?

It is published by ByteBunny-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.