@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

Variable	Required	Default	Description
GADGET_APP	Yes	—	App slug, e.g. my-app
GADGET_API_KEY	Yes	—	Production API key
GADGET_ENVIRONMENT	No	production	production or development

---

Tools

Tool	Description
list_models	List all models available in the app
introspect_model	Show fields and types for a model
query_records	Query any model with filters and field selection
get_record	Fetch a single record by ID
run_graphql	Run a raw read-only GraphQL query (mutations are blocked)

---

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"

---

Future features

Planned ideas and research notes (including logs / ggt integration for agents) live in FUTURE_FEATURES.md.

---

Contributing

Bug reports and pull requests are welcome!

• Found a bug? Open an issue
• Have a fix or feature? Fork the repo, make your changes, and open a PR against main
• For significant changes, open an issue first so we can align on the approach

Running locally

git clone https://github.com/Stronger-eCommerce/gadget-mcp
cd gadget-mcp
npm install
npm run build
npm test

---

About

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