Gadget MCP Server
A read-only MCP server that lets you explore and query any Gadget app's data via GraphQL — no generated client required. It supports multiple apps and both production/development environments.
List all models (
list_models): Discover every model available in your Gadget app via GraphQL introspection.Inspect model fields (
introspect_model): View all fields and their types for any model — useful before querying to know what fields exist.Query multiple records (
query_records): Fetch records from any model with custom field selection, filtering (e.g.,{ "name": { "equals": "#59389" } }), and result limits (default 10, max 50).Fetch a single record (
get_record): Retrieve one specific record by its ID with custom field selection.Run raw GraphQL queries (
run_graphql): Execute arbitrary read-only GraphQL queries for complex use cases like nested relations or advanced filtering — mutations are blocked to enforce read-only access.
Provides tools to interact with Gadget applications via GraphQL, enabling users to list models, perform introspection, and execute read-only queries against application data.
Enables read-only access to Shopify-related data stored in Gadget apps, allowing users to query records such as Shopify orders and inspect Shopify-specific data models.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gadget MCP Servershow me the fields on the shopifyOrder model"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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 setupThe wizard will:
Detect your app slug from
.gadget/sync.json(if present)Prompt for your API key and environment
Output the ready-to-run
claude mcp addcommand for Claude CodeAutomatically write your
~/.cursor/mcp.jsonfor 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-mcpRegister 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-mcp3. 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 |
| Yes | — | App slug, e.g. |
| Yes | — | Production API key |
| No |
|
|
Tools
Tool | Description |
| List all models available in the app |
| Show fields and types for a model |
| Query any model with filters and field selection |
| Fetch a single record by ID |
| 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
mainFor 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 testAbout
Made with ♥ by Stronger eCommerce — Shopify development and eCommerce operations.
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Stronger-eCommerce/gadget-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server