GDELT Global Events — hosted on Cloudflare Workers (HTTP + npm stdio)

GDELT Events MCP — リアルタイムの地政学的イベント、感情トーンの時系列、アクターの傾向

リアルタイムの地政学的イベント、トーンの時系列、トレンドのアクター、ナラティブの並列比較

GDELT 2.0 の世界ニュースイベントデータベース上で稼働する、ホスト型 MCP サーバーです。トピックごとに世界中のニュースを検索し、任意のクエリについて感情トーンの時系列（-10～+10）を作成し、国別にトレンドのアクター（人物、組織、場所）を特定し、2つのナラティブに対する報道を比較できます。ニュースインテリジェンス、地政学研究、危機監視を行う LLM 向けです。

このサーバーは Model Context Protocol に対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または @modelcontextprotocol/sdk を使用して手作業で作成したエージェントなど、MCP 対応クライアントは、Bearer トークン認証で接続し、ツールを検出して呼び出すことができます。

AI エージェント / LLM 向け

このリポジトリをインデックス化する AI エージェント向けの情報です。

• 稼働中の MCP エンドポイント： https://gdelt-events-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料プランでは匿名で月100回まで呼び出し可能）
• 検出： tools/list は完全なスキーマを返します。tools/call はツールを呼び出します。
• ヘルスチェック： GET https://gdelt-events-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオの集約情報）

tools/list のリクエスト例：

curl -sS -X POST https://gdelt-events-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call の例：

curl -sS -X POST https://gdelt-events-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

公開されているツール

ツール	引数	説明
gdelt_search_events	query, country?, domain?, limit?	クエリに一致するイベントについて世界のニュースを検索します。ニュースソースの国やドメインで絞り込むこともできます。
gdelt_tone_timeseries	query, hours? or days?, interval?	クエリの感情トーンの時系列（-10はネガティブ、+10はポジティブ）と記事数を返します。
gdelt_trending_actors	country, hours?, limit?	国別に、言及数が多い名前付きエンティティ（人物、組織、場所）を返します。
gdelt_compare	query_a, query_b — Team+	2つのクエリのトーンの時系列を並べて表示し、ナラティブを比較します。

Team+ のマークが付いたツールを利用するには、Team または Pro のサブスクリプションが必要です。匿名ユーザーと Free プランのユーザーがこれらを呼び出すと、tier_required エラーが返されます。

クイックスタート

最も手軽な方法は、mcp-remote を使って、MCP 対応クライアントをホスト型エンドポイントに接続することです。

npx -y mcp-remote https://gdelt-events-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

https://gdelt-events-mcp.atlasword.workers.dev/upgrade?tier=solo からキーを取得してください（API キーの取得を参照）。

Cursor へのインストール

~/.cursor/mcp.json に次の内容を追加します。

