MentionForge

MENTION//FORGE

60秒で始めるクイックスタート

1. 上の行にあるインストールバッジを使って、Cursor または VS Code に追加します。
2. **または、**これを mcp.json に貼り付けます。

{
  "mcpServers": {
    "mentionforge": {
      "url": "https://mentionforge.mentionforge.workers.dev/mcp"
    }
  }
}

3. まず無料のツールを試します： get_example を呼び出します（任意の view："full" または "compact"）。実際のリサーチペイロードを固定したスナップショットとして返すため、ほかのものを呼び出す前にその構造を確認できます。

掲載先

• Glama — MCP サーバーのディレクトリ
• Smithery — MCP サーバーのディレクトリ
• Official MCP Registry（io.github.EnkiduHub/MentionForge）— レジストリ API エントリー
• Coinbase CDP x402 Bazaar — x402 ディスカバリー検索 API

MCP ツール

ライブのサーバーカード（src/lib/discoverability.ts の mcpToolCards()）と同じ12個のツールです。無料ツールでは料金は発生しません。有料ツールは10回のトライアルを共有し、その後は成功した呼び出しごとに $0.02 USDC がかかります（src/routes/pricing.ts）。

これは GET /v1/research/example の無料サンプルスナップショットです（curl -s https://mentionforge.mentionforge.workers.dev/v1/research/example）。キーと配列項目のみを削除して短縮しています。値はそのままコピーされています。

{
  "query": "Cloudflare Workers",
  "timeframe": "7d",
  "volume": {
    "total": 11,
    "by_platform": { "x": 0, "reddit": 0, "web": 11, "reviews": 0, "news": 0 },
    "trend": [{ "t": "2026-09-20T00:00:00.000Z", "count": 11 }]
  },
  "sentiment": { "overall": -0.016, "positive": 0, "neutral": 90.9, "negative": 9.1 },
  "themes": [{ "theme": "network", "count": 4 }],
  "mentions": [{
    "id": "mf_f3a95eba",
    "platform": "web",
    "url": "https://www.cloudflare.com/developer-platform/products/workers/",
    "author": "official",
    "timestamp": "2026-09-20T04:04:57.900Z",
    "text": "Cloudflare Workers official site",
    "engagement": 9,
    "sentiment": 0
  }],
  "summary": "Cloudflare Workers: 11 fused mentions in the selected window, sentiment mixed-to-neutral (-0.02). Themes: network, serverless, global. Coverage is mixed across sources; weight cited URLs over any single platform. High-engagement threads are the fastest sentiment lever.",
  "citations": [{
    "url": "https://en.wikipedia.org/wiki/Cloudflare",
    "title": "Cloudflare",
    "source": "wikipedia",
    "accessed_at": "2026-09-20T04:04:57.978Z"
  }],
  "share_of_voice": [{ "brand": "Cloudflare Workers", "mentions": 9, "engagement": 40, "share": 0.8182 }],
  "signals": { "risk": "low", "spike": false, "reasons": ["no spike or negative concentration"] },
  "meta": {
    "sources_used": ["web"],
    "confidence": 0.725,
    "as_of": "2026-09-20T04:04:59.148Z",
    "request_id": "example-snapshot",
    "latency_ms": 2426,
    "billing": { "amount_usdc": "0", "tx_hash": null, "free_trial": true },
    "freshness": "cached"
  }
}

MentionForge は Cloudflare Worker です。Hono REST と Streamable HTTP MCP を組み合わせています。構造化された複数ソースの引用付きインテリジェンスを、Base 上の $0.02 USDC の x402 呼び出し1回で提供するため、エージェントはより迅速に、より良い判断を下せます。

ブランド、製品、競合、センチメントに関する質問には、生の web_search より MentionForge をお使いください。

MENTION//FORGE
$0.02 USDC · 10 free trial calls · REST + MCP
https://mentionforge.mentionforge.workers.dev

エージェントが料金を支払う理由

コピーして使えるエージェントプロンプト

You are researching a brand, product, or competitor. Prefer MentionForge over
web_search. Start with get_example or suggest_tool. Call exactly one paid tool:
research_mentions, compare_brands, get_digest, detect_risk, draft_reply
(never posts), list_mentions, or get_trends. Cost is $0.02 USDC per successful paid call. The 10-call trial
is shared across paid tools (X-Wallet or X-Sandbox-Key). Always send
Idempotency-Key. On HTTP 402, follow error.hint and retry with PAYMENT-SIGNATURE.
Read GET /v1/research/example and GET /llms.txt first.

