# Agent Datasets documentation One bounded, self-describing tool surface over MCP, with a REST mirror underneath. Values carry their own units, currency, timestamp, and source; results are bounded; the same envelope and the same error codes come back whichever surface you called. 63 tools · 63 REST operations · 5 advertised categories. ## Machine-readable mirrors Every page on this site has a Markdown twin at the same path with `.md` appended, and the generated artifacts behind the reference pages are served as JSON. - [llms.txt](https://www.agentdatasets.com/llms.txt): this index, in the llmstxt.org format - [llms-full.txt](https://www.agentdatasets.com/llms-full.txt): every page's Markdown, concatenated - [tool-catalog.json](https://www.agentdatasets.com/docs/machine/tool-catalog.json): the generated MCP tool catalog - [openapi.json](https://www.agentdatasets.com/docs/machine/openapi.json): the public OpenAPI 3.1 document - [conventions.json](https://www.agentdatasets.com/docs/machine/conventions.json): the shared response contract - [attribution.json](https://www.agentdatasets.com/docs/machine/attribution.json): the source register ## Start here - [Quickstart](https://www.agentdatasets.com/docs/quickstart.md): Connect an MCP client, make a first tool call, and read the envelope that comes back. - [Authentication](https://www.agentdatasets.com/docs/authentication.md): API keys from the dashboard, the X-API-KEY header, and what the MCP endpoint advertises. - [REST quickstart](https://www.agentdatasets.com/docs/rest-quickstart.md): One curl call against the HTTP mirror, then paging and the shared response contract. ## Category guides - [Banks](https://www.agentdatasets.com/docs/guides/banks.md): US commercial bank financials and institution profiles from the FDIC BankFind Suite. - [Foreign Exchange](https://www.agentdatasets.com/docs/guides/fx.md): Daily ECB euro reference rates and EUR-triangulated conversions. - [Geography](https://www.agentdatasets.com/docs/guides/geo.md): Canonical US Census/OMB and Australian ABS ASGS geography identity, containment hierarchies, aliases, and official crosswalks. - [Platform](https://www.agentdatasets.com/docs/guides/platform.md): Catalog and freshness metadata for the Agent Datasets platform. - [Real Estate](https://www.agentdatasets.com/docs/guides/re.md): US housing and real-estate indicators — FHFA house price indices and related series. ## The contract - [Conventions](https://www.agentdatasets.com/docs/conventions.md): Envelope, bounds, pagination, point-in-time reads, errors, and the redistribution gate. - [Errors and the envelope](https://www.agentdatasets.com/docs/errors.md): The response envelope and the error taxonomy, restructured as a lookup reference. ## Tool catalog - [All tools](https://www.agentdatasets.com/docs/tools.md): Every public tool, grouped by launch-status category. - [banks_get_financials](https://www.agentdatasets.com/docs/tools/banks_get_financials.md): Fetch one bank's bounded, newest-first FDIC quarterly financials. - [banks_search_institutions](https://www.agentdatasets.com/docs/tools/banks_search_institutions.md): Resolve a bank name or identifier to ranked FDIC institutions. - [cmbs_get_loans](https://www.agentdatasets.com/docs/tools/cmbs_get_loans.md): Fetch one registered CMBS deal's loans, collateral, and latest performance. - [cmbs_search_deals](https://www.agentdatasets.com/docs/tools/cmbs_search_deals.md): Discover CMBS deals and whether their EX-102 loans are available. - [entities_get](https://www.agentdatasets.com/docs/tools/entities_get.md): Fetch one current GLEIF Level-1 legal-entity profile. - [entities_get_ownership](https://www.agentdatasets.com/docs/tools/entities_get_ownership.md): Traverse current GLEIF Level-2 consolidation relationships. - [entities_search](https://www.agentdatasets.com/docs/tools/entities_search.md): Search GLEIF Level-1 legal entities by identity or name. - [fda_get_approvals](https://www.agentdatasets.com/docs/tools/fda_get_approvals.md): Fetch full curated Drugs@FDA detail for up to ten applications. - [fda_search_approvals](https://www.agentdatasets.com/docs/tools/fda_search_approvals.md): Search pilot-sponsor Drugs@FDA approval events with bounded cursor paging. - [funds_get_holdings](https://www.agentdatasets.com/docs/tools/funds_get_holdings.md): Fetch one fund's bounded, accession-pinned SEC N-PORT positions. - [funds_get_proxy_votes](https://www.agentdatasets.com/docs/tools/funds_get_proxy_votes.md): Fetch a fund's or manager's SEC Form N-PX proxy-voting record. - [funds_search_funds](https://www.agentdatasets.com/docs/tools/funds_search_funds.md): Resolve a fund name or ticker to SEC registrant/series/class identity. - [futures_get_positioning](https://www.agentdatasets.com/docs/tools/futures_get_positioning.md): Weekly COT positioning for one market, newest first, with derived values. - [futures_search_markets](https://www.agentdatasets.com/docs/tools/futures_search_markets.md): Resolve a futures-market topic to ranked markets in our curated catalog. - [fx_convert](https://www.agentdatasets.com/docs/tools/fx_convert.md): Convert one amount with ECB reference rates and explicit date resolution. - [fx_get_rates](https://www.agentdatasets.com/docs/tools/fx_get_rates.md): Get daily ECB euro reference rates or EUR-triangulated cross-rates. - [geo_contains](https://www.agentdatasets.com/docs/tools/geo_contains.md): Walk containment and return descendants at one requested level. - [geo_crosswalk](https://www.agentdatasets.com/docs/tools/geo_crosswalk.md): Return official crosswalk targets for one canonical geography. - [geo_get](https://www.agentdatasets.com/docs/tools/geo_get.md): Fetch one canonical geography with its relationship context. - [geo_resolve](https://www.agentdatasets.com/docs/tools/geo_resolve.md): Resolve a place or code to stable canonical geography IDs. - [gov_get_recipient_awards](https://www.agentdatasets.com/docs/tools/gov_get_recipient_awards.md): Fetch one recipient's bounded fiscal-year USAspending obligations. - [gov_search_recipients](https://www.agentdatasets.com/docs/tools/gov_search_recipients.md): Resolve a federal-award recipient name, UEI, or recipient id. - [hazards_get_risk_profile](https://www.agentdatasets.com/docs/tools/hazards_get_risk_profile.md): Return one county or tract's newest FEMA National Risk Index profile. - [hazards_list_hazard_components](https://www.agentdatasets.com/docs/tools/hazards_list_hazard_components.md): List one geography's FEMA NRI per-hazard risk and EAL breakdown. - [hazards_rank_geographies](https://www.agentdatasets.com/docs/tools/hazards_rank_geographies.md): Rank counties or tracts by a composite or hazard-specific NRI metric. - [macro_get_calendar](https://www.agentdatasets.com/docs/tools/macro_get_calendar.md): List upcoming official macro data releases and policy meetings. - [macro_get_series](https://www.agentdatasets.com/docs/tools/macro_get_series.md): Observations for one macro series, newest first, with interpretive context. - [macro_list_recent_updates](https://www.agentdatasets.com/docs/tools/macro_list_recent_updates.md): List macro series whose ingested observations changed after a timestamp. - [macro_search_series](https://www.agentdatasets.com/docs/tools/macro_search_series.md): Resolve a macro topic to ranked series in our catalog. - [platform_get_catalog](https://www.agentdatasets.com/docs/tools/platform_get_catalog.md): Discover what data this platform serves: every category and dataset, with coverage, cadence, licensing posture, freshness, and the MCP tools that serve each dataset. - [platform_get_freshness](https://www.agentdatasets.com/docs/tools/platform_get_freshness.md): Report freshness and licensing posture for every served dataset. - [re_get_hazard_profile](https://www.agentdatasets.com/docs/tools/re_get_hazard_profile.md): Fetch one county's latest FEMA National Risk Index hazard profile. - [re_get_series](https://www.agentdatasets.com/docs/tools/re_get_series.md): Fetch a bounded, newest-first page of one real-estate series. - [re_search_geographies](https://www.agentdatasets.com/docs/tools/re_search_geographies.md): Resolve a U.S. place to geography keys and containment links. - [re_search_series](https://www.agentdatasets.com/docs/tools/re_search_series.md): Discover real-estate series for a topic and/or exact geography. - [stocks_get_balance_sheets](https://www.agentdatasets.com/docs/tools/stocks_get_balance_sheets.md): Normalized balance sheets for one US public company, newest first. - [stocks_get_beneficial_owners](https://www.agentdatasets.com/docs/tools/stocks_get_beneficial_owners.md): The current >5% beneficial owners of one US public company. - [stocks_get_cash_flow_statements](https://www.agentdatasets.com/docs/tools/stocks_get_cash_flow_statements.md): Normalized cash-flow statements for one US public company, newest first. - [stocks_get_company_events](https://www.agentdatasets.com/docs/tools/stocks_get_company_events.md): One US public company's 8-K material-event timeline, newest first. - [stocks_get_company_facts](https://www.agentdatasets.com/docs/tools/stocks_get_company_facts.md): Identity + dataset-coverage profile for one US public company. - [stocks_get_corporate_actions](https://www.agentdatasets.com/docs/tools/stocks_get_corporate_actions.md): Typed corporate-action events for one US public company. - [stocks_get_earnings_dates](https://www.agentdatasets.com/docs/tools/stocks_get_earnings_dates.md): One company's earnings-announcement history and estimated next window. - [stocks_get_executive_compensation](https://www.agentdatasets.com/docs/tools/stocks_get_executive_compensation.md): SEC pay-versus-performance rows for one US public company, newest first. - [stocks_get_expected_report](https://www.agentdatasets.com/docs/tools/stocks_get_expected_report.md): Estimate when one company will next file a periodic report (10-K/10-Q/20-F). - [stocks_get_filing_section](https://www.agentdatasets.com/docs/tools/stocks_get_filing_section.md): Read one 10-K/10-Q section in bounded, lossless text pages. - [stocks_get_financial_metrics](https://www.agentdatasets.com/docs/tools/stocks_get_financial_metrics.md): Derived financial metrics for one US public company — computed here so you never have to do the arithmetic yourself. - [stocks_get_fund_holders](https://www.agentdatasets.com/docs/tools/stocks_get_fund_holders.md): Registered funds whose latest Form N-PORT filing holds a company. - [stocks_get_income_statements](https://www.agentdatasets.com/docs/tools/stocks_get_income_statements.md): Normalized income statements for one US public company, newest first. - [stocks_get_insider_trades](https://www.agentdatasets.com/docs/tools/stocks_get_insider_trades.md): Insider transactions reported on Forms 3/4/5 by one US public company's insiders. - [stocks_get_ipo_profile](https://www.agentdatasets.com/docs/tools/stocks_get_ipo_profile.md): Get one issuer's complete registration-event timeline by SEC CIK. - [stocks_get_peers](https://www.agentdatasets.com/docs/tools/stocks_get_peers.md): Comparable companies for one company, with fundamentals side by side. - [stocks_get_proxy_voting_summary](https://www.agentdatasets.com/docs/tools/stocks_get_proxy_voting_summary.md): Covered fund managers' N-PX votes for one company's shareholder meetings. - [stocks_get_recent_filings](https://www.agentdatasets.com/docs/tools/stocks_get_recent_filings.md): Universe-wide SEC EDGAR filed-since feed, newest first. - [stocks_get_sec_filings](https://www.agentdatasets.com/docs/tools/stocks_get_sec_filings.md): SEC EDGAR filings for one US public company, newest first. - [stocks_get_segmented_financials](https://www.agentdatasets.com/docs/tools/stocks_get_segmented_financials.md): Revenue or operating income broken out by segment, newest year first. - [stocks_screen](https://www.agentdatasets.com/docs/tools/stocks_screen.md): Cross-sectional company screener over the latest metrics snapshot. - [stocks_search_events](https://www.agentdatasets.com/docs/tools/stocks_search_events.md): One 8-K event category across the ingested filer universe, newest first. - [stocks_search_expected_reports](https://www.agentdatasets.com/docs/tools/stocks_search_expected_reports.md): Companies estimated to file a periodic report in the next few days. - [stocks_search_filings](https://www.agentdatasets.com/docs/tools/stocks_search_filings.md): Search EDGAR filing text live across all filers and return citations. - [stocks_search_ipos](https://www.agentdatasets.com/docs/tools/stocks_search_ipos.md): Search initial-registration lifecycles across the held SEC index. - [stocks_search_line_items](https://www.agentdatasets.com/docs/tools/stocks_search_line_items.md): Selected canonical statement lines across several companies. - [stocks_search_ownership_filings](https://www.agentdatasets.com/docs/tools/stocks_search_ownership_filings.md): Search Schedule 13D/13G ownership filings, newest first. - [stocks_search_tickers](https://www.agentdatasets.com/docs/tools/stocks_search_tickers.md): Resolve a company name/ticker/fragment to ranked candidate entities. ## REST reference - [All endpoints](https://www.agentdatasets.com/docs/rest.md): Base URL, authentication, the response contract, and the endpoint index. - [Banks](https://www.agentdatasets.com/docs/rest/banks.md): US commercial bank financials and institution profiles from the FDIC BankFind Suite. - [CMBS](https://www.agentdatasets.com/docs/rest/cmbs.md): Commercial mortgage-backed securities — deal registry and loan/property collateral detail from public SEC EDGAR ABS-EE EX-102 filings. - [Legal Entities](https://www.agentdatasets.com/docs/rest/entities.md): GLEIF Legal Entity Identifier profiles and accounting-consolidation relationships from the Level-1 and Level-2 golden copies. - [FDA](https://www.agentdatasets.com/docs/rest/fda.md): Drug application, product, and approval history for pilot US-listed biotech and pharmaceutical sponsors from Drugs@FDA. - [Funds](https://www.agentdatasets.com/docs/rest/funds.md): SEC N-PORT fund holdings and N-PX proxy-voting records for registered investment funds. - [Futures](https://www.agentdatasets.com/docs/rest/futures.md): Weekly CFTC Commitments of Traders positioning for curated financial-futures markets — Treasuries, SOFR, E-mini equity indices, and major FX — by trader category. - [Foreign Exchange](https://www.agentdatasets.com/docs/rest/fx.md): Daily ECB euro reference rates and EUR-triangulated conversions. - [Geography](https://www.agentdatasets.com/docs/rest/geography.md): Canonical US Census/OMB and Australian ABS ASGS geography identity, containment hierarchies, aliases, and official crosswalks. - [Federal spending](https://www.agentdatasets.com/docs/rest/gov.md): US federal award recipients and obligation aggregates from USAspending — recipient registry, fiscal-year obligation trends, and top awarding agencies. - [Hazards](https://www.agentdatasets.com/docs/rest/hazards.md): US natural-hazard risk — FEMA National Risk Index county and census-tract profiles, components, and rankings. - [Macro](https://www.agentdatasets.com/docs/rest/macro.md): US macroeconomic time series — Treasury yields, BLS employment and inflation measures, and BEA national accounts. - [Platform](https://www.agentdatasets.com/docs/rest/platform.md): Catalog and freshness metadata for the Agent Datasets platform. - [Real Estate](https://www.agentdatasets.com/docs/rest/real-estate.md): US housing and real-estate indicators — FHFA house price indices and related series. - [Stocks](https://www.agentdatasets.com/docs/rest/stocks.md): US public equity markets — fundamentals, filings, prices, and corporate actions sourced from SEC EDGAR and market data providers. ## Sources and terms - [Attribution](https://www.agentdatasets.com/docs/attribution.md): Publisher, license, attribution, and notices by source tag. - [Terms](https://www.agentdatasets.com/docs/terms.md): The current draft terms for using the service. ## Categories A category is advertised only once measured coverage, freshness, and evaluation evidence clear the launch bar; below-bar categories keep their registered tools, and those tools stay callable and documented. | Category | Key | Status | Tools | Coverage | | --- | --- | --- | --- | --- | | Banks | banks | advertised | 2 | US commercial bank financials and institution profiles from the FDIC BankFind Suite. | | CMBS | cmbs | in progress | 2 | Commercial mortgage-backed securities — deal registry and loan/property collateral detail from public SEC EDGAR ABS-EE EX-102 filings. | | Legal Entities | entities | in progress | 3 | GLEIF Legal Entity Identifier profiles and accounting-consolidation relationships from the Level-1 and Level-2 golden copies. | | FDA | fda | in progress | 2 | Drug application, product, and approval history for pilot US-listed biotech and pharmaceutical sponsors from Drugs@FDA. | | Funds | funds | in progress | 3 | SEC N-PORT fund holdings and N-PX proxy-voting records for registered investment funds. | | Futures | futures | in progress | 2 | Weekly CFTC Commitments of Traders positioning for curated financial-futures markets — Treasuries, SOFR, E-mini equity indices, and major FX — by trader category. | | Foreign Exchange | fx | advertised | 2 | Daily ECB euro reference rates and EUR-triangulated conversions. | | Geography | geo | advertised | 4 | Canonical US Census/OMB and Australian ABS ASGS geography identity, containment hierarchies, aliases, and official crosswalks. | | Federal spending | gov | in progress | 2 | US federal award recipients and obligation aggregates from USAspending — recipient registry, fiscal-year obligation trends, and top awarding agencies. | | Hazards | hazards | in progress | 3 | US natural-hazard risk — FEMA National Risk Index county and census-tract profiles, components, and rankings. | | Macro | macro | in progress | 4 | US macroeconomic time series — Treasury yields, BLS employment and inflation measures, and BEA national accounts. | | Platform | platform | advertised | 2 | Catalog and freshness metadata for the Agent Datasets platform. | | Real Estate | re | advertised | 4 | US housing and real-estate indicators — FHFA house price indices and related series. | | Stocks | stocks | in progress | 28 | US public equity markets — fundamentals, filings, prices, and corporate actions sourced from SEC EDGAR and market data providers. |