{
  "mcpServers": {
    "gdelt-events-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://gdelt-events-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

その後 Cursor を再起動すると、MCP パネルにツールが表示されます。

Claude Desktop へのインストール

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に次の内容を追加します。

{
  "mcpServers": {
    "gdelt-events-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://gdelt-events-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動します。スラッシュコマンドの MCP メニューにツールが表示されます。

API キーの取得

1. https://gdelt-events-mcp.atlasword.workers.dev/upgrade?tier=solo（または tier=team / tier=pro）にアクセスします。
2. Dodo Payments のホスト型チェックアウトにリダイレクトされます。Dodo が住所を収集し、カード決済を処理し、VAT/GST に対応します。
3. 支払い後、Dodo が署名付き webhook（subscription.active）を Worker に送信します。Worker は mck_<32 random base64url> を発行し、KV に保存します。
4. https://gdelt-events-mcp.atlasword.workers.dev/welcome?key=<api_key> に移動します。今すぐキーをコピーしてください（この URL で一度だけ表示されます）。
5. キーを Cursor / Claude Desktop の設定に貼り付けます（上記を参照）。
6. https://gdelt-events-mcp.atlasword.workers.dev/account でアカウントの表示／キーのローテーション／エクスポートを行います（Bearer 認証）。

無料ティアもあります（登録不要）。匿名の呼び出し元は、IP ごとに月 100 回まで呼び出せます。

エンドポイント

ルート	説明
POST /mcp	MCP JSON-RPC 2.0 ツールサーフェス（メイン API）。有料ティアでは Bearer 認証が必要です。
GET /health	稼働状態の確認用エンドポイント — {ok: true, ts}。mcp-hub の cron で使用します。
GET /	HTML ランディングページ（OG + favicon + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後のランディングページ。新たに発行された API キーを表示します。
GET /account	Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	Bearer 認証。新しいキーを発行し、古いキーを無効にします。
GET /account/export	Bearer 認証。GDPR データエクスポート — アカウント、使用状況カウンター、Dodo の詳細情報を JSON で返します。
GET /account/team	Bearer 認証（Team 以上）。チームメンバーのサブキーを一覧表示します。
POST /account/team/invite	Bearer 認証（Team 以上）。チームメンバー用のサブキーを新規発行します。
POST /account/team/revoke	Bearer 認証（Team 以上）。チームメンバーのサブキーを取り消します。
GET /team/accept?key=...	サブキー URL 用のチームメンバー向けオンボーディングランディングページ。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションと支払いのライフサイクル。
GET /favicon.ico	インライン SVG。

料金

すべてのティアで月間上限とレート制限は共通です。価格には製品ごとの位置付けが反映されています。

ティア	月間呼び出し数	レート制限	チームシート数
Free	月 100 回	1 分あたり 10 回	0
Solo	月 2,000 回	1 分あたり 60 回	0
Team	月 10,000 回	1 分あたり 200 回	5
Pro	月 50,000 回	1 分あたり 600 回	25

プラン	料金	月間呼び出し数	チームシート数
Free	$0	100	0
Solo	$9/月	2,000	0
Team	$29/月	10,000	5
Pro	$79/月	50,000	25

Dodo Payments 経由で請求されます（記録上の販売者 — VAT/GST は Dodo が処理します）。いつでも解約できます。支払い済み期間の終了までは引き続き利用できます。

データソース

• GDELT 2.0 Project — https://www.gdeltproject.org/ — 無料の公開 API

このサーバーは、上流のソースを利用するための薄いトランスポート + 認証 + キャッシュレイヤーです。呼び出しごとのレート制限は、各上流サービスの無料ティアの利用規約を十分に守れるよう調整されています。

プライバシー + GDPR

• プライバシーポリシー： https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約： https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー： https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート： GET https://gdelt-events-mcp.atlasword.workers.dev/account/export（Bearer 認証）は、アカウント、使用状況カウンター、Dodo の顧客詳細情報を含む、機械可読な JSON スナップショットを返します。
• 削除： 登録済みのメールアドレスから [email protected] にメールしてください。

保存するのは、メールアドレス、発行した API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。短いキャッシュ TTL を超えて、ツールの引数や上流からのレスポンスをログに記録することはありません。

アーキテクチャ

• ランタイム： Cloudflare Workers（V8 分離環境、グローバルエッジ）。
• ストレージ： 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流レスポンスキャッシュ）と <slug>-usage（API キー、月次カウンター、チーム名簿）。
• 課金： Dodo Payments のライブモード、3 つのサブスクリプション製品（Solo / Team / Pro）、Standard-Webhooks による署名付きライフサイクル。
• オブザーバビリティ： Cloudflare Workers Analytics、mcp-hub status でのポートフォリオ集計。
• ソース： TypeScript、Vitest によるテスト済み、wrangler deploy でデプロイ可能です。このリポジトリの src/ をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

作者

Prakhar Gupta

• メール：[email protected]
• GitHub： @guptaprakhariitr

ステータス

• ライブステータスページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/gdelt-events-mcp

npm でインストール（ワンライナー）

薄いランチャーが npm で @insnapsprakhar/gdelt-events-mcp として公開されています。URL を手動でコピー＆ペーストする必要はありません。

npx -y @insnapsprakhar/gdelt-events-mcp

または、MCP クライアントに組み込んでください。

{
  "mcpServers": {
    "gdelt-events": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/gdelt-events-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません。mcp-remote を呼び出し、ホストされたエンドポイント（https://gdelt-events-mcp.atlasword.workers.dev/mcp）を指定します。