Beacon - verified-merchant index for AI shopping agents

io.github.primoliquorsPublished by GitHub account primoliquorsv0.1.0Updated Oct 24, 2026

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

The publisher's own server: RealGeeks Company Registry

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Remote index of verified merchants for AI shopping agents, focused on regulated and age-gated commerce such as alcohol.

What you can do
  • Rank merchants that can fulfill a purchase need by category, ship-to region, age-gate requirement and optimization goal
  • Search offerings (products) in a category, joined to merchant and capability data
  • Verify a merchant capability such as a 21+ age gate or shipping to a given region, with supporting evidence
  • Retrieve a full agent view of one merchant: record, offerings, capabilities and evidence
  • Read graph coverage statistics for registry entries, merchants, offerings and capabilities
When to use it
Useful when an assistant helps a user buy regulated or age-gated goods and needs to shortlist merchants that can legally ship to a region and enforce age gates, with auditable evidence rather than self-declared claims.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or header is declared. Network access to the hosted service is required.
Before you install
The index is read-only lookup and ranking; actual purchases happen elsewhere. Merchant trust and license attestations come from a third-party public records source and should be treated as evidence to audit, not a guarantee. Ranking responses state their basis, so check it rather than assuming neutrality.

Installation

In SourceWeft

  1. Open Beacon - verified-merchant index for AI shopping agents in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.primoliquors%2Fbeacon/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "beacon-verified-merchant-index-for-ai-sh": {
      "type": "http",
      "url": "https://beacon-index.onrender.com/mcp"
    }
  }
}

README

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

npx skills add primoliquors/beacon-skill

Works across 70+ agents via the skills CLI.

What agents get

SurfaceWhere
MCP (preferred)https://beacon-index.onrender.com/mcp — registry name io.github.primoliquors/beacon
REST fallbackhttps://beacon-index.onrender.com/agent/*
Discovery manifesthttps://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.

Source: README.md at commit 841dfcf

Tools

5

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

Parameterslimitchannelship_tocategorydest_stateready_onlyoptimize_forproduct_typerequire_age_gate

search_offerings

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

Parameterslimitcategoryin_stock_only

verify_capability

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

Parameterscapabilityrequiredmerchant_idrequired

get_merchant_view

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

Parametersmerchant_idrequired

index_stats

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

Takes no parameters.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Beacon integrations

RealGeeks Company Registry

host.beacon.worker.realgeeks-company-apiOfficial publisher

Remote MCP server for searching official company registers in France, Norway, Finland and US SEC EDGAR, and looking up a company by its registry ID.

Streamable HTTPWeb executable
Finance2 toolsNov 5, 2026

Eclipse Beacon MCP

Published by GitHub account CYAN-ECLIPSE-TECHNOLOGIES-LLC

Local MCP server that builds a household insurance policy graph from local files and reports upcoming expiries, renewals and coverage gaps.

STDIODesktop only
Productivity & WorkflowNot validated yetOct 29, 2026

BEACON Commons

Published by GitHub account babakovn

A remote MCP endpoint for BEACON Commons that lets an assistant browse public tasks, reproducible results, peer reports and discussion threads, and publish its

Streamable HTTPWeb executable
Productivity & Workflow16 toolsOct 24, 2026

Nist Beacon

Published by GitHub account pipeworx-io

Nist Beacon's hosted MCP server; no sign-in required; Streamable HTTP; 49 tools.

Streamable HTTPWeb executable
Security & Monitoring49 toolsNov 4, 2026

SkillFM Beacon

Published by GitHub account ericm1018

A local MCP launcher that reports AI health, token usage and LLM spend, suggests cost savings, and audits agent clutter.

STDIODesktop only
Security & MonitoringNot validated yetOct 24, 2026