> ## Documentation Index > Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Filings, Media Intelligence & Maritime Tools > Filings, Media Intelligence, and Maritime MCP tool categories — generally available, plan-gated ## 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 (`_tool_list` → `_tool_get` → `_tool_call`) described in [Progressive Discovery](/mcp/tools/progressive-discovery). Date windows (≤30 days), geography, and pagination match the [GDELT Cloud tools](/mcp/tools/gdelt-cloud) and the [v2 API](/api-reference/v2), and every controlled value list lives in [Taxonomy & Codes](/api-reference/taxonomy). ## 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. | Tool | What it does | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `filings_resolve` | Resolve a ticker / CIK / company name → SEC CIK + spine `entity_id`. **Start here.** | | `filings_search` | Search the EDGAR index by `cik`, `form_type`, `search` (company name), and date window. | | `filings_summary` | Rollup by form type, date, or filer — counts + distinct filers. | | `filings_get_filer` | One filer's profile: identity, ticker, `entity_id`, recent filings, XBRL highlights. | | `filings_get_relations` | LLM-extracted subsidiary / supplier / customer / counterparty / jurisdiction edges, resolved to spine `entity_id`s with a verbatim evidence quote. | | `filings_get_facts` | XBRL `us-gaap` / `dei` fact time series (segment revenue, assets, net income) for exposure sizing. | Categorical params — full lists in [Taxonomy → Filings](/api-reference/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. | Tool | What it does | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `entity_tone` | Mean press tone toward a **resolved** entity over time (−100..100; negative = critical), with the article/source coverage behind it. | | `share_of_voice` | Each entity's share of coverage **within a conversation you define** — `entities` is the numerator; you must define the denominator. | | `social_signal` | **Admin-only preview.** Live Bluesky (AT Protocol) mention volume, engagement, sample posts, and an *indicative* naive-lexicon sentiment read. | Key params (full lists in [Taxonomy → Media Intelligence](/api-reference/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](/api-reference/taxonomy#languages)) 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. | Tool | What it does | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `maritime_transits` | Chokepoint·hour activity: distinct + moving vessels, avg speed over ground, AIS message counts. | | `maritime_vessels` | Current vessels (last-known position + identity). Search by name / IMO / MMSI / call sign, filter by `chokepoint`, or run a geo/proximity query — including `near_gem_id` to find vessels near a GEM energy asset (the maritime↔energy join). | | `maritime_get_carrier` | One vessel by IMO: identity, last-known position, and matched GEM LNG-carrier. | | `maritime_dwell` | Completed dwell episodes at a chokepoint (`arrival`, `departure`, `dwell_hours`). | | `maritime_gaps` | AIS-dark gaps — a vessel that stopped transmitting then reappeared; filter by minimum gap hours. | `chokepoint` — full list in [Taxonomy → Maritime](/api-reference/taxonomy#maritime-chokepoints): `hormuz` · `bab_el_mandeb` · `malacca` · `suez` · `panama` · `bosphorus` · `gibraltar` · `dover` · `kerch` · `taiwan` · `danish_straits`.