io.github.primoliquors/beacon

repo:https://github.com/primoliquors/beacon-skill

Neutral verified-merchant index for AI shopping agents; regulated/alcohol-first; earned-trust only.

transport:: remote
credential class:: open
repo:: https://github.com/primoliquors/beacon-skill

Owner verification

Not yet verified. Verifying proves you control this server and is free, permanently — it never changes a published score.

Start verification →

Tools

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, e.g. "US-FL". require_age_gate: only return merchants that enforce 21+. limit: max results. optimize_for: what matters to the BUYER -- "trust" (default), "price" (lowest matched price), or "speed" (same-day, then next-day fulfillment). Ties always break by earned trust. product_type/dest_state/channel: pass all three (e.g. "spirits", "FL", "ship"|"local_delivery") for STRICT COMPLIANCE mode -- only merchants with attested age-gate + attested license + a legal jurisdiction path are returned, each with its compliance verdict. Every result carries ships_to states (match them against where the buyer lives), best_price, and the evidence behind the record. Paid placement never affects any ranking (ranking_basis states the basis actually used).
shallow
get_merchant_view
Full agent view of one merchant: record + offerings + capabilities + evidence.
shallow
index_stats
Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.
shallow
search_offerings
Find offerings (products) matching a category, joined to merchant + capabilities.
shallow
verify_capability
Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.
shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/1f1b724f-73fc-4634-bee1-c0c681900427/badge.svg)](https://vouch.tools/servers/1f1b724f-73fc-4634-bee1-c0c681900427)