# Beacon - verified-merchant index for AI shopping agents MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-primoliquors-beacon
- Repository: https://github.com/primoliquors/beacon-skill

## Install
- Endpoint: https://beacon-index.onrender.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://beacon-index.onrender.com/mcp

## 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).
     Endpoint: https://beacon-index.onrender.com/mcp
- search_offerings - Find offerings (products) matching a category, joined to merchant + capabilities. Endpoint: https://beacon-index.onrender.com/mcp
- verify_capability - Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL. Endpoint: https://beacon-index.onrender.com/mcp
- get_merchant_view - Full agent view of one merchant: record + offerings + capabilities + evidence. Endpoint: https://beacon-index.onrender.com/mcp
- index_stats - Graph coverage stats: counts of registry entries, merchants, offerings, capabilities. Endpoint: https://beacon-index.onrender.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.primoliquors
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io
