Asked Thrice

askedthrice-mcp

适用于 askedthrice.com 的 MCP 服务。让任何人的助手都能衡量买家向 AI 请求推荐时，某个品牌是否会出现。

托管于 https://mcp.askedthrice.com/mcp（可流式传输的 HTTP）。已在官方 MCP 注册表中列为 com.askedthrice/askedthrice。对于只能启动本地命令的客户端，可使用 npm 包 askedthrice-mcp 提供 stdio 桥接，位于 npm/ 中。

完整规范：私有 llm-rank-tracker 仓库中的 specs/features/geo-13-mcp-server.md。

安装

{"mcpServers":{"askedthrice":{"url":"https://mcp.askedthrice.com/mcp"}}}

或者，对于仅支持命令的客户端：

{"mcpServers":{"askedthrice":{"command":"npx","args":["-y","askedthrice-mcp"]}}}

提供的功能

• start_visibility_check 启动测量并返回 runId。
• get_visibility_check 获取测量结果。在服务商返回结果前，会返回 running。
• askedthrice://methodology 说明测量方法。

之所以提供两个工具而不是一个，是因为一次测量最多需要两分钟：审核需要 15 到 60 秒，测量地图还需要 15 到 60 秒。

返回内容及不返回的内容

它返回测量地图：实时提出的买家问题，以及每个答案由谁胜出。绝不返回服务商的自我报告，也就是每个模型对品牌的认知。实际情况中，这两个数字往往相差很大，而且自我报告总是更乐观；因此，工具契约不会在任何字段中公开它。

它绝不返回 0 到 100 的分数，而是给出三个等级的结论和计数。

费用

每次免费测量都会消耗 askedthrice 的 API 密钥，费用约为 0.05 到 0.15 美元。共有三道防护措施，均有测试覆盖：

1. 每个域名每 30 天可免费测量一次，并且会在调用 API 之前检查。
2. MCP_MONTHLY_RUN_LIMIT（默认值为 200）作为该渠道的上限，与 Web 漏斗预算分开计算。
3. 生产环境中的速率限制按客户端身份计数，而不是按此服务的 IP 计数，因为无服务器环境中的 IP 会轮换。

环境变量

变量	用途
LLMAUDIT_API_BASE_URL	API 基础 URL。默认为 https://askedthrice.com
MCP_SERVER_KEY	与 llm-rank-tracker 共用的密钥。未设置时，生产环境按 IP 进行分组
SUPABASE_URL / SUPABASE_SERVICE_ROLE_KEY	mcp_runs 表。未设置时，存储会保存在内存中，在无服务器环境中无法正常工作
MCP_MONTHLY_RUN_LIMIT	该渠道每月运行次数上限

渠道用量

npm run stats 会读取 mcp_runs，并报告月度上限剩余量、调用者、已测量的域名，以及目前持有 30 天配额的域名。

node --env-file <file.env> scripts/stats.mjs
node --env-file <file.env> scripts/stats.mjs --days 30 --history 180

需要 SUPABASE_URL（或 NEXT_PUBLIC_SUPABASE_URL）和 SUPABASE_SERVICE_ROLE_KEY。--days 用于指定每日明细，--history 用于指定回溯时间范围；始终会完整纳入当前月份，因为该数字必须与防护措施中的数字一致。

如果存在孤立运行记录，它们会最先显示：这些是已预留但从未获得 audit_id 的行。它们会一直向客户端返回“Unknown runId”，同时占用其域名的免费配额并计入月度上限。请按 run_id 删除这些记录。

Vercel Web Analytics 无法衡量此项：它通过向 HTML 注入脚本来工作，而这里没有 HTML，也没有可运行脚本的浏览器；每个请求都是来自 MCP 客户端的 JSON-RPC 调用。它永远只会读到零。

Docker（目录检查）

Dockerfile 会构建 HTTP 服务并在 0.0.0.0:3001 上提供服务，这是 Glama 和类似目录用于验证服务能否启动并响应内省请求的配置。端口和主机由 xmcp.config.ts 在构建时读取，因此它们必须作为 ENV 设置在 npm run build 之前，而不是在 docker run 时设置。未设置 SUPABASE_* 时，运行存储会保存在内存中：用于检查没问题，但不适合提供实际流量服务。

开发

npm run dev     # xmcp dev
npm test        # vitest, no network
npm run build   # xmcp build

测试使用 fixtures/ 中的真实样例（来自潜在客户挖掘、已付费的运行记录）。这些测试都不会访问网络或调用服务商。

发布新的注册表版本

server.json 使用 mcp-publisher，通过 askedthrice.com 上的 DNS 身份验证发布。密钥以 PEM 格式存储在仓库之外；CLI 需要原始 ed25519 种子的十六进制值：

HEX=$(openssl pkey -in <key.pem> -noout -text | sed -n '/^priv:/,/^pub:/p' | grep -v '^priv:\|^pub:' | tr -d ' :\n')
mcp-publisher login dns --domain askedthrice.com --private-key "$HEX"
mcp-publisher publish server.json

每次发布时都要更新 server.json 中的 version；注册表会拒绝重复版本。npm 包版本变更时，也要更新 packages[0].version。