Beacon - verified-merchant index for AI shopping agents

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• find_best_merchant

  Rank merchants that can actually fulfill a purchase need, by honest signals only. Args: category: product category, e.g. "vodka". ship_to: ISO region the order must ship to,

• search_offerings

  Find offerings (products) matching a category, joined to merchant + capabilities.

• verify_capability

  Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.

• get_merchant_view

  Full agent view of one merchant: record + offerings + capabilities + evidence.

• index_stats

  Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.