Servers Playground How we check Add a server Log in

A2A Retailmedia — the agentic retail-media hub for grocery

Working · 906 ms

io.github.greencore-solutions/a2a-retailmediav1.0.2

Connecting grocery retail to 350k makers for media buys.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

a2a_handoff Read-only

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

handoff_idstring, required

A2A Retailmedia — the agentic retail-media hub for grocery MCP server | mcptry

Tools (19)

a2a_handoff

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

read-only

Argument	Type	Description
handoff_id*	string

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
gtin*	string
banner*	string
country_iso*	string

Input schema (JSON)

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

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.

Argument	Type	Description
maker*	string
contact*	string
markets*	array
media_exposure*	boolean

Input schema (JSON)

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

find_buyer

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

read-only

Argument	Type	Description
maker*	string
market	any
decision_id	any

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
node	any
limit	any
region	any
segment	any

Input schema (JSON)

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

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.

Argument	Type	Description
market*	string
actor_class*	string

Input schema (JSON)

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

get_banner_card

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

read-only

Argument	Type	Description
banner*	string
market*	string

Input schema (JSON)

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

list_banner_cards

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

read-only

Argument	Type	Description
limit	integer
market*	string
offset	integer
status	any

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
limit	integer
market*	string
offset	integer
search	any
with_program	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "market"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100
    },
    "market": {
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0
    },
    "search": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "with_program": {
      "type": "boolean",
      "default": 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.

read-only

Argument	Type	Description
banner*	string
market*	string
decision_id	any

Input schema (JSON)

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

log_audit

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

Argument	Type	Description
event*	string
detail	any

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
handoff_id*	string

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
banner*	string
market*	string
decision_id	any

Input schema (JSON)

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

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.

Argument	Type	Description
banner*	string
market*	string
handoff_id*	string
decision_id	any

Input schema (JSON)

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

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.

Argument	Type	Description
budget*	number
decision_id	any
prior_quote_id*	string
budget_approved_by*	string

Input schema (JSON)

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

resolve_actor

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

read-only

Argument	Type	Description
actor_class*	string

Input schema (JSON)

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

resolve_gtin

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.

read-only

Argument	Type	Description
gtin*	string

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
market*	string

Input schema (JSON)

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

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.

Argument	Type	Description
note	any
gtins*	array
maker*	string
budget*	number
market*	string
banners*	array
contact*	string
decision_id	any
budget_approved_by*	string

Input schema (JSON)

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