$HEADLESS SYSTEMS
03 / Scorecard / Commerce

Shopware

C
Headless Index
50/100
JAIRF
81.3/100
AI-Ready
Verified
AUG 20, 2026
Methodology v1 · JAIRF v1.0.0

Powered by JAIRF v1.0.0 by Jentic · open methodology at /the-headless-index/methodology

Shopware earns Band C in the Commerce category of The Headless Index, with a thesis-fit score of 50/100 and a JAIRF rating of 81.3/100 (AI-Ready). Its strongest dimension is MCP and agent posture (20/20); its weakest scored dimension is schema observability (4/20). Shopware publishes a machine-readable OpenAPI specification, which is what lets an agent discover and operate it without human glue code.

Editorial verdict
Shopware is partially headless and partly UI-led. The Headless Index thesis-fit score of 50/100 puts it mid-table on the index, and JAIRF v1.0.0 puts it at 81.3/100 (Level 3, AI-Ready). In practice, vendors at this tier are partly machine-consumable: the core flows are reachable through code but several adjacent surfaces still expect a human at a dashboard, and the rest of this verdict explains where Shopware lands inside that pattern. On the API surface, the question is whether the API is the product or a layer beneath the dashboard. Shopware exposes a comprehensive Admin API and a Store API for headless storefronts. Shopware 6 is API-first by design and the Symfony-based backend exposes RESTful resources for every commerce primitive. SDKs in PHP and Node.[1] Schema observability is the related test: can an agent introspect the contract from cold, or does it have to read prose documentation to do so? Shopware publishes OpenAPI specifications for both Admin and Store APIs. Schema discoverability is solid for European headless commerce.[2] An agent can drive parts of this product, but not all of it: integrators should plan for human-in-the-loop checkpoints where the headless surface stops short. On headless operability: Products, orders, customers, categories, payment methods, shipping, and themes are all programmable. The Shopware Administration is a Vue.js application consuming the same Admin API. PWA Storefront and Composable Frontends extend the headless story.[3] On the MCP and agent-integration axis, which is the fastest-moving criterion in the index: No first-party Shopware MCP server has been published. The product is moving in agent-commerce direction publicly but the protocol layer is not yet first-party.[4] Event posture closes the loop: an agent that cannot react to state changes is reduced to polling. Webhook subscriptions deliver platform events with signing. Event catalog covers the major commerce lifecycle events; Apps system extends webhook surface. Net assessment: integrators can build agent flows against Shopware, but the rough edge to plan around is schema observability[5]. Expect to wrap missing pieces in bespoke glue or accept human-in-the-loop checkpoints. Workable but requires scaffolding.
Verdict by Headless Index pipeline (auto)
// AI-drafted from the evidence layer. Editorial review pending.
Scores

Scorecard detail

Headless Index · 5 sub-criteria
API-first design intent10/20
scored

Shopware exposes a comprehensive Admin API and a Store API for headless storefronts. Shopware 6 is API-first by design and the Symfony-based backend exposes RESTful resources for every commerce primitive. SDKs in PHP and Node.

signals (5)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +OpenAPI specPublished, 0 operations
  • GraphQL endpointNot discovered (5 probes; project-scoped endpoints require a real project ID)
  • +SDKs maintained3 (javascript, php); top by stars: shopware/app-php-sdk (15 stars)
  • ·npm weekly downloads347 across published packages; top: @shopware-ag/app-server-sdk @ 347/week
cite (5)
  • openapi.probes_tried@2026-05-19
  • graphql.probes_tried@2026-05-19
  • github.sdks@2026-05-19
  • freshness.most_recent_sdk_commit@2026-05-19
  • github.sdks@2026-05-19
Headless operation12/20
scored

Products, orders, customers, categories, payment methods, shipping, and themes are all programmable. The Shopware Administration is a Vue.js application consuming the same Admin API. PWA Storefront and Composable Frontends extend the headless story.

signals (9)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • API operations exposedOpenAPI present but operations could not be counted
  • ·Docs pages crawled0 pages (crawler: none)
  • ·Auth schemes documentedAuth documentation page not reached by crawler
  • ·Setup / quickstart docsNot reached by crawler
  • ·Billing docsNot reached by crawler
  • ·Teams / org docsNot reached by crawler
  • ·CLI docsNot reached by crawler
  • ·Schema / data model docsNot reached by crawler
cite (1)
  • ai_review_browser.topics_found@2026-05-20
MCP & agent posture20/20
scored

No first-party Shopware MCP server has been published. The product is moving in agent-commerce direction publicly but the protocol layer is not yet first-party.

signals (4)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +Official MCP serverhttps://github.com/shopware/shopware-admin-mcp (29 stars, last commit 316 days ago)
  • Community MCP serversNone found
  • +Agent-friendly SDKs1 TS/JS SDKs available; top: @shopware-ag/app-server-sdk (347/week downloads)
cite (1)
  • ai_review_browser.mcp@2026-05-20
Schema observability4/20
scored

Shopware publishes OpenAPI specifications for both Admin and Store APIs. Schema discoverability is solid for European headless commerce.

signals (3)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +OpenAPIPublished at https://raw.githubusercontent.com/shopware/admin-api-reference/main/adminapi.json (OpenAPI undefined, 0 operations)
  • GraphQL introspectionNo GraphQL endpoint discovered (5 probes; some vendors use project-scoped endpoints that require a real project handle)
cite (1)
  • ai_review_browser.pages_fetched@2026-05-20
Webhooks & events4/20
scored

Webhook subscriptions deliver platform events with signing. Event catalog covers the major commerce lifecycle events; Apps system extends webhook surface.

signals (2)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • ·Webhook docs pageNot reached by crawler within budget (0 pages crawled). Cannot confirm whether vendor offers webhooks.
cite (1)
  • ai_review_browser.pages_fetched@2026-05-20
JAIRF · 6 dimensions
FCFoundational Compliance
100/100

Structural validity, standards conformance, and parsability of the OpenAPI specification.

DXJDeveloper Experience & Tooling Compatibility
74.7/100

Documentation clarity, example coverage, response completeness, and ingestion health.

ARAXAI-Readiness & Agent Experience
65.7/100

Semantic clarity, intent expression, datatype specificity, and error standardization.

AUAgent Usability
90/100

Operational composability, complexity comfort, navigation affordances, and safety patterns.

SECSecurity
60/100

Authentication strength, transport security, secret hygiene, and OWASP risk posture.

AIDAI Discoverability
99.9/100

Descriptive richness, intent phrasing, workflow context, and registry signals.

Band rationale:C band: scores 40-75 range

04 / Embed

Show Shopware's score on your site.

Drop a live badge into your README, footer, or marketing page. It updates automatically when we re-score, and every embed is a dofollow link back here.

FAQ

Shopware and agent readiness

Is Shopware agent-ready?
Shopware scores Band C on The Headless Index and rates AI-Ready on JAIRF (81.3/100). Its strongest area for agent use is MCP and agent posture; its weakest is schema observability.
Does Shopware publish an OpenAPI spec?
Yes. Shopware publishes an OpenAPI specification, scored under JAIRF v1.0.0. A published spec is what makes an API discoverable and callable by agents rather than only by developers reading docs.
What is Shopware's Headless Index score?
Shopware scores 50/100 on the Headless Index thesis-fit rubric and sits in Band C in the Commerce category. The score weighs API-first design, headless operation, MCP and agent posture, schema observability, and webhooks.