
a2a-grocery
io.github.greencore-solutions/a2a-grocery
A2A + MCP hub for retail grocery procurement — 20 markets on the SCHEMA algo record. Trade only.
Documentation
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 resolve_jurisdiction, then resolve_actor, then gate_transaction 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 claim_status (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
streamable-HTTP, stateless, server name `a2a-grocery`, door version 1.0.0, 19 tools (read from the wire 2026-10-02) Product facts on this hub are served live from gtinfetch.ai, the GTIN resolver for AI agents; every answer carries its source page, date read and gtinfetch’s signature. Paid resolves at x402.gtinfetch.ai.- 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) andhttps://<country code>.a2a-grocery.ai/a2a(one market agent per market, for examplefr.a2a-grocery.aifor France) - Agent Card:
https://a2a-grocery.ai/.well-known/agent-card.json(ES256, kida2ag-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: resolve_jurisdiction → resolve_actor → gate_transaction. Twelve reason codes: ALLOW · REQUIRE_NOTIFICATION · REQUIRE_RESPONSIBLE_PERSON · DENY_NOT_PERMITTED_HERE · DENY_INGREDIENT_BANNED · DENY_INGREDIENT_LIMIT · DENY_CLAIM · DENY_MARKET · DENY_ACTOR_CLASS · DENY_UNLICENSED_AGENT · DENY_NO_GTIN · DENY_NOT_VERIFIED.
The tools
- Gate —
resolve_jurisdiction,resolve_actor,gate_transaction - SKUs —
search_cleared_items,get_item,verify_gtin,get_label_and_claims,compare_items - Chains —
find_verified_buyer,find_verified_supplier - HITL (the auditor and documents lane) —
get_product_documents,log_audit - Economics —
get_price,get_availability,create_order_intent,a2a_handoff - Acts —
get_market_status,get_notification_requirements,get_enforcement_watch
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/aws_strands.py · examples/azure_semantic_kernel.py · examples/google_genai.py · examples/generic_mcp_client.py; A2A: examples/a2a_aws_strands.py · examples/a2a_azure_agent_framework.py · examples/a2a_google_sdk.py.
Search words
grocery · retail grocery · procurement · supplier · buyer · private label · GTIN · discounter · supermarket · speciality foods · organic · cleared · orderable · AI agent · agent-to-agent · 20 markets · SCHEMA algo · A2A Grocery · agentic hub · Estate AI Agent · GSC Agentic Core
Pay on it
x402 on https://a2a-x402.ai (USDC on Base, settlement after the gate; a refused order intent is not settled and not charged). Front door: https://a2a-pay.ai.
Contact
mcp@a2a-grocery.ai — the registry contact for every listing this hub files. A person reads the form at https://a2a-grocery.ai/support.
Built and run by GreenCore Solutions Corp. Artificial intelligence makes mistakes. A2A Grocery is an agentic information source, not a recommendation. No ads, ever. No rank for sale. Trade only.
No installation packages available.
Remote
Related Servers
io.github.greencore-solutions/a2a-cosmetics
Agent-to-Agent (A2A) hub for cosmetics: skin care, fragrance, sun care, dermocosmetics.
io.github.greencore-solutions/a2a-passport
The hubs are the records; A2A-Passport.ai issues the passport.
io.github.greencore-solutions/a2a-retailmedia
Connecting grocery retail to 350k makers for media buys.