Skip to content

Beacon - verified-merchant index for AI shopping agents

by primoliquors · remote · no sign-in to list tools · v0.1.0 · published by GitHub user primoliquors

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

Changes · 2
CompareRegistry entry

5 tools: 2 change things and 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http beacon https://beacon-index.onrender.com/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

5 tools

Changes things 2Claude Code: ask
  • index_statsGraph coverage stats: counts of registry entries, merchants, offerings, capabilities.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.
  • verify_capabilityVerify a merchant capability with evidence, e.g.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.
Only reads 3Claude Code: allow
  • find_best_merchantRank merchants that can actually fulfill a purchase need, by honest signals only.No findings

    Why it is in this group

    • The name "find_best_merchant" says "find": a word for reading.
    Description, as the server wrote it
    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).
  • get_merchant_viewFull agent view of one merchant: record + offerings + capabilities + evidence.No findings

    Why it is in this group

    • The name "get_merchant_view" says "get": a word for reading.
    Description, as the server wrote it
    Full agent view of one merchant: record + offerings + capabilities + evidence.
  • search_offeringsFind offerings (products) matching a category, joined to merchant + capabilities.No findings

    Why it is in this group

    • The name "search_offerings" says "search": a word for reading.
    Description, as the server wrote it
    Find offerings (products) matching a category, joined to merchant + capabilities.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http beacon https://beacon-index.onrender.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__beacon__find_best_merchant",
      "mcp__beacon__search_offerings",
      "mcp__beacon__get_merchant_view"
    ],
    "ask": [
      "mcp__beacon__verify_capability",
      "mcp__beacon__index_stats"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as beacon. Review it before you use it.