Skip to content

A2A Retailmedia — the agentic retail-media hub for grocery

by greencore-solutions · remote · no sign-in to list tools · v1.0.2 · published by GitHub user greencore-solutions

Connecting grocery retail to 350k makers for media buys.

Changes · 9

19 tools: 9 change things and 10 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http a2a-retailmedia https://mcp.a2a-retailmedia.ai/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Changes things 9Claude Code: ask
  • a2a_handoffHand to a person: the state of a handoff and its Navigator desk ticket, where the media program has no agent.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Hand to a person: the state of a handoff and its Navigator desk ticket, where the media program has no agent.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • check_eligibilityConfirm it is on the shelf: does the grocery record list this GTIN at this banner in this market?No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • enrol_makerMakers: be seen.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
  • gate_transactionThe gate before a handshake: allow or deny for one market and one actor class.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
  • log_auditWrite one audit line for a step of the chain; returns its id.No findings

    Why it is in this group

    • The name "log_audit" says "log": a word for reading.
    • The description's first verb is "write": a word for a change.
    Description, as the server wrote it
    Write one audit line for a step of the chain; returns its id.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
  • quote_packagePrice it: returns where the banner's own media program publishes its rates or takes an enquiry.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • receive_demandRetailer side: a registered program agent takes a qualified packet.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
  • renew_packageRenew: a prior quote id from the retailer's program and a new approved budget.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
  • submit_demandHand 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.No findings

    Why it is in this group

    • The name "submit_demand" says "submit": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
    • readOnlyHint: false
Only reads 10Claude Code: allow
  • find_buyerQualify the buyer: find a maker on the grocery record by name, with its own website where the record has one.No findings

    Why it is in this group

    • The name "find_buyer" says "find": a word for reading.
    Description, as the server wrote it
    Qualify the buyer: find a maker on the grocery record by name, with its own website where the record has one.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • find_makersFind the brand: makers on the grocery record of one market (node = one of the 20 markets).No findings

    Why it is in this group

    • The name "find_makers" says "find": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • get_banner_cardThe signed card of one banner and its status (listed · claimed · verified).No findings

    Why it is in this group

    • The name "get_banner_card" says "get": a word for reading.
    Description, as the server wrote it
    The signed card of one banner and its status (listed · claimed · verified). banner = the banner's slug, id or name.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • list_banner_cardsThe cards of one market, optionally by status (unclaimed, claimed, registered): banner, media program, status and the card's address.No findings

    Why it is in this group

    • The name "list_banner_cards" says "list": a word for reading.
    Description, as the server wrote it
    The cards of one market, optionally by status (unclaimed, claimed, registered): banner, media program, status and the card's address.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • list_bannersPick the banners: the grocery banners of one market with each one's media program (or "none listed") and card status.No findings

    Why it is in this group

    • The name "list_banners" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • list_packagesMatch a package: what one banner's media program says it sells, in the program's own words, each tagged onsite, offsite or in-store.No findings

    Why it is in this group

    • The name "list_packages" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • pull_measurementRead the till: results of a campaign, returned by the retailer's program.No findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • resolve_actorWho is asking?No findings

    Why it is in this group

    • The name "resolve_actor" says "resolve": a word for reading.
    Description, as the server wrote it
    Who is asking? maker, brand_owner, agency, distributor or retailer_media_team (trade); auditor (read only). The consumer is never the counterparty.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • resolve_gtinProduct record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability.No findings

    Why it is in this group

    • The name "resolve_gtin" says "resolve": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true
  • resolve_jurisdictionWhere is the media bought?No findings

    Why it is in this group

    • The name "resolve_jurisdiction" says "resolve": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.2. Values in angle brackets are yours to fill in.

claude mcp add --transport http a2a-retailmedia https://mcp.a2a-retailmedia.ai/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__a2a-retailmedia__resolve_jurisdiction",
      "mcp__a2a-retailmedia__resolve_actor",
      "mcp__a2a-retailmedia__find_makers",
      "mcp__a2a-retailmedia__resolve_gtin",
      "mcp__a2a-retailmedia__list_banners",
      "mcp__a2a-retailmedia__get_banner_card",
      "mcp__a2a-retailmedia__list_banner_cards",
      "mcp__a2a-retailmedia__list_packages",
      "mcp__a2a-retailmedia__find_buyer",
      "mcp__a2a-retailmedia__pull_measurement"
    ],
    "ask": [
      "mcp__a2a-retailmedia__gate_transaction",
      "mcp__a2a-retailmedia__check_eligibility",
      "mcp__a2a-retailmedia__quote_package",
      "mcp__a2a-retailmedia__submit_demand",
      "mcp__a2a-retailmedia__receive_demand",
      "mcp__a2a-retailmedia__a2a_handoff",
      "mcp__a2a-retailmedia__renew_package",
      "mcp__a2a-retailmedia__log_audit",
      "mcp__a2a-retailmedia__enrol_maker"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as a2a-retailmedia. Review it before you use it.