GDELT MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level - debug, info, warn, error | info |
| GDELT_USER_AGENT | No | User agent string | GDELT-MCP-Server/1.0 |
| GDELT_API_TIMEOUT | No | API request timeout in milliseconds | 30000 |
| GDELT_API_BASE_URL | No | GDELT API base URL | https://api.gdeltproject.org/api/v2/doc/doc |
| GDELT_DEFAULT_TIMESPAN | No | Default time period for searches | 1month |
| GDELT_DEFAULT_MAX_RECORDS | No | Default maximum records to return | 50 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_articlesA | Search GDELT's global news database for articles across 65 languages. Supports keyword/phrase searches, Boolean operators (OR, AND), and searches back 3 months. Default returns 50 most recent articles from the past month. |
| search_imagesA | Search GDELT's Visual Knowledge Graph (VGKG) for news images. Can search by visual content (what's depicted), captions/context, or OCR/metadata. Searches back 3 months of global news imagery. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 2 tools
Each tool targets a distinct resource: articles vs. images. There is no overlap in purpose.
Both tools follow a consistent 'search_' prefix with a noun, adhering to verb_noun naming.
With only two tools, the server feels somewhat thin but remains focused. The count is borderline for its scope.
The server covers its primary domain of search (articles and images) adequately. Minor gaps like fetching specific article details are absent but not critical for a search-focused server.