Serveur MCP

Beacon - verified-merchant index for AI shopping agents

io.github.primoliquors/beacon
Commerce et retail Recherche et exploration Public et accessible MCP 2025-11-25

Ce que fait ce MCP

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

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).
Schéma d’entrée
{'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.
Schéma d’entrée
{'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.
Schéma d’entrée
{'type': 'object', 'title': 'index_statsArguments', 'properties': {}}
search_offerings
Find offerings (products) matching a category, joined to merchant + capabilities.
Schéma d’entrée
{'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}}}
Schéma de sortie
{'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.
Schéma d’entrée
{'type': 'object', 'title': 'verify_capabilityArguments', 'required': ['merchant_id', 'capability'], 'properties': {'capability': {'type': 'string', 'title': 'Capability'}, 'merchant_id': {'type': 'string', 'title': 'Merchant Id'}}}
Ajouté
index_stats
17 September 2026 12:49
Ajouté
get_merchant_view
17 September 2026 12:49
Ajouté
verify_capability
17 September 2026 12:49
Ajouté
search_offerings
17 September 2026 12:49
Ajouté
find_best_merchant
17 September 2026 12:49