MCP 서버

Beacon - verified-merchant index for AI shopping agents

io.github.primoliquors/beacon
커머스 및 리테일 검색 및 리서치 공개 · 연결 가능 MCP 2025-11-25

이 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).
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'type': 'object', 'title': 'index_statsArguments', 'properties': {}}
search_offerings
Find offerings (products) matching a category, joined to merchant + capabilities.
입력 스키마
{'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}}}
출력 스키마
{'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.
입력 스키마
{'type': 'object', 'title': 'verify_capabilityArguments', 'required': ['merchant_id', 'capability'], 'properties': {'capability': {'type': 'string', 'title': 'Capability'}, 'merchant_id': {'type': 'string', 'title': 'Merchant Id'}}}
추가됨
index_stats
2026년 9월 17일 12:49 PM
추가됨
get_merchant_view
2026년 9월 17일 12:49 PM
추가됨
verify_capability
2026년 9월 17일 12:49 PM
추가됨
search_offerings
2026년 9월 17일 12:49 PM
추가됨
find_best_merchant
2026년 9월 17일 12:49 PM