io.github.greencore-solutions/a2a-retailmedia

A2A Retailmedia — the agentic retail-media hub for grocery

Connecting grocery retail to 350k makers for media buys.

1.0.2
Version
remote
Transport
19
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 19 tools scanned
  • metadata: scanned

No findings.

Tools (19)

  • 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.

  • resolve_actor

    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_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.

  • 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.

  • 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.

  • 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.

  • get_banner_card

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

  • list_banner_cards

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

  • 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.

  • 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.

  • find_buyer

    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_handoff

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

  • 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.

  • 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.