@stronger-ecommerce/gadget-mcp

Generic read-only MCP server for any Gadget app. Query any model via GraphQL introspection — no generated client required.

Built by Stronger eCommerce.

Quick setup (recommended)

Run the interactive setup wizard from inside your Gadget project directory. It auto-detects your app slug from .gadget/sync.json and writes your config automatically.

npx @stronger-ecommerce/gadget-mcp setup

The wizard will:

1. Detect your app slug from .gadget/sync.json (if present)

2. Prompt for your API key and environment

3. Output the ready-to-run claude mcp add command for Claude Code

4. Automatically write your ~/.cursor/mcp.json for Cursor

Manual setup

1. Get a production API key

Go to https://<your-app>.gadget.app/edit/settings/api-keys and create a key with read access.

2. Register in Claude Code

claude mcp add my-app-gadget \
  -e GADGET_APP=my-app \
  -e GADGET_API_KEY=your_key_here \
  -- npx @stronger-ecommerce/gadget-mcp

Register multiple apps under different names:

claude mcp add app-one-gadget \
  -e GADGET_APP=my-first-app \
  -e GADGET_API_KEY=key1 \
  -- npx @stronger-ecommerce/gadget-mcp

claude mcp add app-two-gadget \
  -e GADGET_APP=my-second-app \
  -e GADGET_API_KEY=key2 \
  -- npx @stronger-ecommerce/gadget-mcp

3. Register in Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "app-one-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-first-app",
        "GADGET_API_KEY": "key1"
      }
    },
    "app-two-gadget": {
      "command": "npx",
      "args": ["@stronger-ecommerce/gadget-mcp"],
      "env": {
        "GADGET_APP": "my-second-app",
        "GADGET_API_KEY": "key2"
      }
    }
  }
}

Environment variables

Tools

Example usage

Once connected, ask Claude:

• "List the models in my Gadget app"

• "Show me the fields on the shopifyOrder model"

• "Find orders where email is customer@example.com"

• "Get all records with errors"

About

Made with ♥ by Stronger eCommerce — Shopify development and eCommerce operations.