A2A Grocery MCP server
Commit Nov 13, 2026Enables AI agents to perform B2B retail grocery procurement, including SKU searches, price verification, and transaction gating across twenty global markets.
Also known as greencore-solutions/a2a-grocery, cpg-knowledge-graph
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.5.1
- Last commit
- Nov 13, 2026
- License
- MIT
What is A2A Grocery MCP?
A2A Grocery enables AI agents to perform B2B retail grocery procurement, including SKU searches, price verification, and transaction gating across twenty global markets.
Summary generated from the project's README
About A2A Grocery MCP server
A2A Grocery provides a specialized hub for business-to-business retail grocery procurement using the SCHEMA algorithm. It serves makers, brand owners, distributors, and retailers by allowing AI agents to navigate twenty global markets across Europe, the Americas, and Asia-Pacific. The server handles various product categories including ambient, chilled, frozen, and fresh goods, covering specific lanes like organic, plant-based, and premium items.
Users connect via streamable-HTTP to the a2a-grocery endpoint. While reads are open, performing transactions requires a client-credentials Bearer token from the A2A Registry with the grocery.transact scope. The system enforces a strict security protocol where agents must call resolve_jurisdiction, resolve_actor, and gate_transaction before accessing availability, pricing, or ordering tools. This ensures all commerce adheres to specific market rules and ingredient regulations.
This platform functions as an agentic information source rather than a recommendation engine. It provides verified data through tools like search_cleared_items, get_price, and verify_gtin. Every response includes a source page and claim status to maintain transparency in the procurement process.
What you can do with it
- 1Sourcing organic food suppliersFind cleared organic dry pasta suppliers for a discounter in Germany, including their certificates and current availability.
- 2Analyzing market labeling requirementsIdentify which retail buyer desks in France accept artisan chilled products and determine the specific labeling requirements for that market.
- 3Executing regulated B2B transactionsPerform a gated procurement transaction by resolving jurisdiction and actor identity before creating an order intent.
Written from the project's README. Every use case is checked against a quote from it.
How to install A2A Grocery MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall A2A Grocery MCP in Claude Code
$ claude mcp add --transport http cpg-knowledge-graph https://mcp.cpgknowledgegraph.ai/mcpInstall A2A Grocery MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cpg-knowledge-graph": {
"url": "https://mcp.cpgknowledgegraph.ai/mcp"
}
}
}Install A2A Grocery MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cpg-knowledge-graph": {
"type": "http",
"url": "https://mcp.cpgknowledgegraph.ai/mcp"
}
}
}Install A2A Grocery MCP in VS Code CLI
$ code --add-mcp '{"name":"cpg-knowledge-graph","type":"http","url":"https://mcp.cpgknowledgegraph.ai/mcp"}'Install A2A Grocery MCP in Codex
$ codex mcp add cpg-knowledge-graph --url https://mcp.cpgknowledgegraph.ai/mcpInstall A2A Grocery MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cpg-knowledge-graph] url = "https://mcp.cpgknowledgegraph.ai/mcp"
Install A2A Grocery MCP in Gemini CLI
$ gemini mcp add -s user --transport http cpg-knowledge-graph https://mcp.cpgknowledgegraph.ai/mcpInstall A2A Grocery MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cpg-knowledge-graph": {
"url": "https://mcp.cpgknowledgegraph.ai/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegreencore-solutions/a2a-grocery is public and reachablegithub.com/greencore-solutions/a2a-grocery ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/greencore-solutions/a2a-grocery ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 408 msPass
README
View on GitHubA2A 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
- 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.
A2A Grocery MCP questions
How do I add A2A Grocery MCP to Claude Code?
Run claude mcp add --transport http cpg-knowledge-graph https://mcp.cpgknowledgegraph.ai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add A2A Grocery MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What markets does A2A Grocery cover?
The hub covers twenty markets across Europe, the Americas, and Asia-Pacific, including countries like France, Germany, USA, Canada, Japan, and Australia.
How are transactions secured and gated?
Transactions require three specific calls in sequence: resolve_jurisdiction, resolve_actor, and gate_transaction before any availability or pricing tools can be used.
Is the information provided a recommendation?
No, the platform is an agentic information source and not a recommendation engine.
What authentication is required for transacting tools?
Transacting tools require a client-credentials Bearer token from the issuer at a2a-registry.ai.