storefront-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| learn_cloudcart_storefrontA | Call this first, before anything else in this server. It returns a conversationId that every other tool here requires, and — more
usefully — what the CloudCart Storefront API's schema does not show: how a
signed-in buyer is sent (an argument or @inContext(buyer:), never an
Authorization header), that a Nitrogen storefront's checkout is the store's own
(cart.checkoutUrl), that the server owns every price and money is shown as
Reading it first is the difference between a storefront that works and one that charges the wrong total. |
| introspect_graphql_schemaA | Look up types, queries and mutations in the CloudCart Storefront schema by name. Use this when you already know what something is called. When you know what you want to do but not what it is called, read learn_cloudcart_storefront's guide first — it names the operation for each step. It searches the names of types, queries and mutations, not of fields: look up the type that holds a field. Results flag fields that only answer when the merchant runs the app behind them, which is the usual explanation for an empty list. |
| validate_graphql_codeblocksA | Check GraphQL against the Storefront schema before it reaches a browser. Always run generated queries and mutations through this. The schema is large and has many close names, and an invented field looks entirely plausible until it fails. Beyond schema validity it flags mistakes that validate cleanly and still fail at runtime, such as a numeric cart id or reading delivery before the cart has an address, and it answers names borrowed from other storefront APIs with the CloudCart one. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool has a clearly distinct role: onboarding/context, schema lookup by name, and validation of generated GraphQL. The descriptions explicitly disambiguate when to use introspection versus the learning guide. An agent should not confuse these purposes.
All tool names are snake_case and follow a verb-first pattern: learn_, introspect_, validate_. The nouns are descriptive and consistently scoped to the CloudCart/GraphQL domain.
Three tools are well-scoped for a schema-assistance server: learn the quirks, look up schema names, and validate code before use. Each tool earns its place without redundancy.
The surface covers onboarding, schema discovery, and validation, which are the core workflows for generating correct Storefront GraphQL. A direct query-execution or field-level search tool is absent, but the described workflow allows agents to work around this via type lookup and validation.