01
Read the available GraphQL surface
Discover queries and mutations with their arguments directly from the schema definition. Give integration work a clearer starting point.
Magento 2.4.9
Headless Ready
Astro Storefront Required
INCLUDED IN AGENTICSUITE
Schema Discovery for Headless Magento
Give developers and connected tools a readable map of Magento’s GraphQL surface. Discover available queries, mutations and arguments without starting with source-code searches.
Part of the complete platform.
This capability is included in AgenticSuite. Get the Astro storefront and all headless and Luma-compatible modules listed on this website.
Explore AgenticSuite Discuss your Magento projectYour platform. Your control.Full source code and your business data.
Built to work togetherAstro storefront and comprehensive Magento modules.
Check your requirements with us - Read queries, mutations and their arguments
- Admin-gated by default
- Schema inspection rather than business-data access
BUILT AROUND THE WAY YOU WORK
Understand the API before you integrate it.
Included in AgenticSuite. This is part of a headless Magento implementation; the storefront and deployment must be configured to use it.
02
Control who can discover it
Anonymous access is off by default, with Admin gating and an optional long token. The module reads schema definitions rather than store data or configuration.
A CLEAR WORKFLOW
From setup to everyday use.
- 01
Explore AgenticSuite and the live storefronts to see how the parts fit together.
- 02
Discuss your current Magento setup, integrations and requirements with our team.
- 03
Configure and test this capability as part of the agreed storefront project.
Do I need to buy this capability separately?+
AgenticSuite includes the Astro storefront and all headless and Luma-compatible modules listed on this website. Discuss the complete platform and your implementation scope with us.
Can you migrate my current store while it remains live?+
We can prepare and test a new storefront while the existing store keeps trading. Product, CMS and compatible module-data migration, final data synchronisation and cutover are planned for your specific project.
Does the licence include hosting and a bespoke build?+
Hosting, migration, training and custom development are agreed separately. We can discuss Cloudways for Magento and Cloudflare for the frontend; you can pay the providers directly or request a managed quotation.
Latest release: Version 1.0.3
Schema Discovery is a Magento 2 module that provides a safe, permission-gated way to explore your Magento GraphQL API surface from the admin, so a headless build can discover the available types and fields without leaving introspection open to the public.
You can't build against an API you can't see
Magento's GraphQL is huge, and every module you add — including this suite — extends it further. When a developer or an AI coding assistant is wiring up a headless storefront, the first question is always the same: what queries and mutations actually exist here, and what do they take? Answering it usually means grepping through dozens of .graphqls files across core and third-party modules. Schema Discovery answers it in one query — safely.
Full API surface · Queries + mutations · With arguments · Reads SDL only · Admin-gated by default · Anonymous off · Optional long token · Check release-specific Magento and PHP compatibility
| One map of everything | List all available GraphQL queries and mutations across core and every installed module in a single call. |
|---|---|
| Arguments included | Each field comes with its arguments, so you know how to call it without reading the schema source. |
| Perfect for AI tooling | Give a coding assistant the exact API surface so it builds against what exists, not what it guesses. |
| Locked down | Admin-gated by default with anonymous access off and an optional long shared token. |
What you'll use it for
- Onboard a headless build — hand developers the complete, current list of queries and mutations instead of a stale doc.
- Feed AI assistants — let an AI tool read the real API surface so generated GraphQL calls are valid first time.
- Audit what's exposed — see exactly which queries and mutations your installed modules add to the schema.
- Speed up integrations — discover the fields a third-party module registered without opening its source.
How it works
An introspection tool that's safe to ship
Schema introspection is useful to you — and to an attacker. So this one is locked down. It's admin-gated by default, anonymous access is off, and if you want to grant a build pipeline or an AI tool access without an admin session you set a single long shared token (compared safely), nothing weaker. Crucially, it only ever reads the schema definition — the .graphqls SDL that describes the API's shape. It never reads a product, a customer, a config value or a database row, so even when access is granted, there's no data to leak — only the public structure of the API.
Specifications
| Query | schemaDiscovery — lists all GraphQL queries and mutations with arguments |
|---|---|
| Source | Reads the GraphQL schema definition (SDL) only |
| No data access | Never reads products, customers, config or the database |
| Default access | Admin-gated; anonymous access off |
| Token option | Optional long shared token (compared with a constant-time check) |
| Use cases | Headless onboarding, integration discovery, AI tooling, API audit |
| Delivery & licence | Composer install, per-domain licence key, updates via Composer |
Works with
Part of the AgenticEcom suite for Headless & Astro:
The discovery companion to the headless bundles — it lists the very queries they add. Included in the AgenticEcom Suite.
Frequently asked questions
What does it return?
A single query lists every available GraphQL query and mutation — across Magento core and all installed modules — together with their arguments, so you can see the whole API surface at a glance.
Is it safe to expose?
It's locked down by default: admin-gated, anonymous access off, with an optional long shared token for trusted automation. And it only reads the schema definition — never products, customers, config or the database — so there's no data to leak.
Why is this useful for AI coding tools?
An AI assistant builds far better GraphQL when it knows exactly what exists. Pointing it at Schema Discovery gives it the real, current API surface, so generated queries and mutations are valid rather than guessed.
Does it read my catalogue or settings?
No. It reads only the GraphQL SDL — the definition of the API's shape. It never accesses product data, customer data, configuration values or the database.
Which Magento and PHP versions are supported?
Check release-specific Magento and PHP compatibility before installation.
SEE THE WHOLE PLATFORM
The capability is one part. AgenticSuite brings it together.
Keep Magento as your commerce engine. Shape the customer experience in Astro Admin, with an integrated module collection behind it.
A complete B2B catalogue.
Explore SyncComms: approximately 1,000 products, guided finders, category filters and a quotation journey.
Explore SyncCommsMobile scores achieved.
See the dated mobile lab reports linked from our homepage, or test the live sites yourself. Results depend on the page and test conditions.
View the performance evidenceMake the move while you trade.
We can scope migrations, frontend rebuilds and new stores. Hosting, migration, training and custom development are agreed separately.
Discuss your projectYOUR NEXT STOREFRONT STARTS HERE
See what AgenticSuite could do for your business.
Explore the working sites, watch the overview, then talk to us about your catalogue and the store you want to build.