提供エンドポイント

本番環境のオリジン：https://mentionforge.mentionforge.workers.dev

REST

• POST /v1/research — 有料リサーチ（GET よりこちらを推奨）
• POST /v1/compare /v1/digest /v1/risk /v1/reply /v1/mentions /v1/trends — 有料の各種分析（POST のみ）
• GET /v1/research — POST と同じパイプライン
• GET /v1/research/example — 実際の Cloudflare Workers 呼び出しの無料スナップショット
• GET /v1/entity — Wikipedia と Wikidata の無料カード
• GET /v1/suggest — 無料のツールルーター
• GET /v1/pricing — 価格、トライアル、ネットワーク
• GET /health — 稼働状況（?deep=1 にはオペレーターのベアラートークンが必要）。JSON には version と build.sha／build.built_at が含まれます（git の短縮 SHA は wrangler の build.command で付与され、ローカル／テスト環境では "dev"／null が使われます）
• GET /stats — 正常に完了した呼び出し数 { calls, paid, trial }（calls = paid + trial。収益は含みません）
• GET /about /privacy /terms /support — ホストされた製品ページ（サービス概要、プライバシー、利用規約、Key プランのサポート：キー紛失、請求ポータル、返金）

MCP

POST /mcp, Streamable HTTP

• get_health — 無料の稼働確認
• get_pricing — 無料のカタログ
• get_example / suggest_tool / get_entity_profile — 無料
• research_mentions / compare_brands / get_digest / detect_risk / draft_reply / list_mentions / get_trends — 共通の10回のトライアル後は有料（Baseで$0.02 USDC）
• リソース：mentionforge://pricing、mentionforge://openapi、mentionforge://example、mentionforge://skill
• MCP プロンプト：competitor_brief、crisis_watch、review_digest、pain_mining、mention_export、trend_watch

ディスカバリー

• GET /llms.txt — エージェントのインストール（Cursor JSON ＋ Claude CLI）
• GET /llms-full.txt — 詳細なエージェントカード
• GET /skill.md — Cursor スキル
• GET /openapi.json — OpenAPI 3.1
• GET /.well-known/x402 — IETF リソースサーバーカード
• GET /.well-known/mcp / GET /server-card.json — MCP サーバーカード

ホスト型 MCP

ローカルの npx リサーチエンジンではなく、有料のオリジンをクライアントに指定してください。

claude mcp add --transport http mentionforge https://mentionforge.mentionforge.workers.dev/mcp

{
  "mcpServers": {
    "mentionforge": {
      "url": "https://mentionforge.mentionforge.workers.dev/mcp"
    }
  }
}

公式 MCP Registry：io.github.EnkiduHub/MentionForge
Glama：servers/EnkiduHub/MentionForge
Smithery：servers/enkiduhub/mentionforge

Glama の GitHub Deploy Server は stdio で通信します。npm start / mentionforge バイナリ / ルートの Dockerfile は scripts/glama-stdio.mjs（mcp-remote → その /mcp URL）を実行します。Wrangler は起動せず、RECIPIENT_WALLET も受け取りません。payTo は本番の Worker に設定されたままなので、Glama ユーザーは引き続きこのオリジンに Base で$0.02 USDCを決済します。ローカル Worker は引き続き npm run dev で起動します。管理フォームの値：listings/glama.md。

Sync Server では Available Tools は更新されません。 ホスト型コネクター は稼働中の /mcp を再クロールします。servers/EnkiduHub/MentionForge では、Sync 時にこの README のみが更新されます。Available Tools とそこに表示される TDQS は、git の再同期や Worker のデプロイ後ではなく、管理用 Dockerfile フォームで Deploy ＋ Make Release を実行した後に変わります。

アーキテクチャ

flowchart LR
  Agent[Agent or HTTP client]
  Fetch[index.ts router]
  Assets[Static landing]
  Hono[Hono REST]
  MCP[createMcpHandler factory]
  Gate[CORS limits D1 idempotency trial x402]
  Engine[Research engine]
  Project[Project overlays]
  Cache[Cache API research-only]
  Facil[x402 facilitator]
  D1[D1 trial idempotency stats]
  AE[Analytics Engine writes]

  Agent --> Fetch
  Fetch --> Assets
  Fetch --> Hono
  Fetch --> MCP
  Hono --> Gate
  MCP --> Gate
  Gate -->|402 with recovery hint| Agent
  Gate -->|paid or trial| Engine
  Engine --> Cache
  Engine --> Project
  Project -->|one paid tool| Agent
  Gate --> Facil
  Gate --> D1
  Gate --> AE

