Beacon - verified-merchant index for AI shopping agents
Neutral verified-merchant index for AI shopping agents; regulated/alcohol-first; earned-trust only.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"beacon": {
"url": "https://beacon-index.onrender.com/mcp"
}
}
}Remote endpoints
https://beacon-index.onrender.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢find_best_merchant(category, ship_to, require_age_gate, limit, optimize_for, ...)
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",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"ship_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ship To"
},
"require_age_gate": {
"default": false,
"title": "Require Age Gate",
"type": "boolean"
},
"limit": {
"default": 5,
"title": "Limit",
"type": "integer"
},
"optimize_for": {
"default": "trust",
"title": "Optimize For",
"type": "string"
},
"ready_only": {
"default": false,
"title": "Ready Only",
"type": "boolean"
},
"product_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Product Type"
},
"dest_state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dest State"
},
"channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Channel"
}
},
"title": "find_best_merchantArguments"
}🟢search_offerings(category, in_stock_only, limit)
Find offerings (products) matching a category, joined to merchant + capabilities.
Input Schema
{
"type": "object",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"in_stock_only": {
"default": false,
"title": "In Stock Only",
"type": "boolean"
},
"limit": {
"default": 50,
"title": "Limit",
"type": "integer"
}
},
"title": "search_offeringsArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"title": "search_offeringsOutput"
}⚪verify_capability(merchant_id, capability)
Verify a merchant capability with evidence, e.g. age_gate_21 or ships_to_US-FL.
Input Schema
{
"type": "object",
"properties": {
"merchant_id": {
"title": "Merchant Id",
"type": "string"
},
"capability": {
"title": "Capability",
"type": "string"
}
},
"required": [
"merchant_id",
"capability"
],
"title": "verify_capabilityArguments"
}🟢get_merchant_view(merchant_id)
Full agent view of one merchant: record + offerings + capabilities + evidence.
Input Schema
{
"type": "object",
"properties": {
"merchant_id": {
"title": "Merchant Id",
"type": "string"
}
},
"required": [
"merchant_id"
],
"title": "get_merchant_viewArguments"
}⚪index_stats
Graph coverage stats: counts of registry entries, merchants, offerings, capabilities.
Input Schema
{
"type": "object",
"properties": {},
"title": "index_statsArguments"
}Community
Evidence