Back to Home
ledgerW icon

gdelt-mcp

by ledgerW

Overview

Model Context Protocol server providing AI agents with access to GDELT 2.0 (Global Database of Events, Language, and Tone) via Google BigQuery for cost-optimized querying.

Installation

Run Command
uv run python server.py

Environment Variables

  • GCP_PROJECT_ID
  • GCP_PRIVATE_KEY
  • GCP_CLIENT_EMAIL

Security Notes

The server directly interpolates user-provided `where_clause` and `select_fields` parameters into BigQuery SQL queries without explicit sanitization or parameterization. This creates a significant SQL Injection vulnerability. While the server is designed to use client-provided BigQuery credentials (limiting direct harm to the server operator's own project if they are not used), if the server falls back to environment variable credentials, a malicious client could exploit this to execute arbitrary BigQuery SQL against the server's configured GCP project. This makes the server unsafe to run in environments with untrusted inputs.

Similar Servers

Stats

Interest Score0
Security Score4
Cost ClassHigh
Avg Tokens2500
Stars0
Forks0
Last Update2025-11-25

Tags

GDELTBigQueryAI AgentsData AnalysisCost Optimization