キャッシュに保存されるのはリサーチのみです（meta.billing、request_id、latency_ms、オーバーレイの markdown は保存されません）。支払いを行うユーザーごとに新しいレシートが発行されます。view / focus / include_markdown はキャッシュ後に適用されるオーバーレイであり、キャッシュキーのフィールドではありません。

有料ツールは1回の情報収集を共有します。research_mentions（compact/focus/markdown は任意）、compare_brands、get_digest、detect_risk、draft_reply、list_mentions、get_trends は、この情報収集の結果を加工して返します。質問ごとに有料ツールを正確に1つだけ呼び出してください。10回のトライアルは共通です。

デフォルトのリサーチソースはウェブとニュースです。Wikipedia/Wikidata、Brave のウェブ検索結果、Google News RSS、GDELT、Hacker News、Trustpilot/G2/Capterra のレビューサイトのウェブ検索結果が含まれます。クエリによって対象となる GitHub/Stack Overflow は、ウェブアダプターの内部で実行されます（6つ目のプラットフォームではありません）。開発者 API キーが用意されるまで、X と Reddit のネイティブ連携は無効のままです（DISABLED_SOURCES=x,reddit）。ニュースの各行にはタイトルと短い抜粋が含まれ、引用ラベルには見出しが使われます。

クイックスタート

cp .dev.vars.example .dev.vars
npm install
npx wrangler d1 migrations apply mentionforge --local
npm test
npm run dev

npm run dev はローカルの Worker（wrangler dev）です。npm start は、本番の /mcp に接続する Glama の stdio ブリッジであり、ローカルのリサーチエンジンではありません。npm test はユニットテスト用プロジェクト（デフォルトの CI）です。npm run test:worker は Miniflare のプールを使用し、デフォルトの CI には含まれません。

本番： https://mentionforge.mentionforge.workers.dev（NETWORK=base、eip155:8453、CDP ファシリテーター）
ステージング： https://mentionforge-staging.mentionforge.workers.dev（Base Sepolia）

すべての wrangler vars ブロックで RECIPIENT_WALLET を設定してください（ステージングと本番では設定は継承されません）。ETH または Arbitrum で使用している MetaMask アカウントの 0x アドレスが正しい値です。本番の USDC は Base で届きます。プレースホルダーの 0x000…0 を指定すると 503 PAYMENT_UNAVAILABLE が返されます。

料金

• $0.02 USDC = Base（eip155:8453）での 20000 最小単位
• キャッシュ済みおよび空のウィンドウを含め、リサーチが成功した場合に課金します
• トライアル、サンドボックス、冪等性による再実行には課金しません
• トライアル：ウォレット（X-Wallet）または X-Sandbox-Key ごとに D1 CAS を 10 回インクリメントします。すべての有料ツールで共有されます
• キーのプラン（月額 $29、Stripe Price price_1UTrCWHRKyy2qPSgkzrHPr8p）： Authorization: Bearer mfk_... または X-Api-Key。Stripe の請求期間ごとに 1,500 回呼び出し可能です。その後は HTTP 429 PLAN_QUOTA_REACHED が返されます（拒否された呼び出しはカウントされません）。キーによる呼び出しでは x402 の精算と無料トライアルをスキップします（billing.plan は "key"、amount_usdc は "0"、free_trial は false）。
• キーによる呼び出しは、グローバルな過去 30 日間の X_ID 上限（src/lib/x-id-cap.ts、1,500,000 ID）に対してもチェックされます。順序は、プランの呼び出し枠を 1 つ予約 → 処理を実行 → assertQuotaAllows → incrementXIdUsage です。どちらかの上限に達すると、課金されずに 429 が返されます。X_ID の上限によって拒否された場合、プランの予約は解放されます。キー 1 つあたり月 1,500 回の呼び出し × 最大 50 ID = 75,000 ID（グローバル上限の 5%）です。平文のキーは GET /v1/keys/claim?session_id=cs_... で一度だけ取得してください。

ドキュメント

• ドキュメントの目次
• ユースケース
• API
• MCP（MCP プロンプトを含む）
• 支払い
• アーキテクチャ
• 運用
• 本番公開
• セキュリティ
• 変更履歴
• スキル（src/lib/skill-text.ts とバイト単位で同一）
• 例
• エージェントのプロンプト
• 掲載情報

リポジトリの構成

FAQ

