A2A Retailmedia — the agentic retail-media hub for grocery
io.github.greencore-solutionsv1.0.1Updated Oct 5, 2026
Connecting grocery retail to 350k makers for media buys.
Overview
Lets an assistant look up grocery retail-media banner cards, check eligibility, and submit or receive media-buy demand packets between makers and retailers.
- What it does
- A remote streamable-HTTP hub for grocery retail media. Tools are grouped as gate (resolve_jurisdiction, resolve_actor, gate_transaction), find (find_makers, resolve_gtin, check_eligibility, list_banners), cards (get_banner_card, list_banner_cards), packages (list_packages, quote_package, find_buyer), handshake (submit_demand, receive_demand, a2a_handoff), after (pull_measurement, renew_package, log_audit) and makers (enrol_maker). Reads are described as open; three gate calls are said to precede the handshake tools, and submit_demand takes a maker, an approved budget, a GTIN and a list of banners, or returns a gap naming what is missing.
- When to use it
- Use it when an assistant needs to research grocery retail-media programs across the listed markets, inspect a banner's signed card and its status, or move a media-buy demand packet between a maker's agent and a retailer's media agent.
- Requirements
- A remote endpoint at over streamable-HTTP; no package, environment variable or header is declared. The manifest declares no authentication, though the README describes a handshake that settles at the door via x402 and a retailer claim flow that signs in with Microsoft.
Installation
In SourceWeft
- Open A2A Retailmedia — the agentic retail-media hub for grocery in the dashboard and add it to a workspace.
- 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-retailmedia": {
"type": "http",
"url": "https://mcp.a2a-retailmedia.ai/mcp"
}
}
}README
A2A Retailmedia — the agentic retail-media hub for grocery
Connecting grocery retail to 350k makers for media buys. Not a broker, not AdWords, not a commission — the B2B agentic hub for grocery media with x402.
Connecting grocery retail to 350k makers for media buys. Not a broker, not AdWords, not a commission — the B2B agentic hub for grocery media with x402. A2A Retailmedia is operated by GreenCore Solutions Corp.: an Agent-to-Agent (A2A) hub with a Model Context Protocol (MCP) door for grocery retail media. The retailer is the seller of media and the maker's agent is the buyer. Every grocery banner in 20 markets has a signed card with a status — unclaimed, claimed or registered — that carries only what the banner itself publishes about its media program. GreenCore Solutions Corp. owns no inventory, runs no auction, makes no creative and quotes no price. Reads are open. Call resolve_jurisdiction, then resolve_actor, then gate_transaction before the handshake tools. submit_demand needs the maker, a budget a person has approved, a Global Trade Item Number (GTIN) and a list of banners, or it returns a gap. Artificial intelligence makes mistakes. A2A Retailmedia is an agentic information source, not a recommendation. No ads, ever. No rank for sale. Trade only.
A2A Retailmedia 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-retailmedia, door version 1.0.1, 19 tools (read from the wire)
- Endpoint:
https://mcp.a2a-retailmedia.ai/mcp— any client that speaks streamable-HTTP:{ "url": "https://mcp.a2a-retailmedia.ai/mcp", "transport": "streamable-http" } - Agent Card:
https://a2a-retailmedia.ai/.well-known/agent-card.json(EdDSA, kida2arm-2026-10; keyring/.well-known/jwks.json) - Docs: https://a2a-retailmedia.ai/docs · Text for agents: https://a2a-retailmedia.ai/llms.txt
- Official MCP Registry:
io.github.greencore-solutions/a2a-retailmedia(server.json in this repo)
The cards
Every grocery banner on the record has a signed card: https://a2a-retailmedia.ai/agents/{market}/{banner}.json, with a page at the same address without .json. The signed index is https://a2a-retailmedia.ai/agents/index.json.
- unclaimed — the banner is listed; a maker's agent is referred to the banner's public media program page, or to a person where none is listed.
- claimed — the retailer has signed in with Microsoft and verified its domain; demand is routed to its media team.
- registered — the retailer's own media agent is bound to the card.
A card carries the media program, the operator, what it sells and the public program page — each only as the banner's own page states it. Never a price, inventory or a rate card. Retailers claim a card from its page.
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.
The tools
- Gate —
resolve_jurisdiction,resolve_actor,gate_transaction - Find —
find_makers,resolve_gtin,check_eligibility,list_banners - Cards —
get_banner_card,list_banner_cards - Packages —
list_packages,quote_package,find_buyer - Handshake —
submit_demand,receive_demand,a2a_handoff - After —
pull_measurement,renew_package,log_audit - Makers —
enrol_maker
Reads are open. Three calls come before the handshake tools: resolve_jurisdiction → resolve_actor → gate_transaction. submit_demand takes the packet — the maker, a budget a person has approved, one or more Global Trade Item Numbers (GTIN), a market and a list of banners — or returns a gap naming what is missing.
Two worked prompts
Maker side — "Which grocery banners in the UK list a retail media program, and what does each say it sells?"
Retailer side — "Show me the card for my banner in France and tell me how to claim it."
Examples
Stock clients, no adapter: examples/aws_strands.py · examples/azure_semantic_kernel.py · examples/google_genai.py · examples/generic_mcp_client.py.
Settle on it
The handshake settles at the door: https://a2a-retailmedia.ai/api (x402, two accept entries; a refused handoff is not settled and not charged). GreenCore Solutions Corp. quotes no price for media.
Search words
retail media · grocery · retail media network · advertiser · maker · brand · banner · media program · agent card · claim · handshake · GTIN · x402 · AI agent · agent-to-agent · 20 markets · A2A Retailmedia · agentic hub
Contact
https://gsc-em.com/#contact — a person at GreenCore Solutions Corp. reads it.
Built and run by GreenCore Solutions Corp.. Artificial intelligence makes mistakes. A2A Retailmedia is an agentic information source, not a recommendation. No ads, ever. No rank for sale. Trade only.
Source: README.md at commit 9a4da0d
Tools
0Version history
1- v1.0.1LatestOct 5, 2026

