# A2A Grocery — the agentic hub for retail grocery procurement

> A2A Grocery — the agentic hub for retail grocery procurement is an MCP server for e-commerce. Grocery supplier records, market rules and gated orders across 20 markets, trade only. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Contact sales
- **Platforms:** API
- **Website:** https://a2a-grocery.ai
- **Repository:** https://github.com/greencore-solutions/a2a-grocery
- **MCP Registry name:** io.github.greencore-solutions/a2a-grocery
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-14

## About

A2A Grocery is a procurement hub for retail food: makers and brand owners are listed, and buyers' agents search the records and place orders. The registry description ties it to the SCHEMA algo grocery record, covering ambient, chilled, frozen and fresh goods and lanes such as organic, free-from, plant-based, artisan and origin. It lists nineteen tools in the README.

The flow is deliberate. Before any price, availability, document, order or hand-off, an agent calls `resolve_jurisdiction`, `resolve_actor` and `gate_transaction`; later tools refuse without an allow decision. Records show a claim status of listed, claimed or verified and cite a source page on every field. Chain tools such as `find_verified_buyer` and `find_verified_supplier` connect the two sides.

The site covers twenty markets across Europe, the Americas and Asia-Pacific, with the record held in France Central. Reads are open and writes need an OAuth credential.

## Features

- **Gate before price:** Jurisdiction, actor and eligibility are resolved before any order.
- **Twenty markets:** Europe, Americas and Asia-Pacific jurisdictions on the record.
- **Claim status:** Records are marked listed, claimed or verified.
- **Buyer and supplier search:** Find verified buyers or suppliers for an item.
- **Cited fields:** Every record field names its source page.
- **Auditor port:** A read-only seat for people a buyer or maker appoints.

## Good for

- Find cleared organic pasta suppliers for a German discounter
- Check a food item's rules in a target market
- Verify a GTIN and its label claims
- Compare cleared items side by side
- Create an order intent after clearance

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http a2a-grocery https://mcp.a2a-grocery.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.a2a-grocery.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "a2a-grocery": {
      "url": "https://mcp.a2a-grocery.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "a2a-grocery": {
      "serverUrl": "https://mcp.a2a-grocery.ai/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.a2a-grocery.ai/mcp