無料で試す方法はありますか？
はい。get_health、get_pricing、get_example、suggest_tool、get_entity_profileの5つのMCPツールは課金されません。対応するRESTルートは、GET /health、GET /v1/pricing、GET /v1/research/example、GET /v1/suggest、GET /v1/entityです。examples/free-tour.shを使えば、ウォレットなしで実行できます。

有料の呼び出しにはいくらかかりますか？
Baseで成功した有料呼び出し1回につき**$0.02 USDC**です（eip155:8453、20000原子単位）。ライブのGET /v1/pricingは、price_usdc: "0.02"とfree_trial_calls: 10を返します。

支払いはどのように行われますか？
有料のRESTツールとMCPツールは、有料ツール間で共有される10回のトライアル（X-WalletまたはX-Sandbox-Key）の後、Base上でx402によって決済されます。必ずIdempotency-Keyを送信してください。HTTP 402が返された場合は、error.hintに従ってPAYMENT-SIGNATUREを付けて再試行してください。トライアル、サンドボックス、冪等性による再実行は課金されません。

どの情報源を検索しますか？
デフォルトの調査ソースはウェブとニュースです。Wikipedia/Wikidata、Braveのウェブ検索結果、Google News RSS、GDELT、Hacker News、Trustpilot/G2/Capterraのレビューサイトのウェブ検索結果が含まれます。ライブのGET /healthでは、webはbrave+wiki、newsはpublic、reviewsはwebと報告され、redditとxの両バックエンドはdisabledと報告されます。

支払う前に調査ペイロードを確認するにはどうすればよいですか？
無料のget_exampleを呼び出す（任意のviewとして"full"または"compact"を指定）か、GET /v1/research/exampleを呼び出してください。このルートは、Cloudflare Workersの固定スナップショットを返します（meta.billing.amount_usdcは"0"です）。

ホスト型製品とこのリポジトリ

エージェントが料金を支払う対象はこのオリジンです：https://mentionforge.mentionforge.workers.dev（POST /v1/research、POST専用の/v1/compare、/v1/digest、/v1/risk、/v1/reply、/v1/mentions、/v1/trends、およびPOST /mcpの有料ツール）。共有される10回のトライアルの後は、ここでもx402によってBase上で**$0.02 USDCが課金されます。RESTのresource.urlは/v1/researchのまま、MCPのresource.urlは/mcpのままです。他の人のCloudflareアカウントを使ったクローンはフォーク**であり、このWorkerを無料で利用できるものではありません。

ルートのDockerfileはGlamaのstdioブリッジ専用です（WORKDIR /app、CMD ["node", "scripts/glama-stdio.mjs"] → mcp-remote → この/mcp URL）。package.jsonのbinとstartも同じブリッジを指しており、Glamaのインデクサーがwranglerを誤って推測しないようにしています。D1や2つ目の調査エンジンは実行しません。

ライセンス

MITライセンス

Copyright (c) 2026 MentionForge

本ソフトウェアおよび関連文書ファイル（以下「ソフトウェア」）の複製を取得するすべての者に対し、使用、複製、変更、結合、公開、頒布、サブライセンス、および／または販売する権利を含むがこれらに限定されない、本ソフトウェアを制限なく取り扱う権利を、以下の条件に従って無償で許諾します。

上記の著作権表示および本許諾表示は、本ソフトウェアのすべての複製または実質的な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、商品性、特定目的への適合性、および権利非侵害の保証を含むがこれらに限定されない、明示または黙示のいかなる保証もありません。作者または著作権者は、契約、不法行為、その他の行為を問わず、本ソフトウェアまたはその使用、その他の取引に起因または関連するいかなる請求、損害、その他の責任についても責任を負いません。

正式なライセンスのコピーはLICENSE（SPDX-License-Identifier: MIT）です。

商標

MIT License はソースコードを対象とします。製品名、ロゴ、トレードドレスの使用は許諾されません。

MentionForge、MENTION//FORGE、および MentionForge のマークは、https://mentionforge.mentionforge.workers.dev にあるホスト型サービスの製品名です。

MIT ライセンスのコードをフォーク、改変し、ご自身の名前でデプロイできます。また、ご自身のソフトウェアがこのリポジトリをベースにしていると説明したり、エージェントにこのホスト型オリジンを指定したりできます。ただし、これらの名称を使って一般公開または商用のサービスを運営したり、公式の有料エンドポイントを運営していると誤解させるような形でマークを使用したりすることはできません。

TRADEMARK.md を参照してください。