Connecting grocery retail to 350k makers for media buys.
Scored across 19 tools
Most tools map to a distinct step (resolve_actor, resolve_jurisdiction, resolve_gtin, check_eligibility, gate_transaction), but several pairs overlap: list_banners and list_banner_cards both return per-banner card status for a market, find_buyer and find_makers are both 'find a maker' lookups, and a2a_handoff sits close to submit_demand in the handoff space. The verbose descriptions do steer an agent to the right one, so the boundaries exist, but they require careful reading rather than being self-evident.
Nearly all tools follow a snake_case verb_noun pattern (list_banners, get_banner_card, quote_package, submit_demand, receive_demand, log_audit). The one deviation is a2a_handoff, which uses a server prefix plus a bare noun with no verb, and there is minor singular/plural drift (find_buyer vs find_makers). Otherwise highly predictable.
19 tools is on the heavy side of the 3-15 sweet spot, but the domain is genuinely multi-stage and multi-actor (identity, jurisdiction, GTIN resolution, discovery, pricing, gating, demand routing, measurement, renewal, audit), and each tool corresponds to a step in that chain. A couple of pairs (list_banners/list_banner_cards, find_buyer/find_makers) could plausibly be merged.
The surface covers the full chain end to end: actor and market resolution, product verification, shelf eligibility, banner and package discovery, quoting, transaction gating, demand submission and receipt, measurement pull, renewal, enrolment, audit logging and human handoff. Gaps are minor — there is no explicit withdraw/cancel of a submitted demand and no 'list my submissions/campaigns' status tool, which could leave an agent without a follow-up path after submit_demand.
Hand to a person: the state of a handoff and its Navigator desk ticket, where the media program has no agent.
Inputs: handoff_id (required). Returns: object
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.
Inputs: gtin (required), banner (required), country_iso (required). Returns: object
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.
Inputs: maker (required), contact (required), markets (required), media_exposure (required). Returns: object
Qualify the buyer: find a maker on the grocery record by name, with its own website where the record has one.
Inputs: maker (required), market, decision_id. Returns: object
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.
Inputs: node, limit, region, segment. Returns: object
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.
Inputs: market (required), actor_class (required). Returns: object
The signed card of one banner and its status (listed · claimed · verified). banner = the banner's slug, id or name.
Inputs: banner (required), market (required). Returns: object
The cards of one market, optionally by status (unclaimed, claimed, registered): banner, media program, status and the card's address.
Inputs: market (required), limit, offset, status. Returns: object
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.
Inputs: market (required), limit, offset, search, +1 more. Returns: object
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.
Inputs: banner (required), market (required), decision_id. Returns: object
Write one audit line for a step of the chain; returns its id.
Inputs: event (required), detail. Returns: object
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.
Inputs: handoff_id (required). Returns: object
Price it: returns where the banner's own media program publishes its rates or takes an enquiry. wefetch never prices; a quote comes from the retailer's program.
Inputs: banner (required), market (required), decision_id. Returns: object
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.
Inputs: banner (required), market (required), handoff_id (required), decision_id. Returns: object
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.
Inputs: budget (required), prior_quote_id (required), budget_approved_by (required), decision_id. Returns: object
Who is asking? maker, brand_owner, agency, distributor or retailer_media_team (trade); auditor (read only). The consumer is never the counterparty.
Inputs: actor_class (required). Returns: object
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.
Inputs: gtin (required). Returns: object
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.
Inputs: market (required). Returns: object
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.
Inputs: gtins (required), maker (required), budget (required), market (required), +5 more. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Verified commerce data and proof-backed shopper activation tools for agents.
Plan, run, and understand advertising across sellers from one connected place.
Search direct grocery storefronts and create product-link pickup handoffs.
A2A + MCP hub for retail grocery procurement — 20 markets on the SCHEMA algo record. Trade only.
Add one secure layer between your agents and this server.
