Skip to main content

​
Overview

Three additional GDELT Cloud data surfaces are exposed as progressive-discovery tool trios. All three are generally available and plan-gated — the MCP forwards your API key to the same v2 endpoints these pages document, so your plan entitlement decides. A key without the flag gets a clean 403 PLAN_REQUIRED naming the missing entitlement, never a silently empty result:
  • filings_tool_* (can_use_filings) — SEC EDGAR filings, XBRL financials, and LLM-extracted corporate relations.
  • media_intel_tool_* (can_use_tone / can_use_share_of_voice) — Entity Tone & Share of Voice over the news record.
  • maritime_tool_* (can_use_maritime) — derived AIS vessel-flow signals over the world’s energy/trade chokepoints.
The one exception is social_signal (inside media_intel_tool_*), which is still an admin-only internal preview and returns 403 ADMIN_REQUIRED for every non-admin key. Each follows the same trio (<category>_tool_list → _tool_get → _tool_call) described in Progressive Discovery. Date windows (≤30 days), geography, and pagination match the GDELT Cloud tools and the v2 API, and every controlled value list lives in Taxonomy & Codes.

​
SEC Filings — filings_tool_*

Plan-gated on can_use_filings (403 PLAN_REQUIRED without it). EDGAR is public domain (cite the SEC); the relation edges + CIK↔entity resolution are GDELT Cloud derived.
Categorical params — full lists in Taxonomy → Filings:
  • form_type: 10-K · 10-Q · 8-K · 13F-HR · SCHEDULE 13D · SCHEDULE 13G · 3 · 4 · 5 · DEF 14A · S-1 · 20-F · 6-K
  • rel_type: subsidiary · supplier · customer · counterparty · partner · jurisdiction_exposure
  • sort: recent · filer · group_by (summary): form_type · date · filer

​
Media Intelligence — media_intel_tool_*

Plan-gated: entity_tone on can_use_tone, share_of_voice on can_use_share_of_voice (403 PLAN_REQUIRED without it). social_signal remains admin-only. These measure press coverage, not public opinion, sentiment polling, popularity, or market share. Missing evidence is unavailable, never a neutral/zero reading.
Key params (full lists in Taxonomy → Media Intelligence):
  • entity_tone: start from a name with entity (it resolves) or a known entity_id; date window; quality (production_ready · reviewable · all); bucket (day · week · month); languages (all codes) to compare across language spheres.
  • share_of_voice: entities (numerator) + a denominator — at least one of query · topic · category · country · region · languages · source_set (semantic query preferred).

​
Maritime (AIS) — maritime_tool_*

Plan-gated on can_use_maritime (403 PLAN_REQUIRED without it). The tools below are derived-only; forward-accrual (no history before launch); terrestrial AIS only.
chokepoint — full list in Taxonomy → Maritime: hormuz · bab_el_mandeb · malacca · suez · panama · bosphorus · gibraltar · dover · kerch · taiwan · danish_straits.