A2A Retailmedia — the agentic retail-media hub for grocery

io.github.greencore-solutions/a2a-retailmedia

Connecting grocery retail to 350k makers for media buys.

Yes, your AI can use this right now.Answered a live MCP handshake in 663 ms with no sign-in needed and exposes 19 tools.

Connect it

Settings → Connectors → Add custom connector
URL: https://mcp.a2a-retailmedia.ai/mcp

19 tools, verified live

Pulled straight from the server with tools/list on 2026-10-17.
resolve_jurisdictionread-only

Where is the media bought? Resolve a market (e.g. FR, UK, US, Japan) to one of the 20 markets on the record. UK is the label; GB is accepted.

resolve_actorread-only

Who is asking? maker, brand_owner, agency, distributor or retailer_media_team (trade); auditor (read only). The consumer is never the counterparty.

gate_transaction

The gate before a handshake: allow or deny for one market and one actor class. Returns a decision_id the handshake tools ask for. A deny is not charged.

find_makersread-only

Find the brand: makers on the grocery record of one market (node = one of the 20 markets). segment is taken as a lane where it names one (organic, free-from, plant-based, artisan, origin, premium). Read live from the A2A Grocery door.

resolve_gtinread-only

Product record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability. Confirm the product is real: is this Global Trade Item Number (GTIN) well-formed, and is it on the grocery record, with its brand and maker. Read live from the A2A Grocery door.

check_eligibilityread-only

Confirm it is on the shelf: does the grocery record list this GTIN at this banner in this market? No listing, no media pitch. Read live from the A2A Grocery door.

list_bannersread-only

Pick the banners: the grocery banners of one market with each one's media program (or "none listed") and card status. with_program=true returns only banners with a program listed.

get_banner_cardread-only

The signed card of one banner and its status (unclaimed, claimed or registered). banner = the banner's slug, id or name.

list_banner_cardsread-only

The cards of one market, optionally by status (unclaimed, claimed, registered): banner, media program, status and the card's address.

list_packagesread-only

Match a package: what one banner's media program says it sells, in the program's own words, each tagged onsite, offsite or in-store. Offsite is tagged so it is never taken for a shelf slot. Empty where no program is listed — the agent stops.

quote_packageread-only

Price it: returns where the banner's own media program publishes its rates or takes an enquiry. GSC never prices; a quote comes from the retailer's program.

find_buyerread-only

Qualify the buyer: find a maker on the grocery record by name, with its own website where the record has one.

submit_demand

Hand off: the packet — the maker, a budget a person has approved, one or more GTINs, a market and a list of banners — or a gap naming what is missing. Routes each banner by its card status: unclaimed is a referral, claimed goes to the retailer's media team, registered goes agent to agent. Settles at the door.

receive_demand

Retailer side: a registered program agent takes a qualified packet. Only a card in the registered state can receive; any other card is refused and nothing is charged.

a2a_handoffread-only

Hand to a person: the state of a handoff and its Navigator desk ticket, where the media program has no agent.

pull_measurementread-only

Read the till: results of a campaign, returned by the retailer's program. Available only after the program returns a campaign id for a handoff.

renew_package

Renew: a prior quote id from the retailer's program and a new approved budget. Without a quote id from the program there is nothing to renew.

log_audit

Write one audit line for a step of the chain; returns its id.

enrol_maker

Makers: be seen. Enrol a maker for media exposure in grocery: its name, its markets (one or more of the 20), the tick, and a contact a person can answer. Enrolment only — a handoff waits for a budget a person has approved.

Alternatives in Developer Tools

Compare →
Try “Notion”, “Stripe”, “create invoice”, “browser”