Asked Thrice

askedthrice-mcp

askedthrice.com 用の MCP サーバーです。誰でも、自分のアシスタントを使って、購入者が AI におすすめを尋ねたときにブランドが表示されるかどうかを測定できます。

https://mcp.askedthrice.com/mcp（ストリーミング可能な HTTP）でホストされています。公式 MCP レジストリには com.askedthrice/askedthrice として登録されています。ローカルコマンドの起動のみをサポートするクライアント向けの stdio ブリッジは、npm/ にある npm パッケージ askedthrice-mcp です。

完全な仕様は、非公開の 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 は測定方法を説明します。

測定には最大2分かかるため、ツールを1つではなく2つに分けています。監査に15～60秒、測定マップの作成にさらに15～60秒かかります。

返す内容と、返さない内容

返すのは測定マップです。実際に尋ねた購入者の質問と、それぞれの回答で勝ったブランドを示します。プロバイダーの自己申告、つまり各モデルがブランドについて信じている内容は返しません。実際にはこの2つの数値は大きく乖離し、自己申告のほうが常に楽観的です。そのため、ツールの契約ではどのフィールドにも自己申告を含めていません。

0～100のスコアは返しません。返すのは、3段階の判定と件数です。

費用

無料の測定を1回行うごとに、askedthrice の API キーを使い、約 0.05～0.15 米ドルの費用がかかります。テストでカバーされているガードは3つあります。

1. API を呼び出す前に、ドメインごとに30日間で1回までの無料測定かどうかを確認します。
2. MCP_MONTHLY_RUN_LIMIT（既定値は200）でチャネルの上限を設定します。ウェブファネルの予算とは別です。
3. 本番環境でのレート制限は、このサーバーの IP ではなくクライアント ID ごとにカウントします。サーバーレス環境では 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 呼び出しです。Vercel Web Analytics を使うと、いつまでもゼロのままになります。

Docker（ディレクトリのチェック）

Dockerfile は HTTP サーバーをビルドし、0.0.0.0:3001 で提供します。これは Glama などのディレクトリが、サーバーの起動とイントロスペクションへの応答を確認するために使用する設定です。ポートとホストはビルド時に xmcp.config.ts に読み込まれるため、docker run 時ではなく、npm run build より前に ENV として設定します。SUPABASE_* がない場合、実行ストアはメモリ上に作成されます。チェックには問題ありませんが、トラフィックの処理には適しません。

開発

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

テストでは fixtures/ にある実際のフィクスチャ（プロスペクティングで料金支払い済みの実行データ）を使用します。ネットワークには接続せず、プロバイダーも呼び出しません。

新しいレジストリバージョンの公開

server.json は、askedthrice.com の DNS 認証を使って mcp-publisher で公開します。キーはリポジトリの外部に PEM 形式で保存されており、CLI は ed25519 シードを 16 進数の生データで要求します。

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 も更新してください。