GDELT Cloud MCP Server

GDELT Cloud MCP Server とは？

GDELT Cloud MCP Server は GDELT Cloud がホストする MCP エンドポイントです。Claude、ChatGPT、Codex、独自エージェントから、構造化された地政学イベント、クラスタ化されたニュース記事群、関連する人物・組織・場所を、GDELT Cloud REST API と同じデータで照会できます。

GDELT Cloud は公開されている GDELT の記事ストリームを構造化データベースに変換します。イベントは独自の分類体系（CAMEO+ と Conflict カテゴリ）でコード化され、行為者、地理情報、ソースの証拠、指標を持ちます。Stories はその背後にある記事をクラスタ化し、エンティティは報道を関係する人物や組織に結び付けます。さらに SEC filings、GLEIF、USAspending、FRED、Global Energy Monitor、Epoch AI などの公開レジストリも同じエンティティ基盤に取り込んでいます。ドキュメントによれば MCP サーバーは API と同じ処理関数を呼び出すため、MCP で得た答えは curl でも得られるものです。

GDELT Cloud MCP Server の使い方

GDELT Cloud アカウントが必要です。サーバー URL は次のとおりです。

https://mcp.gdeltcloud.com/mcp

Streamable HTTP を使用します。Claude と ChatGPT はブラウザで OAuth サインインし、bearer 認証を使うクライアントは gdeltcloud.com/api-keys で作成した API キー（gdelt_sk_ で始まる）を使います。どのエンドポイントが応答するかは、REST と同様にプランで決まります。

Claude Code

claude mcp add --transport http gdelt-cloud https://mcp.gdeltcloud.com/mcp

その後セッション内で /mcp を開き、OAuth サインインの手順に従います。GDELT Cloud は Claude Code、Codex、Cursor 向けのプラグイン（GitHub の gdelt-cloud/plugins）も提供しており、このサーバー、ドキュメントサーバー、8 つのスキルをまとめて追加できます。

Claude Desktop と claude.ai

Settings → Connectors → Add custom connector でサーバー URL を貼り付け、GDELT Cloud アカウントでサインインして接続を承認します。API キーは不要です。

Cursor

~/.cursor/mcp.json にサーバーを追加し、Cursor の MCP 設定から認証します。

{
  "mcpServers": {
    "gdelt-cloud": {
      "url": "https://mcp.gdeltcloud.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。サーバーの初回実行時に VS Code が OAuth サインインを開始します。

{
  "servers": {
    "gdelt-cloud": {
      "type": "http",
      "url": "https://mcp.gdeltcloud.com/mcp"
    }
  }
}

Codex（API キー）

GDELT Cloud のドキュメントでは、Codex は環境変数から bearer キーを読み込みます。

export GDELT_API_KEY=gdelt_sk_...
codex mcp add gdelt-cloud \
  --url https://mcp.gdeltcloud.com/mcp \
  --bearer-token-env-var GDELT_API_KEY

bearer_token_env_var にはキーそのものではなく変数名を指定します。

GDELT Cloud MCP Server の主な機能

• 公式のリモートサーバー。データと権限は GDELT Cloud REST API v2 と同じです。
• ドキュメントによれば、型付き引数を持つ 116 の名前付きドメイン操作があり、ニュース、アイデンティティ、国、Situations、Monitors、専門データセット（メディアのトーン、施設、filings、GLEIF、エネルギー、AI コンピュート、マクロ、リスクスクリーニング、海事 AIS）をカバーします。
• まずエンティティ解決：unified_entity_search が名前を候補 ID に解決し、search_entities は期間や地域の報道に登場する対象を見つけます。
• 無料で従量課金されない探索ヘルパー：get_data_catalog、get_parameter_options、get_event_taxonomy。
• Monitors：継続的な問いをプレビューしてから保存し、定期実行してメールまたは署名付き Webhook で配信します。create_monitor や update_monitor などの書き込みにはホストの承認が必要です。
• response_mode="compact"（デフォルト）または "full"。レコードへのリンク、証拠、カバレッジが明示されるため、エージェントが出典を引用できます。
• 権限エラーは必要なプランのフラグを示し、データ欠落と見分けのつかない空の結果は返しません。

GDELT Cloud MCP Server のユースケース

• 国別ブリーフィング：「過去 7 日間でナイジェリアに何が起きた？イベントをカテゴリ別にまとめ、記事を引用して」
• エンティティ調査：企業を解決し、関連するイベント、記事、報道のトーン、SEC filings、施設をたどります。
• 進行中の事態：ある進行中の出来事に関する記事とコード化イベントを集めた Situation を追跡します。
• アラート：「この地域の港湾付近での抗議活動の Monitor を設定し、一致したものを自分の Webhook に送って」まずプレビューし、その後確定します。
• サプライチェーン・資産調査：発電所、鉱山、港湾、データセンターを検索し、所有関係とソースの観測記録を確認します。

GDELT Cloud MCP Server のトラブルシューティング

• ツールが表示されない：クライアントは接続したものの認証に失敗しています。キーが有効な gdelt_sk_ キーで、gdeltcloud.com/api-keys で取り消されていないか確認するか、OAuth サインインをやり直してください。
• 呼び出しがプランエラーを返す：そのエンドポイントはプランに含まれていません。エラーに必要なフラグが示されます。
• モデルがパラメータを捏造する：まずエンドポイントの説明を取得させてください。サーバーは未知のフィルターを無視せず拒否します。
• Codex で 401 になる：bearer_token_env_var に変数名ではなくキーそのものを設定しています。
• 古いツールやエンドポイント：クライアントに古いエンドポイントが残っている場合は https://mcp.gdeltcloud.com/mcp に更新し、再度サインインしてツール一覧を更新してください。