Skip to main content

​
The server does not expose one tool per endpoint

There are 73 tools. Advertising them all would spend a large part of a model’s context describing an API before it has been asked anything, and the value lists alone run past a thousand entries. So each category exposes three thin tools instead — 42 in total — and the model walks down only the branch it needs: {category} is the category name from the table below — so the events tools are reached with gdelt_cloud_tool_list, gdelt_cloud_tool_get and gdelt_cloud_tool_call, and the maritime ones with maritime_tool_list and so on.
The trio is per category, not global. There is no single tool_list. Picking the category is the first decision, which is why each one below says when to reach for it.
The practical consequence for a model: fetch the schema with _tool_get before the first call to a tool it has not used in this conversation. Guessing a parameter name is the single most common failure, and the server rejects unknown filters rather than ignoring them.

​
Categories

​
GDELT Cloud

gdelt_cloud · Core Real-world dynamics — what happened, who did it, where, and how often. The anchor category: coded events, clustered stories, resolved entities and the aggregates over them. Start here for any question about events rather than a static registry fact. Parameters and value lists are the endpoint’s own: see Events · Stories · Entities · Unified Search · Geography · Atlas Intelligence in the API reference, or fetch them at call time with gdelt_cloud_tool_get.

​
Media Intelligence

media_intel · Core How an entity is covered by the press — tone over time and share of voice against a peer set. Parameters and value lists are the endpoint’s own: see Media Intelligence in the API reference, or fetch them at call time with media_intel_tool_get.

​
Facilities

facilities · Core The unified physical-asset directory — power plants, industrial sites, ports and data centers on one keyed surface, resolved to spine owners. Parameters and value lists are the endpoint’s own: see Facilities in the API reference, or fetch them at call time with facilities_tool_get.

​
Government

gov · Open Feeds US federal awards and foreign-influence registrations, resolved onto the entity spine. Parameters and value lists are the endpoint’s own: see Government in the API reference, or fetch them at call time with gov_tool_get.

​
Filings

filings · Open Feeds SEC EDGAR — the filing index, XBRL financials, and relations extracted from filing text. Parameters and value lists are the endpoint’s own: see Filings in the API reference, or fetch them at call time with filings_tool_get.

​
Legal Entities

gleif · Open Feeds The GLEIF Global LEI Index — legal-entity reference data, consolidation relationships and LEI↔ISIN mappings. Parameters and value lists are the endpoint’s own: see Reference Data in the API reference, or fetch them at call time with gleif_tool_get.

​
Energy

energy · Open Feeds Global Energy Monitor assets and the ownership registry over them. Parameters and value lists are the endpoint’s own: see Energy in the API reference, or fetch them at call time with energy_tool_get.

​
AI Compute

epoch · Open Feeds Epoch AI — models, hardware, data centers, companies and chip sales. Parameters and value lists are the endpoint’s own: see AI Compute in the API reference, or fetch them at call time with epoch_tool_get.

​
Macro Finance

macro · Open Feeds FRED economic series, with true point-in-time vintages rather than the latest revision. Parameters and value lists are the endpoint’s own: see Macro Finance in the API reference, or fetch them at call time with macro_tool_get.

​
Risk and Screening

risk · Open Feeds Restricted-party lists, name screening, ownership-chain exposure and China development finance. Analytical coverage, not an audit-grade compliance control. Parameters and value lists are the endpoint’s own: see Screening and Reference · China in the API reference, or fetch them at call time with risk_tool_get.

​
Maritime

maritime · Open Feeds AIS-derived vessel flow — chokepoint transits, port dwell, dark gaps and last-known positions. Terrestrial AIS only, so coverage thins in open ocean. Parameters and value lists are the endpoint’s own: see Maritime in the API reference, or fetch them at call time with maritime_tool_get.

​
Prediction Markets

prediction_market · Vendor Kalshi contracts, read as a market-implied probability rather than a fact. A vendor surface reached through the same protocol — not GDELT Cloud data.

​
Web Research

web_research · Vendor Live web search and page extraction, for corroborating a finding against primary sources after the structured surfaces have answered. A vendor surface, not GDELT Cloud data.

​
Macro Finance (vendor)

macro_finance · Vendor Alpha Vantage market and economic series. Distinct from the macro category above, which is our FRED surface with point-in-time vintages — this one is a vendor passthrough. The catalog for this category is fetched from the provider at call time, so there is no fixed list to publish — ask macro_finance_tool_list for the current one. Reached through the same protocol, but not GDELT Cloud data — see External tools.

​
What is metered

A _tool_call costs the same as the REST call it makes, against the same plan limits, and appears in the same usage reporting. _tool_list and _tool_get are discovery and are not metered. An endpoint your entitlement does not include returns an error naming what it needs — never an empty result, which would be indistinguishable from missing data.