Beacon - verified-merchant index for AI shopping agents
RemoteAbout Beacon - verified-merchant index for AI shopping agents
Beacon is an installable agent skill for AI shopping agents to find verified merchants, with a focus on regulated and age-gated commerce, starting with alcohol. Its results include evidence and provenance, and merchant ranking is not influenced by paid placement.
Key features
- 01Find verified merchants for shopping agents
- 02Evidence and provenance for results
- 03Rankings exclude paid placement
- 04License data from Florida public records
- 05Age and jurisdiction checks fail safe
Use cases
- 01Find merchants for regulated-product purchases
- 02Check whether a merchant can ship to a jurisdiction
- 03Audit evidence behind merchant results
MCP support
Beacon exposes its merchant index through an MCP endpoint for agents; a REST fallback is also available.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://beacon-index.onrender.com/mcpclaude mcp add --transport http primoliquors-beacon https://beacon-index.onrender.com/mcp{"mcpServers":{"primoliquors-beacon":{"type":"http","url":"https://beacon-index.onrender.com/mcp"}}}Open in Cursor{"servers":{"primoliquors-beacon":{"type":"http","url":"https://beacon-index.onrender.com/mcp"}}}Open in VS Code{"mcpServers":{"primoliquors-beacon":{"type":"http","url":"https://beacon-index.onrender.com/mcp"}}}{"mcpServers":{"primoliquors-beacon":{"serverUrl":"https://beacon-index.onrender.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
5| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| channel | any | No | |
| ship_to | any | No | |
| category | any | No | |
| dest_state | any | No | |
| ready_only | boolean | No | |
| optimize_for | string | No | |
| product_type | any | No | |
| require_age_gate | boolean | No |
Details
From the project READMEBeacon skill
The installable agent skill for Beacon — the neutral, verified-merchant index AI shopping agents query to find merchants they can safely and legally buy from, specializing in regulated/age-gated commerce (alcohol first).
npx skills add primoliquors/beacon-skill
Works across 70+ agents via the skills CLI.
What agents get
| Surface | Where |
|---|---|
| MCP (preferred) | https://beacon-index.onrender.com/mcp — registry name io.github.primoliquors/beacon |
| REST fallback | https://beacon-index.onrender.com/agent/* |
| Discovery manifest | https://beacon-index.onrender.com/.well-known/beacon (trust_class=regulated) |
Why Beacon is different
- Earned trust only. Paid placement never moves rank — enforced in code and
regression-tested, and every ranking response says so (
ranking_basis). - Evidence on every fact. Results carry provenance an agent can audit.
- Real compliance, not self-declaration. Merchant license attestations come from the State of Florida's daily public records (DBPR/AB&T); age-gate and jurisdiction rules fail safe (illegal ship-to returns zero, not a guess).
- No shopper data. Beacon stores no shopper-level identity, ever.
The skill definition lives in SKILL.md.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.