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?

Clone io.github.ByteBunny-io/nanocart-mcp from https://github.com/ByteBunny-io/nanocart-mcp and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

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

Yes, io.github.ByteBunny-io/nanocart-mcp is open source under the MIT license. Source code is available at https://github.com/ByteBunny-io/nanocart-mcp.

What category does io.github.ByteBunny-io/nanocart-mcp belong to?

io.github.ByteBunny-io/nanocart-mcp is listed under Developer Tools MCP servers on MCPFind.

io.github.ByteBunny-io/nanocart-mcp — MCP Server for Developer Tools

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.

Option A — Local (recommended)

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

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-bytebunny-io-nanocart-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nanocart-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.ByteBunny-io/nanocart-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.ByteBunny-io/nanocart-mcp