Research MCP

research-mcp

コーディング／リサーチエージェント向けの、有料の引用付きリサーチリモート MCP（API キー認証、OAuth ではありません）。

**料金を支払う理由：**許可リストに登録された一次情報から、クエリに紐づいた抜粋パックを提供します。引用できない場合は拒否され、その呼び出しは $0 です。前払いパック方式で、課金対象となる成功時のみメーターが計上されます。

リポジトリは非公開の場合があります。この README はエージェント向けの契約として扱ってください。稼働中の Fly ホストに変更はありません。

マーケティングサイト（Cloudflare Pages）

信頼できる唯一の情報源：research-mcp-hq/www（public/）。公開サイト：**https://researchmcp.dev**。

このリポジトリの www/ ツリーは、スタブ／ミラーノートのみです。Cloudflare Pages の参照先にしないでください。MCP API のオリジンは引き続き Fly 上にあり、ブランド付きのインストール URL は https://mcp.researchmcp.dev/mcp です。

MCP URL（本番環境）

https://mcp.researchmcp.dev/mcp

ヘルスチェック：https://mcp.researchmcp.dev/health
サーバーカード：https://mcp.researchmcp.dev/.well-known/mcp/server-card.json
クレジットメーター：GET https://mcp.researchmcp.dev/billing/credits（認証必須）

{
  "mcpServers": {
    "research-mcp": {
      "url": "https://mcp.researchmcp.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

認証

すべての /mcp および /billing/credits リクエストで、以下のいずれかを指定します。

• Authorization: Bearer <key> または
• X-API-Key: <key>

キー：前払い顧客キー（Checkout の成功ページから取得）、または緊急用の API_KEYS（運用用。台帳からの差し引きはありません）。

プライバシー（需要シグナル）

ログに記録するのはカテゴリ構成（ツール、トピックの分類、ホスト、課金対象か失敗＝$0 か）であり、質問は記録しません。サーバーで DEMAND_LOG=1 を指定するとオプトインとなり、デフォルトではオフです。

料金（確定）

パック	クレジット
$10 スターター	1000¢
$25 スタンダード	2500¢
$50 プロ	5000¢

メーター（課金対象の成功）	料金
ライト（source_lookup、research_brief の depth=quick）	$0.25
スタンダード（research_brief の depth=standard）	$0.60
ディープ（プレビューのみ）	公開メーターは $1.50。プレビューパスは常に $0

**失敗時は $0：**サンプル／デモ、見積もりゲートでの失敗、密度チェックでの失敗、COGS による中断、キャンセル、深度が一致しないゴールデンケース、プレビュー／保留中のパス（meta.billable=false、charge_usd=0）。

残高とテーブルを確認：GET /billing/credits → balance_cents、packs、meters_usd、fail_usd: 0。緊急用キーの場合は { break_glass: true, balance_cents: null } が返されます（偽の残高は表示されません）。

各ツールを呼び出すタイミング

稼働中（デフォルトの有料機能）

ツール	呼び出すタイミング	使用しない場面
research_brief	AI インフラ／MCP／セキュリティに関する、引用付きでクエリに紐づいた抜粋パックが必要な場合。depth=quick（$0.25）または depth=standard（$0.60）。	depth=deep は使用しないでください（プレビューフラグがない限り、保留中／サンプル専用です）。
source_lookup	取得または検証する URL か主張が1 つある場合。ライト $0.25。	オープンウェブ検索や複数ソースの統合には使用しないでください。

どちらも共通のエンベロープを返します：tldr、body、confidence、sources、gaps、as_of に加えて、schema_version（2026-09-14）。任意項目として fail_gate: { reason, retryable }、claims／抜粋、retrieved_at があります。source_url の引用検証に失敗した場合、その実行は拒否され、課金されません。

プレビュー／保留中（ENABLE_PREVIEW_TOOLS=1）

ツール／パス	動作
compare_options	フラグがある場合にのみ登録されます。常に $0／billable=false。稼働中のパスはありません。research_brief を優先してください。
depth=deep	フラグがある場合にのみ許可されます。常に $0。ソフトリザーブでディープ SKU の全額を要求することはありません。

フラグがない場合、compare_options は登録されず、depth=deep は拒否されます（preview_required）。ディレクトリのカードには、引き続き compare／deep を呼び出さないよう記載されています。

スタブ課金はありません。25 ツールの寄せ集めでもありません — デフォルトで稼働するツールは 2 つです。

公開されている契約

• スキーマ：docs/contract/schema.json
• 例：docs/contract/examples/happy-research-brief.json、fail-gate.json
• レスポンスの HTTP ヘッダー：X-Research-MCP-Schema-Version: 2026-09-14
• ツールの説明：docs/TOOLS.md

クイックスタート（ローカル）

cd /workspace/research-mcp
npm install && npm run build
API_KEYS=dev-key-1 npm start
# optional live brief path:
LIVE_RESEARCH=1 API_KEYS=dev-key-1 npm start

curl -s http://127.0.0.1:3000/health
curl -s -X POST http://127.0.0.1:3000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer dev-key-1' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

環境変数（重要度高）

変数	備考
API_KEYS	緊急時用のキー（カンマ区切り）
LIVE_RESEARCH=1	クイック／標準向けのライブ検索→抽出→統合→引用ゲート
ENABLE_PREVIEW_TOOLS=1	compare を登録し、deep を許可します（常に $0）
DATABASE_URL	顧客キー／クレジット用の SQLite 台帳
Stripe STRIPE_* / pack price IDs	プリペイドの Checkout（本番稼働まではテスト）

テスト

npm run eval:all      # goldens + off-golden + pipeline
npm run test:billing  # ledger / webhook / credits meter

構成

• src/server.ts — ツールの登録（完了または非表示）
• src/billing/credits.ts — GET /billing/credits（T10 の可視メーター）
• src/contract.ts — schema_version + fail_gate
• docs/contract/ — 公開済みの JSON Schema + 例
• ARCHITECTURE.md — トランスポート／認証／使用量計測

検出

サーフェス	URL / ID
GitHub	https://github.com/research-mcp-hq/research-mcp
Fly MCP	https://mcp.researchmcp.dev/mcp
Smithery（検出のみ）	https://smithery.ai/servers/research-mcp-hq/research-mcp

一覧掲載用のホームページ：https://researchmcp.dev。Smithery ではありません。

運用

RUNBOOK.md を参照してください。ライセンス：MIT。