Model Context Protocol server for the GDELT DOC 2.0 API. Exposes tools to search GDELT's global news database and Visual Knowledge Graph (VGKG) for articles and images across 65 languages.
Scoring was not performed
Output schema not documented. Tool returns JSON but LLMs cannot predict response structure (fields, types, nested objects). Agents cannot plan downstream composition without seeing what data is available.
Parameter constraints (min/max for numeric, regex for dates) not documented in descriptions. max_records accepts 1-250 but description lacks explicit min/max bounds. start_date_time and end_date_time format (YYYYMMDDHHMMSS) stated in description but no validation error guidance if LLM passes wrong format.
Error handling is generic (ValueError wrapping). Errors do not guide LLM recovery, no distinction between retryable (timeout, rate limit) vs user-fixable (invalid query syntax) vs fatal (auth failure). No error classification or recovery hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 13 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 48 | - | v1 |
No documentation of pagination behavior. tools accept max_records (1-250) but no next_cursor or offset mechanism is documented. If GDELT API supports pagination, it is hidden from the LLM, forcing it to guess or retry with different max_records.
Parameter relationship not documented: start_date_time and end_date_time are mutually exclusive with timespan (e.g., cannot specify both '1month' AND explicit date range). LLM will pass both unless explicitly told not to.