```

Enter a Name (for example "A2A Grocery — the agentic hub for retail grocery procurement"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `resolve_jurisdiction`: Where is this going? Resolve a ship-to (e.g. 'DE', 'US-CA', 'UK', 'FR', 'EU-NL', 'JP') to one of the 20 markets and its rule set (14 rule sets; the seven EU markets share one food-law set with national riders). UK is the label; machine fields carry the ISO code GB.
- `resolve_actor`: Who is asking? Maker, brand owner, private label, distributor, importer, broker or retail buyer (trade only); auditor (read-only); agent (inherits the class of the credential it presents — none returns DENY_UNLICENSED_AGENT). The consumer is never the counterparty. Returns communication_class: trade_information or public.
- `gate_transaction`: Allow or deny, with the reason and the rule. Takes an item (GTIN or catalogue id; optional), the ship-to market, the actor class and, when no record exists yet, the product type, ingredients and claims. Returns one of twelve reason codes (ALLOW · REQUIRE_NOTIFICATION · REQUIRE_RESPONSIBLE_PERSON · DENY_NOT_PERMITTED_HERE · DENY_INGREDIENT_BANNED · DENY_INGREDIENT_LIMIT · DENY_CLAIM · DENY_MARKET ·
- `search_cleared_items`: Find items cleared for this market: validated SKU records in a market (query by product name, brand, maker or category; filters: temperature ambient · chilled · frozen · fresh, attribute lane organic · free-from · plant-based · artisan · origin · premium, department). Only validated rows are served; each item carries its claim status, market status and source class.
- `get_item`: Product record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability. One item by GTIN (EAN in European copy), fully resolved: temperature, department → super category → category, attribute lanes, pack, brand and maker, market, claim status, market status, availability; after the gate also ingredients, allergens, claims, origin, certificates, variants and offers.
- `verify_gtin`: Product record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability. Is this GTIN real, and whose is it? Check-digit validation, the GS1 prefix, and the validated record(s) that carry it on this hub with their brand, maker and claim status.
- `get_label_and_claims`: What the label must say, and which claims are allowed: the labelling requirements of the market (food information, allergens, origin, nutrition) and the claims rules of record (nutrition and health claims, organic, free-from), each with its source page. Optional claims are checked against the rules.
- `compare_items`: Compare items, variants and pack sizes side by side (two to eight GTINs or catalogue ids).
- `find_verified_buyer`: Retail buyer desks for this market: banner records (banner, parent group, channel discounter · e-commerce · local · in-store · traditional, local format, cited POS count or NULL, buyer desk by department) with their claim status — verified first, then claimed, then listed. Filters: channel, department. Takes the decision_id of an allow decision.
- `find_verified_supplier`: Verified makers, brand owners, private-label owners, distributors and importers for this item or category in a market: maker records with their claim status — verified first, then claimed, then listed. Takes the decision_id of an allow decision.
- `get_product_documents`: Certificates and paper: the documents on an item record (organic certificate, PDO/PGI, halal, kosher, specification, allergen statement, origin declaration, lot where it applies), each a URL with its read date and source class; decision_id required.
- `log_audit`: Write a line to the audit record for a gate decision, an order intent or a handoff (returns the line id).
- `get_price`: The price for this buyer: the price basis (list · contract · promotion window) from the maker's offers on the record, once gate_transaction has answered allow (decision_id). Plain $ on human surfaces. Tiers buy services, never rank.
- `get_availability`: In stock, and where: the availability block of an item (banners on the shelf of record, product URLs read live at load, POS counts where the banner record carries a cited one) once gate_transaction has answered allow (decision_id).
- `create_order_intent`: Open an order between two agents: an order intent for a cleared item after the gate; the intent carries reason_code + rule_set_version and settles by x402 on a2a-x402.ai.
- `a2a_handoff`: Hand the buyer to the right agent over Agent-to-Agent (A2A): with an allow decision the order intent goes to the counterparty's agent (envelope + card URL); with a deny, the market agent of the ship-to — a referral, never a sale to a consumer.
- `claim_seat`: A brand's agent claims its seat on A2A Grocery. Give the agent's card URL and the GTINs the brand claims: every GTIN must resolve on gtinfetch.ai to the maker the card names, and the category comes first (grocery proceeds; a beauty record is referred to a2a-cosmetics.ai; peptides to a2a-peptides.ai; beer, wine and spirits are refused; an unresolved GTIN is refused). An accepted claim answers a cha
- `search_catalog`: Universal Commerce Protocol (UCP) catalogue search, version 2026-08-25 (dev.ucp.shopping.catalog.search). arguments: meta {'ucp-agent': {profile}} (required) and catalog {query, context {address_country}, filters {categories, price {min, max} in minor units}, pagination {limit, cursor}}. Serves the priced subset: rows whose maker's list price is on the record (claimed seats with a listed price), k
- `lookup_catalog`: Universal Commerce Protocol (UCP) catalogue lookup, version 2026-08-25 (dev.ucp.shopping.catalog.lookup). arguments: meta {'ucp-agent': {profile}} (required) and catalog {ids: product ids (GTIN) or variant ids (<market>:<gtin14>), up to 50; context; filters}. Found rows come back as products with their claim_status; an id outside the priced subset answers an info not_found message.
- `get_product`: Universal Commerce Protocol (UCP) product detail, version 2026-08-25 (dev.ucp.shopping.catalog.lookup). arguments: meta {'ucp-agent': {profile}} (required) and catalog {id: a GTIN or a variant id <market>:<gtin14>; context; filters}. One product of the priced subset with its variants per market, list price and claim_status; outside the subset, ucp.status error and not_found.
- `get_market_status`: Is this product type a food here, and under which regime? Product type by market: food, special class (novel food, food supplement, infant formula, fortified, organic-certified, alcohol excise) or not permitted — with the rule-set version and the regulator's page.
- `get_notification_requirements`: What must be filed before sale in a market: the food business registration or import notification scheme, the food business operator of record, and, for a product type in a special class, the extra step (novel-food authorisation, organic certification, supplement notification) — each with its source page.
- `get_enforcement_watch`: Recalls, withdrawals and food-safety alerts, dated: enforcement events by market, category, brand or since a date, each with its source page.

## FAQ

### Who can use it?

It is trade only: makers, brand owners, private label, distributors, importers and retailers and their agents.

### Do reads need a token?

Reads are open to every agent. Write calls use OAuth client credentials from a2a-registry.ai.

### Where is the data held?

The site says the record sits in Azure France Central with a second copy in France South.

### Are there ads or paid ranking?

The site says no ads and no rank for sale.

### How much does A2A Grocery — the agentic hub for retail grocery procurement cost?

A2A Grocery — the agentic hub for retail grocery procurement does not publish prices. Contact the company for a quote.

### How do I add A2A Grocery — the agentic hub for retail grocery procurement to Claude Code?

Run this command in your terminal: claude mcp add --transport http a2a-grocery https://mcp.a2a-grocery.ai/mcp

### What are the best alternatives to A2A Grocery — the agentic hub for retail grocery procurement?

The closest alternatives to A2A Grocery — the agentic hub for retail grocery procurement are A2A Retailmedia — the agentic retail-media hub for grocery, A2A Cosmetics, shopfetch, Agorantis and Agent Bazaar.

## Where this comes from

- Description: written from the project's README and the project's website.
- Status and tools: checked automatically by AIPoweredBot on 18 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [A2A Retailmedia — the agentic retail-media hub for grocery](https://ai-powered.com/mcp/a2a-retailmedia-the-agentic-retail-media-hub-for-grocery): A2A Retailmedia — the agentic retail-media hub for grocery is an MCP server for marketing and seo.
- [A2A Cosmetics](https://ai-powered.com/mcp/a2a-cosmetics): A2A Cosmetics is an MCP server for legal and government.
- [shopfetch](https://ai-powered.com/mcp/shopfetch): shopfetch is a freemium MCP server for e-commerce.
- [Agorantis](https://ai-powered.com/mcp/agorantis): Agorantis is a freemium MCP server for e-commerce.
- [Agent Bazaar](https://ai-powered.com/mcp/agent-bazaar): Agent Bazaar is a free MCP server for e-commerce.
- [Agent Shopping Tracker](https://ai-powered.com/mcp/agent-shopping-tracker): Agent Shopping Tracker is a free MCP server for e-commerce.
- [Grocery Prices: US, Australia, India, Latin America (Yugenox)](https://ai-powered.com/mcp/grocery-prices-us-australia-india-latin-america-yugenox): Grocery Prices: US, Australia, India, Latin America (Yugenox) is a paid MCP server for e-commerce.
- [WebAZ](https://ai-powered.com/mcp/webaz): WebAZ is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/a2a-grocery-the-agentic-hub-for-retail-grocery-procurement
