MCP Radar
MCP Server

Beacon - verified-merchant index for AI shopping agents

io.github.primoliquors/beacon
Commerce & Retail Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Indexes and verifies merchants, offerings, fulfillment capabilities, shipping regions, and age-gate evidence for shopping agents.

Capabilities

Tools

5 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).
Input schema 
{'type': 'object', 'title': 'find_best_merchantArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 5}, 'channel': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Channel', 'default': None}, 'ship_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ship To', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'dest_state': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Dest State', 'default': None}, 'ready_only': {'type': 'boolean', 'title': 'Ready Only', 'default': False}, 'optimize_for': {'type': 'string', 'title': 'Optimize For', 'default': 'trust'}, 'product_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Product Type', 'default': None}, 'require_age_gate': {'type': 'boolean', 'title': 'Require Age Gate', 'default': False}}}
get_merchant_view
Full agent view of one merchant: record + offerings + capabilities + evidence.
Input schema 
{'type': 'object', 'title': 'get_merchant_viewArguments', 'required': ['merchant_id'], 'properties': {'merchant_id': {'type': 'string', 'title': 'Merchant Id'}}}
index_stats
Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.
Input schema 
{'type': 'object', 'title': 'index_statsArguments', 'properties': {}}
search_offerings
Find offerings (products) matching a category, joined to merchant + capabilities.
Input schema 
{'type': 'object', 'title': 'search_offeringsArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 50}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'in_stock_only': {'type': 'boolean', 'title': 'In Stock Only', 'default': False}}}
Output schema 
{'type': 'object', 'title': 'search_offeringsOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Result'}}}
verify_capability
Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.
Input schema 
{'type': 'object', 'title': 'verify_capabilityArguments', 'required': ['merchant_id', 'capability'], 'properties': {'capability': {'type': 'string', 'title': 'Capability'}, 'merchant_id': {'type': 'string', 'title': 'Merchant Id'}}}
History

Recent tool changes

Added
index_stats
Sept. 17, 2026, 12:49 p.m.
Added
get_merchant_view
Sept. 17, 2026, 12:49 p.m.
Added
verify_capability
Sept. 17, 2026, 12:49 p.m.
Added
search_offerings
Sept. 17, 2026, 12:49 p.m.
Added
find_best_merchant
Sept. 17, 2026, 12:49 p.m.
Discover

Similar MCP servers

API Direct

io.apidirect/api-direct

Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…

Bonanza

io.github.pipeworx-io/bonanza

Searches active Bonanza marketplace listings and retrieves individual item details.

cyclesite-mcp-server

io.github.Tomalarrrr/cyclesite-mcp-server

Supports searching, comparing, valuing, buying, selling, reserving, and messaging about used bicycles on a UK marketplace.

MONO Social

io.github.junoventures/mono-juno-ventures

Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.

Campo Belo

io.github.junoventures/campobelo-sampa-br

Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.

Bom Retiro

io.github.junoventures/bomretiro-sampa-br

Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.

Bogeyland

io.github.junoventures/bogeyland-golf

Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.

Genesis Social

io.github.junoventures/genesis-social

Provides directory search and transactions for local places, events, restaurants, services, offers, bookings, and tickets.