A2A Retailmedia — the agentic retail-media hub for grocery

Official19 tools

by greencore-solutions

Connecting grocery retail to 350k makers for media buys.

MCP Server: io.github.greencore-solutions/a2a-retailmedia

This MCP server connects grocery retail to 350k makers for media buys. It is identified by the slug io-github-greencore-solutions-a2a-retailmedia and described as facilitating media-buy connections between retail and makers. The provided metadata includes only name and description.

🛠️ Key Features

Connects grocery retail to 350k makers
Supports media buys via maker-retail connectivity

🚀 Use Cases

Coordinating grocery retail media buys with makers
Targeting and sourcing media inventory through maker connections

⚡ Developer Benefits

Clear integration scope focused on media buys between retail and makers

⚠️ Limitations

No additional fields were provided (e.g., topics, toolCount, readmeExcerpt), so capabilities and available tools cannot be determined from the provided data.

Captured live from the server via tools/list.

resolve_jurisdiction

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.

Parameters1

market

string

required

Raw schema

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

resolve_actor

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

Parameters1

actor_class

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "actor_class": {
      "type": "string"
    }
  },
  "required": [
    "actor_class"
  ],
  "additionalProperties": false
}

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.

Parameters2

market	string	required
actor_class	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "actor_class": {
      "type": "string"
    }
  },
  "required": [
    "market",
    "actor_class"
  ],
  "additionalProperties": false
}

find_makers

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.

Parameters4

segment	any	optional
region	any	optional
node	any	optional
limit	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "segment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "node": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

resolve_gtin

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.

Parameters1

gtin

string

required

Raw schema

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

check_eligibility

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.

Parameters3

gtin	string	required
banner	string	required
country_iso	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "banner": {
      "type": "string"
    },
    "country_iso": {
      "type": "string"
    }
  },
  "required": [
    "gtin",
    "banner",
    "country_iso"
  ],
  "additionalProperties": false
}

list_banners

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.

Parameters5

market	string	required
with_program	boolean	optional
search	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "with_program": {
      "default": false,
      "type": "boolean"
    },
    "search": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 100,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false
}

get_banner_card

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

Parameters2

market	string	required
banner	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "banner": {
      "type": "string"
    }
  },
  "required": [
    "market",
    "banner"
  ],
  "additionalProperties": false
}

list_banner_cards

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

Parameters4

market	string	required
status	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 200,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false
}

list_packages

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.

Parameters3

market	string	required
banner	string	required
decision_id	any	optional

Raw schema

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

quote_package

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.

Parameters3

market	string	required
banner	string	required
decision_id	any	optional

Raw schema

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

find_buyer

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

Parameters3

maker	string	required
market	any	optional
decision_id	any	optional

Raw schema

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

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.

Parameters9

maker	string	required
budget	number	required
budget_approved_by	string	required
gtins	array	required
market	string	required
banners	array	required
contact	string	required
decision_id	any	optional
note	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "maker": {
      "type": "string"
    },
    "budget": {
      "type": "number"
    },
    "budget_approved_by": {
      "type": "string"
    },
    "gtins": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "market": {
      "type": "string"
    },
    "banners": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "contact": {
      "type": "string"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "maker",
    "budget",
    "budget_approved_by",
    "gtins",
    "market",
    "banners",
    "contact"
  ],
  "additionalProperties": false
}

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.

Parameters4

market	string	required
banner	string	required
handoff_id	string	required
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "banner": {
      "type": "string"
    },
    "handoff_id": {
      "type": "string"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market",
    "banner",
    "handoff_id"
  ],
  "additionalProperties": false
}

a2a_handoff

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

Parameters1

handoff_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "handoff_id": {
      "type": "string"
    }
  },
  "required": [
    "handoff_id"
  ],
  "additionalProperties": false
}

pull_measurement

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.

Parameters1

handoff_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "handoff_id": {
      "type": "string"
    }
  },
  "required": [
    "handoff_id"
  ],
  "additionalProperties": false
}

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.

Parameters4

prior_quote_id	string	required
budget	number	required
budget_approved_by	string	required
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "prior_quote_id": {
      "type": "string"
    },
    "budget": {
      "type": "number"
    },
    "budget_approved_by": {
      "type": "string"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "prior_quote_id",
    "budget",
    "budget_approved_by"
  ],
  "additionalProperties": false
}

log_audit

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

Parameters2

event	string	required
detail	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string"
    },
    "detail": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "event"
  ],
  "additionalProperties": false
}

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.

Parameters4

maker	string	required
markets	array	required
media_exposure	boolean	required
contact	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "maker": {
      "type": "string"
    },
    "markets": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "media_exposure": {
      "type": "boolean"
    },
    "contact": {
      "type": "string"
    }
  },
  "required": [
    "maker",
    "markets",
    "media_exposure",
    "contact"
  ],
  "additionalProperties": false
}

README.md5 KBView on GitHub

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.2, 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, kid a2arm-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.

Install

Tools (19)

resolve_jurisdictionresolve_actorgate_transactionfind_makersresolve_gtincheck_eligibilitylist_bannersget_banner_card

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

MCP Server: io.github.greencore-solutions/a2a-retailmedia

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

resolve_jurisdiction

resolve_actor

gate_transaction

find_makers

resolve_gtin

check_eligibility

list_banners

get_banner_card

list_banner_cards

list_packages

quote_package

find_buyer

submit_demand

receive_demand

a2a_handoff

pull_measurement

renew_package

log_audit

enrol_maker

A2A Retailmedia — the agentic retail-media hub for grocery

The door

The cards

The twenty markets

The tools

Two worked prompts

Examples

Settle on it

Search words

Contact

Install

Remote endpoint

Related servers