A2A Grocery — the agentic hub for retail grocery procurement MCP server

A2A Grocery — the agentic hub for retail grocery procurement

Powered by SCHEMA algo for grocery agentic commerce

Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for retail grocery. Business to business: makers, brand owners, private label, distributors, importers, retailers and their AI agents. Twenty markets on the SCHEMA algo grocery record; ambient, chilled, frozen and fresh; organic, free-from, plant-based, artisan, origin and premium lanes. Call resolvejurisdiction, then resolveactor, then gatetransaction before any availability, price, documents, order or handoff tool; those tools refuse without an allow decision. Every record field carries its source page; every response carries notice; every record carries claimstatus (listed · claimed · verified). Artificial intelligence makes mistakes. A2A Grocery is an agentic information source, not a recommendation. No ads, ever. No rank for sale. Trade only.

A2A Grocery is built and run by GreenCore Solutions Corp. (github.com/greencore-solutions). This is the public connect kit, MIT.

The door

<!-- door:begin -->streamable-HTTP, stateless, server name a2a-grocery, door version 1.0.0, 19 tools (read from the wire 2026-10-02)<!-- door:end -->

• Endpoint: https://mcp.a2a-grocery.ai/mcp — any client that speaks streamable-HTTP: { "url": "https://mcp.a2a-grocery.ai/mcp", "transport": "streamable-http" }
• A2A 0.3.0 JSON-RPC: https://a2a-grocery.ai/a2a (the hub) and https://.a2a-grocery.ai/a2a (one market agent per market, for example fr.a2a-grocery.ai for France)
• Agent Card: https://a2a-grocery.ai/.well-known/agent-card.json (ES256, kid a2ag-2026-10; keyring /.well-known/jwks.json)
• Setup: https://a2a-grocery.ai/setup · Docs: https://a2a-grocery.ai/docs · Support: https://a2a-grocery.ai/support
• Official MCP Registry: io.github.greencore-solutions/a2a-grocery (server.json in this repo)

The twenty markets

Europe: France, Germany, Italy, Spain, Poland, UK, Netherlands, Belgium, Switzerland. Americas: United States, Canada, Mexico, Brazil. Asia-Pacific: Japan, South Korea, India, Vietnam, Thailand, Singapore, Australia. Every market is a jurisdiction on the record from day one, on one of fourteen rule sets (the seven European Union markets share one food-law set with national riders).

The gate

Three calls before any price: resolvejurisdiction → resolveactor → gatetransaction. Twelve reason codes: ALLOW · REQUIRENOTIFICATION · REQUIRERESPONSIBLEPERSON · DENYNOTPERMITTEDHERE · DENYINGREDIENTBANNED · DENYINGREDIENTLIMIT · DENYCLAIM · DENYMARKET · DENYACTORCLASS · DENYUNLICENSEDAGENT · DENYNOGTIN · DENYNOT_VERIFIED.

The tools

• Gate — resolvejurisdiction, resolveactor, gate_transaction
• SKUs — searchcleareditems, getitem, verifygtin, getlabelandclaims, compareitems
• Chains — findverifiedbuyer, findverifiedsupplier
• HITL (the auditor and documents lane) — getproductdocuments, log_audit
• Economics — getprice, getavailability, createorderintent, a2a_handoff
• Acts — getmarketstatus, getnotificationrequirements, getenforcementwatch

Reads are open. The transacting tools take a client-credentials Bearer from the issuer, https://a2a-registry.ai (register at /oauth/register; scope grocery.transact; see https://a2a-grocery.ai/auth.md).

Two worked prompts

Buy side — "Find cleared organic dry pasta suppliers for a discounter in Germany, with certificates and availability."

Sell side — "Which retail buyer desks in France take artisan chilled products, and what does each market require on the label?"

Examples

Stock clients, no adapter: examples/awsstrands.py · examples/azuresemantickernel.py · examples/googlegenai.py · examples/genericmcpclient.py; A2A: examples/a2aawsstrands.py · examples/a2aazureagentframework.py · examples/a2agoogle_sdk.py.

Search words

Shortened. The full README is on GitHub.