A2A Grocery — the agentic hub for retail grocery procurement

Official19 tools

by greencore-solutions · Python

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

io.github.greencore-solutions/a2a-grocery (MCP)

This MCP server functions as an A2A + MCP hub for retail grocery procurement. The provided description indicates trade-only operation and references “20 markets on the SCHEMA algo record.” The server’s catalog entry is identified by the slug io-github-greencore-solutions-a2a-grocery.

🛠️ Key Features

A2A + MCP hub for retail grocery procurement
Trade-only scope
Coverage: 20 markets on the SCHEMA algo record

🚀 Use Cases

Retail grocery procurement workflows requiring an A2A + MCP integration
Market-specific procurement handling across the referenced 20 markets

⚡ Developer Benefits

Clear, focused purpose: A2A + MCP hub for grocery procurement
Explicit trade-only constraint and defined market coverage (20 markets)

⚠️ Limitations

No additional details provided about specific MCP tools, interfaces, or capabilities beyond the description.

Topics

a2aagent-to-agentai-agentbuyergrocerygtinmcporganicprivate-labelprocurementsupermarketsupplierdiscounterretail-groceryspeciality-foods

Captured live from the server via tools/list.

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.

Parameters1

ship_to

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ship_to": {
      "type": "string"
    }
  },
  "required": [
    "ship_to"
  ]
}

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.

Parameters2

actor_class	string	required
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "actor_class": {
      "type": "string"
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "actor_class"
  ]
}

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 · DENY_ACTOR_CLASS · DENY_UNLICENSED_AGENT · DENY_NO_GTIN · DENY_NOT_VERIFIED), the rule-set version, the source page and a decision_id for the downstream tools.

Parameters8

ship_to	string	required
actor_class	string	required
product	any	optional
product_type	any	optional
ingredients	any	optional
claims	any	optional
channel	any	optional
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ship_to": {
      "type": "string"
    },
    "actor_class": {
      "type": "string"
    },
    "product": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ingredients": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "claims": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "channel": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "ship_to",
    "actor_class"
  ]
}

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.

Parameters8

market	string	required
query	any	optional
temperature	any	optional
lane	any	optional
department	any	optional
product_type	any	optional
limit	integer	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "temperature": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "lane": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "department": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 25,
      "type": "integer"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

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.

Parameters3

gtin	string	required
market	any	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin"
  ]
}

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.

Parameters1

gtin

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    }
  },
  "required": [
    "gtin"
  ]
}

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.

Parameters3

market	string	required
claims	any	optional
product_type	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "claims": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

compare_items

Compare items, variants and pack sizes side by side (two to eight GTINs or catalogue ids).

Parameters3

gtins	array	required
market	any	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtins": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtins"
  ]
}

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.

Parameters6

market	string	required
decision_id	string	required
channel	any	optional
department	any	optional
query	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "channel": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "department": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 25,
      "type": "integer"
    }
  },
  "required": [
    "market",
    "decision_id"
  ]
}

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.

Parameters6

market	string	required
decision_id	string	required
gtin	any	optional
query	any	optional
lane	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "gtin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "lane": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 25,
      "type": "integer"
    }
  },
  "required": [
    "market",
    "decision_id"
  ]
}

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.

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "decision_id"
  ]
}

log_audit

Write a line to the audit record for a gate decision, an order intent or a handoff (returns the line id).

Parameters3

kind	string	required
reference_id	string	required
note	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "reference_id": {
      "type": "string"
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "kind",
    "reference_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.

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "decision_id"
  ]
}

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).

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "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.

Parameters5

gtin	string	required
quantity	integer	required
decision_id	string	required
market	any	optional
ship_to	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "quantity": {
      "type": "integer"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ship_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "quantity",
    "decision_id"
  ]
}

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.

Parameters3

intent_id	any	optional
decision_id	any	optional
counterparty_card_url	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "counterparty_card_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}

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.

Parameters2

product_type	string	required
market	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "product_type": {
      "type": "string"
    },
    "market": {
      "type": "string"
    }
  },
  "required": [
    "product_type",
    "market"
  ]
}

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.

Parameters2

market	string	required
product_type	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

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.

Parameters3

market	any	optional
query	any	optional
since	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}

README.md5 KBView on GitHub

A2A Grocery — the agentic hub for retail grocery procurement

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) 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

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.

Install

Tools (19)

resolve_jurisdictionresolve_actorgate_transactionsearch_cleared_itemsget_itemverify_gtinget_label_and_claimscompare_items

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "a2a-grocery": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.a2a-grocery.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.greencore-solutions/a2a-grocery (MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

resolve_jurisdiction

resolve_actor

gate_transaction

search_cleared_items

get_item

verify_gtin

get_label_and_claims

compare_items

find_verified_buyer

find_verified_supplier

get_product_documents

log_audit

get_price

get_availability

create_order_intent

a2a_handoff

get_market_status

get_notification_requirements

get_enforcement_watch

A2A Grocery — the agentic hub for retail grocery procurement

The door

The twenty markets

The gate

The tools

Two worked prompts

Examples

Search words

Pay on it

Contact

Install

Remote endpoint

Related servers