A2A Grocery — the agentic hub for retail grocery procurement

io.github.greencore-solutionsv1.0.0Updated Oct 2, 2026

A2A + MCP hub for retail grocery procurement — 20 markets on the SCHEMA algo record. Trade only.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

A remote MCP hub for business-to-business retail grocery procurement, letting an assistant check market rules, cleared products, prices and order intents…

What it does
A2A Grocery is a remote streamable-HTTP MCP server for retail grocery trade. It exposes 19 tools grouped into gate calls (resolve_jurisdiction, resolve_actor, gate_transaction), SKU tools (search_cleared_items, get_item, verify_gtin, get_label_and_claims, compare_items), chain tools (find_verified_buyer, find_verified_supplier), documents and audit tools, economics tools (get_price, get_availability, create_order_intent, a2a_handoff) and market-status tools. The gate calls must run before any availability, price, document, order or handoff tool, which refuse without an allow decision. Records carry source pages, claim status and notices.
When to use it
Use it when an assistant needs to support grocery procurement or sourcing work: finding cleared suppliers or buyer desks, checking label and claim requirements per market, verifying GTINs, or preparing order intents across the 20 covered markets. It is aimed at trade users such as makers, brand owners, distributors, importers and retailers, not consumers.
Requirements
A remote endpoint at over streamable-HTTP; no local package or runtime. Reads are open, but transacting tools require a client-credentials Bearer token from the issuer a2a-registry.ai with scope grocery.transact, obtained after registering at its OAuth registration path. Network access is required.
Before you install
Transacting tools need a Bearer credential from the issuer; treat it as a secret. Order intents and handoffs are write actions and are gated, and payment is described via x402 in USDC on Base, so spending can occur after the gate. The server states it is an information source, not a recommendation, and that AI makes mistakes, so verify records before acting.

Installation

In SourceWeft

  1. Open A2A Grocery — the agentic hub for retail grocery procurement in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "a2a-grocery": {
      "type": "http",
      "url": "https://mcp.a2a-grocery.ai/mcp"
    }
  }
}

README

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, speciality foods first. 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)
  • 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://<country code>.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: 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

[email protected] — 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.

Source: README.md at commit afc267d

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 2, 2026