MCP Server: io.github.primoliquors/beacon

The io.github.primoliquors/beacon MCP server provides a neutral, verified-merchant index intended for AI shopping agents. Its focus is regulated, alcohol-first merchant discovery, and it emphasizes an “earned-trust only” approach. The goal is to support merchant lookup with trust constraints for shopping agent workflows.

🛠️ Key Features

Neutral verified-merchant index
Intended for AI shopping agents
Regulated/alcohol-first merchant focus
Earned-trust only inclusion policy

🚀 Use Cases

Merchant discovery for AI shopping agents
Shopping flows requiring regulated/alcohol-first merchants
Systems that must restrict results to “earned-trust only” merchants

⚡ Developer Benefits

Clear trust constraint: “earned-trust only”
Structured merchant indexing for agent-driven shopping
Neutral index intended to support consistent merchant sourcing

Beacon 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).

code

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.

category	any	optional
ship_to	any	optional
require_age_gate	boolean	optional
limit	integer	optional
optimize_for	string	optional
product_type	any	optional
dest_state	any	optional
channel	any	optional

category	any	optional
in_stock_only	boolean	optional
limit	integer	optional

merchant_id	string	required
capability	string	required

Beacon - verified-merchant index for AI shopping agents

MCP Server: io.github.primoliquors/beacon

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

find_best_merchant

search_offerings

verify_capability

get_merchant_view

index_stats

Beacon skill

What agents get

Why Beacon is different

Install

Remote endpoint