Gov Data MCP
Accesses geographic data from ArcGIS REST services, including state and local government datasets for crime, health, education, and more.
Retrieves broadband coverage data and provider information from the Federal Communications Commission.
Provides access to NASA's image library and scientific data including near-earth objects, space weather, and Mars rover information.
Enables searching of biomedical literature from PubMed database.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gov Data MCP What is the current federal funds rate?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gov Data MCP
MCP Server + TypeScript SDK for 114 Government Data APIs
562 tools covering federal, state, and international government data — economic, fiscal, health, education, energy, environment, legislative, financial, transportation, transit, traffic, safety, procurement, science, trade, case law, campaign finance, and more. All 50 states + DC represented.
40+ APIs require no key · The rest use free keys that take under a minute to get · Complete Tool Reference
Features
562 tools across 114 government data modules — federal agencies, state portals, transit systems, energy grids, and international sources
All 50 states + DC — generic Socrata + ArcGIS tools across 47 states, 15-state real-time 511 traffic, 12 transit systems, and state-specific APIs
Cross-referencing — built-in routing table guides the LLM to combine data from multiple agencies automatically
Code mode — WASM-sandboxed JavaScript execution reduces context window usage by 98–100% for large responses
Selective loading — load only what you need:
--modules fred,treasury,state-data,mbtaDual transport — stdio for desktop clients, HTTP Stream for web/remote
TypeScript SDK — every API is importable as a standalone typed client, no MCP required
Disk-backed caching — responses cached to disk, survives restarts
Rate limiting + retry — token-bucket rate limiter with exponential backoff on 429/503
Related MCP server: mcp-brasil
Quick Start
MCP Server
npx gov-data-mcpAdd to Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"gov-data": {
"command": "npx",
"args": ["-y", "gov-data-mcp"],
"env": {
"FRED_API_KEY": "your_key",
"DATA_GOV_API_KEY": "your_key"
}
}
}
}Add to VS Code / Copilot (.vscode/mcp.json):
{
"servers": {
"gov-data": {
"command": "npx",
"args": ["-y", "gov-data-mcp"],
"env": {
"FRED_API_KEY": "your_key",
"DATA_GOV_API_KEY": "your_key"
}
}
}
}Load Only Specific Modules
# Federal economic data only
npx gov-data-mcp --modules fred,treasury,bls,bea,eia
# State data only
npx gov-data-mcp --modules state-data,state-511,md-traffic,mbta,bart
# Everything (default)
npx gov-data-mcpHTTP Stream (for remote/web clients)
npx gov-data-mcp --transport httpStream --port 8080Example Prompts
Economic: "What's the current state of the U.S. economy? Show me GDP, unemployment, inflation, and interest rates."
Health: "Show me the adverse event profile for Ozempic including clinical trials, FDA reports, and pharma payments to doctors."
Legislative: "What happened with the Inflation Reduction Act? Who sponsored it, how did the vote break down by party?"
State data: "Compare Maryland and Virginia crime rates over the last 10 years."
Transit: "What are the current MBTA delays in Boston? Any service alerts?"
Traffic: "Show me current traffic incidents on Ohio highways."
Energy: "What's the current fuel mix on the Texas ERCOT grid? How much is wind vs natural gas?"
Environment: "What are the current reservoir levels in California? Any drought concerns?"
Cross-reference: "How has federal spending on healthcare changed over the last 5 years, and what health outcomes has it produced?"
TypeScript SDK
npm install gov-data-mcpimport { getObservations } from "gov-data-mcp/sdk/fred";
import { searchBills } from "gov-data-mcp/sdk/congress";
import { queryStateDataset } from "gov-data-mcp/sdk/state-data";
const gdp = await getObservations("GDP", { sort: "desc", limit: 5 });
const mdCrime = await queryStateDataset("MD", "jwfa-fdxs", { where: "year = '2023'" });No MCP server required. All functions include caching, retry, and rate limiting.
Data Sources (114 Modules, 562 Tools)
See TOOLS.md for complete tool reference with parameters and descriptions.
Federal — Economic (12 modules)
Module | Tools | Auth | Data |
| 4 | — | Fiscal data, debt, interest rates |
| 4 | Key | Federal Reserve economic time series |
| 4 | Key | Employment, CPI, labor statistics |
| 13 | Key | GDP, personal income, trade, I/O tables |
| 5 | Key | Energy production, consumption, prices |
| 3 | Key | Population, demographics, ACS data |
| 7 | Key | OSHA inspections, wage enforcement, UI claims |
| 2 | Key | Federal job listings |
| 2 | — | Broadband coverage and providers |
| 10 | Key | Patents, applications, PTAB decisions |
| 1 | — | Small business innovation research awards |
| 3 | — | GSA contract ceiling rates |
Federal — Health (8 modules)
Module | Tools | Auth | Data |
| 25 | Key | Drugs, devices, food, tobacco (OpenFDA) |
| 13 | — | Mortality, disease, COVID, obesity, PLACES |
| 10 | — | ClinicalTrials.gov studies |
| 4 | — | Hospital/nursing home quality, Medicare |
| 10 | — | Pharma payments to doctors (Sunshine Act) |
| 8 | Key | Biomedical literature search |
| 4 | — | NIH research projects and funding |
| 1 | Key | VA facilities (hospitals, clinics, cemeteries) |
Federal — Legislative (6 modules)
Module | Tools | Auth | Data |
| 71 | Key | Bills, votes, members, committees, CRS reports |
| 5 | — | Rules, executive orders, presidential docs |
| 3 | Key | Congressional record, CBO reports |
| 6 | Key | Regulations.gov dockets and comments |
| 5 | — | Lobbying disclosures, registrants |
| 3 | — | Code of Federal Regulations full text |
Federal — Financial (7 modules)
Module | Tools | Auth | Data |
| 6 | Key | Campaign finance, candidates, committees |
| 3 | — | EDGAR company filings and financials |
| 6 | — | Bank data, failures, financials |
| 6 | — | Consumer complaints |
| 6 | — | Home mortgage disclosure data |
| 5 | — | Futures trading positions |
| 5 | — | Sanctions and blocked persons |
Federal — Spending & Procurement (3 modules)
Module | Tools | Auth | Data |
| 6 | — | Federal awards, recipients, agency budgets |
| 3 | Key | Contract opportunities, entities, exclusions |
| 3 | — | GSA contract ceiling rates |
Federal — Environment & Science (16 modules)
Module | Tools | Auth | Data |
| 9 | — | Facilities, enforcement, Superfund, TRI, GHG |
| 3 | Key | Air quality monitoring stations |
| 4 | Key | Climate data, stations, weather history |
| 10 | — | Tides, currents, water levels |
| 12 | — | Space weather, solar storms |
| 15 | — | Forecasts, alerts, radar |
| 6 | — | Earthquakes, water data, stream gauges |
| 3 | Key | Solar, fuel stations, utility rates |
| 2 | — | Endangered species listings |
| 4 | Key | National parks, alerts, campgrounds |
| 3 | Key | Federal recreation facilities, campsites |
| 3 | — | Corps dam/reservoir/river water levels |
| 2 | — | NASA image library |
| 5 | Key | NEO, DONKI, Mars Rover, EONET |
| 3 | — | Asteroid orbits, close approaches, fireballs |
| 2 | — | Research awards and funding |
Federal — Safety (5 modules)
Module | Tools | Auth | Data |
| 11 | — | Vehicle recalls, complaints, safety ratings |
| 5 | — | Disaster declarations, assistance |
| 4 | — | Product safety recalls |
| 2 | Key | FTC enforcement actions |
| 2 | Key | CVE vulnerabilities, CVSS scores |
Federal — Other (9 modules)
Module | Tools | Auth | Data |
| 2 | — | Transportation accident investigations |
| 2 | — | Border crossings, transport statistics |
| 4 | — | METARs, TAFs, SIGMETs, PIREPs |
| 2 | Key | 11M+ museum collection records |
| 1 | — | DOE scientific publications |
| 9 | — | Nation's Report Card education scores |
| 4 | Key | College costs, outcomes, earnings |
| 3 | Key | Food nutrition data |
| 4 | Key | Agricultural statistics |
| 4 | — | International development indicators |
State & Local — Open Data (1 module, 30 states)
Module | Tools | Coverage |
| 15 | All 50 states + DC via Socrata SODA API + ArcGIS REST. Crime, health, education, economy, property, environment, transportation. MD fully populated (21 datasets), NY (13), CT (12), WA (8), TX (7), PA (7), NJ (4), + 40 more with GIS and/or Socrata portals. |
State & Local — Real-Time Traffic (2 modules, 15+ states)
Module | Tools | Coverage |
| 6 | 15 states: AZ, NV, UT, AK, ID, NY, CT, GA, WI, LA, AR, OH, NC, WA. Incidents, cameras, signs, weather, conditions. |
| 7 | Maryland CHART: incidents, closures, cameras, speeds, weather, DMS, travel times |
State & Local — Transit (12 modules)
Module | Tools | Auth | City/Region |
| 4 | Key | Boston (subway, bus, commuter rail, ferry) |
| 4 | — | Philadelphia (regional rail, bus, trolley) |
| 2 | Key | Chicago (L trains, buses) |
| 3 | Key | San Francisco Bay Area (BART rail) |
| 3 | — | Los Angeles (bus, rail) |
| 1 | Key | Portland (bus, MAX light rail, streetcar) |
| 2 | Key | Seattle / Puget Sound (bus, light rail) |
| 3 | Key | Washington State Ferries (schedules, vessels, terminals) |
| 1 | Key | Atlanta (rail) |
| 1 | — | NYC/NJ PATH train |
| 4 | Key | Washington DC Metro & Bus |
| 3 | Key | Maryland MTA (bus, light rail, metro, MARC) |
State & Local — Energy Grids (3 modules)
Module | Tools | Auth | Coverage |
| 1 | Token | California ISO (rates, GHG, Flex Alerts) |
| 2 | Key | Texas grid (load, prices) |
| 2 | Auth | New England (CT, MA, ME, NH, RI, VT) |
State & Local — Water & Environment (5 modules)
Module | Tools | Auth | Data |
| 2 | — | California reservoirs, rivers, snowpack |
| 1 | — | Active CA wildfire incidents (GeoJSON) |
| 3 | Key | Colorado water rights, streamflow, diversions |
| 3 | Key | Chesapeake Bay buoy water quality (CBIBS) |
| 3 | — | Minnesota 4,500+ lakes, fish surveys |
State & Local — Other (1 module)
Module | Tools | Auth | Data |
| 2 | — | NC 900+ demographic/economic data items |
API Keys
Most tools work without any API key. For those that need one, keys are free:
Key | Used By | Get It |
| FDA, Congress, FBI, FEC, GovInfo, Regulations, NREL, College Scorecard, USDA FoodData, FTC | |
| FRED | |
| State open data (all Socrata states) | Register on any state portal |
| Census | |
| BEA | |
| NASA Science | api.nasa.gov (DEMO_KEY works without signup) |
| National Park Service |
See the full list with npx gov-data-mcp --list-modules.
Disclaimer
This project integrates a significant number of government APIs, many of which have large, complex, or inconsistently documented schemas. AI is used as a tool throughout this project to help parse API documentation, generate type definitions, and scaffold tool implementations — making it possible to cover this much surface area and get people access to government data faster than would otherwise be feasible. While every effort has been made to ensure accuracy, some endpoints may return unexpected results, have incomplete parameter coverage, or behave differently than documented.
This is a community-driven effort — if you find something that's broken or could be improved, please open an issue or submit a PR. The goal is to make government data as accessible and reliable as possible, together.
All data is sourced from official U.S. government, state, and international APIs — the server does not generate, modify, or editorialize any data.
License
MIT
Available Tools
563 toolsbart_advisoriesARead-only
Get service advisories for BART (San Francisco Bay Area). Returns current service alerts, delays, and planned disruptions.
Inputs: no named parameters.
bart_departuresARead-only
Get real-time departure estimates for a BART (San Francisco Bay Area) station. Returns estimated departure times, platform, direction, train length, and color. Station abbreviations are 4 letters (e.g. 'EMBR' for Embarcadero, '12TH' for 12th St Oakland, 'ALL' for all stations).
Inputs: station (required).
bart_stationsARead-only
List all BART (San Francisco Bay Area) stations. Returns station names, abbreviations, addresses, and coordinates.
Inputs: no named parameters.
bea_dataset_infoARead-only
Discover BEA datasets, parameters, and valid parameter values. Essential for exploring the BEA API before making data requests.
Actions:
list_datasets: List all available BEA datasets
list_parameters: List parameters for a dataset (requires dataset_name)
get_values: Get valid values for a parameter (requires dataset_name + parameter_name)
get_filtered_values: Get values filtered by other params (requires dataset_name + target_parameter + filters)
Datasets: NIPA, NIUnderlyingDetail, FixedAssets, MNE, GDPbyIndustry, Regional, ITA, IIP, InputOutput, UnderlyingGDPbyIndustry, IntlServTrade
Inputs: action (required), filters, dataset_name, parameter_name, +1 more.
bea_fixed_assetsARead-only
Get Fixed Assets data — net stock, depreciation, and investment tables.
Covers private/government fixed assets, equipment, structures, and IP products. Annual data only, updated once per year (late August – early October).
Common tables: FAAt101 (current-cost net stock by type), FAAt201 (private equipment), FAAt401 (private nonresidential by industry), FAAt801 (current-cost depreciation). Use bea_dataset_info to discover all table names.
Inputs: year, table_name.
bea_gdp_by_industryARead-only
Get GDP contribution by industry sector nationally from BEA GDPbyIndustry dataset.
TableID options:
1: Value added by industry (default)
5: Contributions to percent change in real GDP
6: Value added percent shares
25: Real value added by industry
Industry='ALL' returns all sectors.
Inputs: year, industry, table_id, frequency.
bea_gdp_by_stateARead-only
Get gross domestic product for U.S. states from BEA Regional dataset.
Table options:
SAGDP1: State annual GDP summary (default)
SAGDP9: Real GDP by state
SQGDP1: State quarterly GDP summary
GeoFips: 'STATE' for all states, or 5-digit FIPS (e.g. '06000' for CA)
Inputs: year, geo_fips, line_code, table_name.
bea_gdp_nationalARead-only
Get U.S. national GDP data from the NIPA tables. Shows GDP, GDP growth, components (consumption, investment, government, net exports), and deflators.
Common table names:
T10101: GDP and major components (real)
T10106: GDP and major components (nominal)
T10111: GDP percent change
T20100: Personal income and its disposition
T30100: Government receipts and expenditures
Inputs: year, frequency, table_name.
bea_input_outputARead-only
Get Input-Output statistics — Make Tables, Use Tables, and Requirements tables.
Shows interrelationships between U.S. producers and users.
Use bea_dataset_info (action='get_values', dataset_name='InputOutput', parameter_name='TableID') to discover available table IDs.
Inputs: year (required), table_id (required).
bea_international_investmentARead-only
Get U.S. international investment position (IIP) data.
Shows end-of-period accumulated stocks of U.S. financial assets and liabilities.
TypeOfInvestment examples:
FinAssetsExclFinDeriv: U.S. assets excl derivatives (default)
FinLiabsExclFinDeriv: U.S. liabilities excl derivatives
DirInvAssets: Direct investment assets
FinLiabsFoa: Liabilities to foreign official agencies
Component: 'Pos' (position), 'ChgPosTrans' (change from transactions), 'ChgPosPrice' (from price changes), 'ChgPosXRate' (from exchange rates)
Inputs: year, component, frequency, type_of_investment.
bea_international_transactionsARead-only
Get U.S. international transactions (balance of payments) data.
Tracks all transactions between U.S. and foreign residents: goods/services trade, current account, financial account, capital transfers.
Indicator examples:
BalGds: Balance on goods (default)
BalServ: Balance on services
BalCurAcct: Current account balance
ExpGds/ImpGds: Exports/Imports of goods
PfInvAssets: Portfolio investment assets
Frequency: A=annual, QSA=quarterly seasonally adjusted, QNSA=not adjusted
Inputs: year, frequency, indicator, area_or_country.
bea_intl_services_tradeARead-only
Get U.S. international trade in services data (annual).
IMPORTANT: BEA requires either a specific TypeOfService or a specific AreaOrCountry. You cannot use 'All' for both simultaneously.
TypeOfService: 'All' (default), or specific: 'Telecom', 'Travel', 'Transport', 'Insurance', 'Financial', 'Comp', 'ChargesForTheUseOfIpNie', etc. Use bea_dataset_info to discover all values.
TradeDirection: 'All' (default), 'Exports', 'Imports', 'Balance', 'SupplementalIns'
Affiliation: 'All' (default), 'AllAffiliations', 'Affiliated', 'Unaffiliated', 'UsParents', 'UsAffiliates'
Inputs: year, affiliation, area_or_country, trade_direction, +1 more.
bea_multinational_enterprisesARead-only
Get data on Direct Investment (DI) and Activities of Multinational Enterprises (AMNE).
DirectionOfInvestment (required):
'Outward': U.S. investment abroad / foreign affiliates
'Inward': Foreign investment in U.S. / U.S. affiliates
'State': U.S. affiliates at state level (AMNE only)
'Parent': U.S. parent enterprises (AMNE only)
Classification (required): 'Country', 'Industry', 'CountryByIndustry'
For AMNE stats, also set ownership_level ('0'=majority-owned, '1'=all) and non_bank_affiliates_only ('0'=both, '1'=nonbank only).
Inputs: year (required), classification (required), direction_of_investment (required), state, +5 more.
bea_nipa_underlying_detailARead-only
Get NIPA underlying detail data — more granular national account breakdowns.
BEA caution: these detailed estimates are lower quality than published aggregates.
Common tables: U20305 (PCE current $), U70205S (auto sales/production monthly), U001A (GDP), U20304 (PCE by type). Use bea_dataset_info to discover all tables.
Inputs: year, frequency, table_name.
bea_personal_incomeARead-only
Get personal income data by state from BEA Regional dataset.
Table options:
SAINC1: Personal income summary (income, population, per capita) — default
SAINC3: Per capita personal income only
SAINC4: Personal income by major component (wages, dividends, transfers)
LineCode for SAINC1: 1=personal income, 2=population, 3=per capita income (default) LineCode for SAINC4: 1=total, 50=wages, 45=dividends/interest/rent, 47=transfer receipts
Inputs: year, geo_fips, line_code, table_name.
bea_underlying_gdp_by_industryARead-only
Get Underlying GDP by Industry — more industry detail than the main GDPbyIndustry dataset.
Annual data only, starting from 1997. BEA caution: quality of these detailed estimates is lower than published aggregates.
Use bea_dataset_info to discover valid TableIDs and Industry codes.
Inputs: year, industry, table_id.
bls_cpi_breakdownARead-only
Get a breakdown of Consumer Price Index by component — food, shelter, energy, medical care, transportation, etc. Shows which categories are driving inflation.
Inputs: end_year, start_year.
bls_employment_by_industryARead-only
Get employment numbers broken down by major industry sector. Shows which sectors are growing or shrinking.
Inputs: end_year, start_year.
bls_search_seriesARead-only
Look up popular BLS series IDs by topic. BLS doesn't have a search API, so this provides curated series IDs for common topics.
Topics: employment, unemployment, wages, cpi, cpi_components, ppi, productivity, jolts, state_employment
Inputs: topic (required), state.
bls_series_dataARead-only
Fetch time series data from the Bureau of Labor Statistics. Returns monthly/quarterly/annual observations for employment, wages, prices, and more.
Popular series IDs:
CES0000000001: Total nonfarm employment (thousands)
LNS14000000: Unemployment rate
CUUR0000SA0: CPI-U All Items
CES0500000003: Average hourly earnings, total private
JTS000000000000000JOR: Job openings rate (JOLTS)
PRS85006092: Nonfarm business labor productivity
Series ID prefixes: CES (jobs by industry), LNS (unemployment), CU (CPI), WP (PPI), OE (wages), JT (JOLTS)
Inputs: series_ids (required), end_year, start_year.
bts_border_crossingsARead-only
Get border crossing data at U.S. ports of entry: trucks, personal vehicles, pedestrians, train passengers, containers. Covers U.S.-Mexico and U.S.-Canada borders. Monthly data by port, state, and measure type.
Inputs: limit, state, border, measure, +1 more.
bts_transport_statsARead-only
Get Monthly Transportation Statistics — 50+ national indicators including: • Airline passenger traffic and on-time performance % • Transit ridership, highway vehicle miles • Rail freight, Amtrak ridership and on-time % • Truck tonnage, fuel prices, vehicle sales • Transportation Services Index (freight, passenger, combined) • Border crossing summaries (trucks, persons) • Safety fatalities (air, rail) Monthly data going back to 1947 for some series.
Inputs: limit, end_date, start_date.
caiso_signalARead-only
Get California ISO real-time grid signals — time-varying electricity rates, greenhouse gas (GHG) emission intensity, or Flex Alert demand response signals.
Signal types:
rates: Time-varying electricity rates
GHG: Greenhouse gas emission signal (carbon intensity)
FlexAlert: Active Flex Alert signals (grid stress / demand response events)
Inputs: signal_type (required).
calc_contract_ratesARead-only
Get all ceiling rates for a specific GSA MAS contract by its contract number (IDV PIID). Shows all labor categories and rates awarded under that contract.
Inputs: contract_number (required), page_size.
calc_search_ratesARead-only
Search GSA CALC+ ceiling rates for federal labor categories. Find awarded hourly rates on GSA MAS professional services contracts. Search by keyword (wildcard across labor category, vendor, contract), exact field match, or browse with filters. Useful for market research, IGCEs, and competitive pricing. Data refreshed daily.
Inputs: sin, page, sort, search, +12 more.
calc_suggestARead-only
Autocomplete/suggest values for labor categories, vendor names, or contract numbers in GSA CALC+ data. Useful for finding exact values to use in calc_search_rates. Uses 'contains' matching (2 char min).
Inputs: field (required), prefix (required).
calfire_incidentsARead-only
Get California wildfire incidents from CAL FIRE — active fires or historical incidents by year.
Returns incident details including name, location, county, acres burned, containment %, structures damaged/destroyed, injuries, fatalities, and GeoJSON boundaries.
Active fires update frequently during fire season (May-November).
Inputs: year, active.
cdc_birth_indicatorsARead-only
Get quarterly provisional birth indicators: fertility rates, teen birth rates, \npreterm birth rates, cesarean delivery rates, low birthweight — by race/ethnicity.\nTopics: 'General Fertility', 'Teen Birth', 'Preterm', 'Cesarean', 'Low Birthweight', 'NICU', 'Medicaid'
Inputs: limit, topic, race_ethnicity.
cdc_causes_of_deathARead-only
Get leading causes of death in the U.S. by state and year. Data from 1999–2017. Causes include heart disease, cancer, kidney disease, etc.
Inputs: year, limit, state.
cdc_covidARead-only
Get COVID-19 weekly case and death counts by state (data through early 2023). States use two-letter abbreviations: 'NY', 'CA', 'TX'.
Inputs: limit, state.
cdc_death_rates_historicalARead-only
Get age-adjusted death rates for major causes since 1900.\nCauses: 'Heart Disease', 'Cancer', 'Stroke', 'Unintentional injuries', 'CLRD' (chronic lower respiratory diseases).\nGreat for long-term trend analysis — 120+ years of data.
Inputs: cause, limit, end_year, start_year.
cdc_disabilityBRead-only
Get disability prevalence by state and type from BRFSS survey. Types: 'Any Disability', 'Mobility Disability', 'Cognitive Disability', 'Hearing Disability', 'Vision Disability', 'Self-care Disability', 'Independent Living Disability', 'No Disability'
Inputs: limit, state, disability_type.
cdc_drug_overdoseARead-only
Get drug poisoning/overdose mortality by state (1999–2016).\nIncludes death rates by state, sex, race, and age group. Critical for opioid crisis analysis.
Inputs: sex, year, limit, state.
cdc_life_expectancyARead-only
Get U.S. life expectancy at birth by race and sex (1900–2018). Races: 'All Races', 'Black', 'White'. Sex: 'Both Sexes', 'Male', 'Female'. Note: Data goes through 2018. For more recent mortality trends, use cdc_mortality_rates.
Inputs: sex, race, year, limit.
cdc_mortality_ratesARead-only
Get provisional age-adjusted death rates by cause, sex, and state (quarterly, 2020–present). Causes: 'All causes', 'Heart disease', 'Cancer', 'COVID-19', 'Drug overdose', 'Suicide', etc. Returns rate_overall, rate_sex_female, rate_sex_male, and per-state rates.
Inputs: cause, limit, quarter, rate_type.
cdc_nutrition_obesityARead-only
Get adult obesity, physical inactivity, and fruit/vegetable consumption by state from BRFSS.\nTopics: 'Obesity', 'Physical Activity', 'Fruits and Vegetables'. Data by state, race, age, income, education.
Inputs: limit, state, topic.
cdc_places_cityARead-only
Get city-level health indicators from CDC PLACES — obesity, diabetes, smoking, depression, sleep, blood pressure, mental health, and 30+ more measures for every U.S. city with population > 50,000. Each row contains ALL measures for a city as separate columns (e.g. obesity_crudeprev, diabetes_crudeprev).
Inputs: city, limit, state.
cdc_places_healthARead-only
Get county-level health indicators from CDC PLACES (BRFSS-based estimates). Measures: OBESITY, DIABETES, CSMOKING (smoking), BINGE (binge drinking), BPHIGH (high BP), DEPRESSION, SLEEP (short sleep), CHD (heart disease), COPD, CANCER, STROKE, ARTHRITIS, CASTHMA (asthma), MHLTH (mental distress), PHLTH (physical distress), LPA (physical inactivity), ACCESS2 (no health insurance), DENTAL, CHECKUP, KIDNEY, HIGHCHOL, TEETHLOST, FOODINSECU (food insecurity), LONELINESS, HOUSINSECU (housing insecurity) Returns crude prevalence (%) by county.
Inputs: limit, state, measure.
cdc_queryARead-only
Custom query against any CDC dataset using SODA syntax. Datasets: bi63-dtpu (death 1999–2017), w9j2-ggv5 (life expectancy), 489q-934x (mortality rates), swc5-untb (PLACES county), dxpw-cm5u (PLACES city), pwn4-m3yp (COVID), r8kw-7aab (weekly deaths), s2qv-b27b (disability), xbxb-epbu (drug overdose), hn4x-zwk7 (nutrition/obesity), 6rkc-nb2q (historical death rates), 76vv-a7x8 (birth indicators)
Inputs: dataset_id (required), group, limit, order, +2 more.
cdc_weekly_deathsARead-only
Get weekly provisional death counts by state — COVID-19, pneumonia, influenza, and total deaths. THIS IS THE MOST CURRENT CDC MORTALITY DATA — updated weekly, covers 2020–present. Includes percent_of_expected_deaths to detect excess mortality.
Inputs: year, limit, state.
cdec_sensor_dataARead-only
Get real-time sensor data from California Data Exchange Center (CDEC) monitoring stations.
Common sensor numbers:
15: Storage (acre-feet, for reservoirs)
6: Reservoir elevation (feet)
20: Flow (CFS — cubic feet per second)
3: Snow water content (inches)
30: Temperature (degrees F)
2: Precipitation (accumulated inches)
Common station IDs: SHA (Shasta), ORO (Oroville), FOL (Folsom), DNP (Don Pedro), NML (New Melones), BUL (Lake Bullards Bar)
Inputs: sensor_num (required), station_id (required), end, start, +1 more.
cdec_stationsARead-only
Get metadata for CDEC monitoring stations — location, operator, river basin, and available sensors. Use this to find station IDs before querying sensor data.
Inputs: station_id (required).
census_populationARead-only
Get population data for U.S. states using the American Community Survey. Quick shortcut — for more flexibility use census_query directly.
Inputs: year, state.
census_queryARead-only
Query the U.S. Census Bureau Data API. Supports ACS, Decennial Census, Population Estimates, Economic Census, and more. Returns data for specified variables and geography.
Common datasets: '2023/acs/acs1' (1yr), '2023/acs/acs5' (5yr), '2020/dec/pl' (Decennial), '2023/pep/population' Common variables: NAME, B01001_001E (population), B19013_001E (median income), B25077_001E (home value), B01002_001E (median age)
Inputs: dataset (required), for_geo (required), variables (required), in_geo.
census_search_variablesARead-only
Search for Census variable names/codes by keyword. Helps discover what data is available in a given dataset. Returns variable IDs you can use with census_query.
Inputs: dataset (required), keyword (required), max_results.
cfpb_complaint_aggregationsARead-only
Get complaint counts grouped by a field (product, company, state, issue, etc.). Useful for ranking companies by complaint volume, identifying top issues, or comparing states. Aggregation fields: 'product', 'company', 'state', 'issue', 'company_response', 'timely', 'submitted_via', 'tags'.
Inputs: field (required), issue, state, company, +3 more.
cfpb_complaint_detailARead-only
Get full details for a specific complaint by its Complaint ID. Returns all fields: product, issue, company, narrative (if consented), response, dates, etc.
Inputs: complaint_id (required).
cfpb_complaint_trendsARead-only
Get complaint trends over time using the CFPB Trends API. Uses dedicated /trends endpoint with lens-based aggregation. REQUIRED: trend_interval ('month', 'quarter', or 'year') — the API rejects requests without it. Lens options: 'overview' (total counts), 'product' (by product), 'issue' (by issue), 'tags' (by tag). Sub-lens allows drilling into sub-categories within the lens.
Inputs: trend_interval (required), lens, focus, issue, +7 more.
cfpb_search_complaintsARead-only
Search the CFPB consumer complaint database (13M+ records). Find complaints by company, product, state, issue, date, or keyword. Returns individual complaints with company responses. Company names auto-retry with fuzzy search if exact match fails (e.g. 'Wells Fargo' will find 'WELLS FARGO & COMPANY'). Products: 'Mortgage', 'Debt collection', 'Credit card or prepaid card', 'Checking or savings account', 'Student loan', 'Vehicle loan or lease', 'Credit reporting, credit repair services, or other personal consumer reports'.
Inputs: size, sort, tags, issue, +10 more.
cfpb_state_complaintsARead-only
Get complaint information broken down by state (geographic view). Returns complaint counts and data for each state. Useful for maps and state comparisons. Applies the same filters as search (product, company, date, etc.).
Inputs: tags, issue, company, product, +2 more.
cfpb_suggest_companyARead-only
Autocomplete/suggest company names from the CFPB complaint database. Useful for finding the exact company name before searching complaints.
Inputs: text (required), size.
cftc_cot_citARead-only
Get Supplemental Commodity Index Trader (CIT) report data from CFTC. Supplements the Legacy report with positions of Commodity Index Traders. Covers 13 selected agricultural commodity markets only.
Inputs: limit, offset, market_name.
cftc_cot_disaggregatedARead-only
Get Disaggregated Commitments of Traders (COT) report data from CFTC. Breaks positions into: Producer/Merchant/Processor/User, Swap Dealers, Managed Money, Other Reportables. More granular than Legacy report. Covers physical commodities (not financial futures).
Inputs: limit, offset, market_name, futures_only.
cftc_cot_legacyARead-only
Get Legacy Commitments of Traders (COT) report data from CFTC. Shows commercial vs non-commercial (speculative) positions in futures markets. Covers all U.S. futures exchanges: commodities, financials, currencies. Use futures_only=true for futures-only, false for combined futures+options.
Inputs: limit, offset, market_name, futures_only.
cftc_cot_tffARead-only
Get Traders in Financial Futures (TFF) report data from CFTC. Covers financial futures only: Dealer/Intermediary, Asset Manager/Institutional, Leveraged Funds, Other Reportables. Use for S&P 500, Treasury bonds, Eurodollars, VIX, currency futures.
Inputs: limit, offset, market_name, futures_only.
cftc_productsARead-only
List available products and markets tracked by CFTC. Use to discover market names before querying COT reports. Search by keyword to find specific commodities, currencies, or financial instruments.
Inputs: search.
cisa_kev_listARead-only
Get CISA Known Exploited Vulnerabilities with mandatory federal remediation deadlines. Returns all actively exploited CVEs in the catalog. Each entry includes CVE ID, vendor, product, description, required action, due date, and ransomware usage. Optional filters narrow results by vendor, product, or date range.
Inputs: vendor, product, ransomware_only, date_added_after, +1 more.
clear_cacheA
Clear cached API responses to force fresh data on next query. Specify a source name or omit to clear all.
Inputs: source.
clinical_trials_by_locationARead-only
Search for clinical trials near a geographic location. Uses the ClinicalTrials.gov geo-distance filter to find trials within a radius of a latitude/longitude point. Combine with condition or intervention filters to find specific trials nearby.
Inputs: latitude (required), longitude (required), status, distance, +3 more.
clinical_trials_detailARead-only
Get full details for a specific clinical trial by NCT ID. Returns protocol, eligibility, arms/interventions, design, locations, contacts, and oversight info. Use the fields param to request only specific sections (reduces response size).
Inputs: nct_id (required), fields.
clinical_trials_enumsARead-only
List all valid enum values for ClinicalTrials.gov data fields. Returns every enum type (Status, Phase, StudyType, InterventionType, etc.) with all valid values. Use as a reference when building search filters or understanding field values.
Inputs: enum_type.
clinical_trials_field_sizesARead-only
Get statistics on list/array field sizes in the ClinicalTrials.gov database. Shows min/max/top sizes for array fields like Condition, Intervention, Phase. Useful for understanding data distribution.
Inputs: fields.
clinical_trials_field_valuesARead-only
Get value statistics for study data fields — top values, counts, and distributions. Powerful analytics tool: find top conditions, top sponsors, phase distributions, intervention type counts. Examples: fields='Phase' shows trial count by phase; fields='Condition' shows top conditions.
Inputs: fields (required), types.
clinical_trials_metadataARead-only
Explore the ClinicalTrials.gov study data model — field names, types, and descriptions.
Use to discover available fields for the fields parameter in search/detail tools,
or to build advanced filter expressions with AREA[] syntax.
Inputs: include_indexed_only, include_historic_only.
clinical_trials_resultsARead-only
Get posted results for a completed clinical trial by NCT ID. Returns outcome measures, adverse events (serious + other), participant flow, and baseline characteristics. Only works for trials where hasResults=true. Use clinical_trials_search with agg_filters='results:with' to find them.
Inputs: nct_id (required).
clinical_trials_searchARead-only
Search ClinicalTrials.gov for clinical trials by condition, drug/intervention, sponsor, status, phase, study type, location, title, or free text. Returns trial ID, title, status, phase, sponsor, conditions, enrollment, and hasResults flag. Use sponsor filter to track pharma company research (e.g. 'Pfizer', 'Moderna', 'NIH'). Use filter_advanced for Essie expressions like 'AREA[StartDate]RANGE[2024-01-01,MAX]'. Use agg_filters for shorthand filters: 'results:with', 'sex:f', 'healthy:y'.
Inputs: sort, phase, query, status, +13 more.
clinical_trials_size_statsARead-only
Get database statistics: total study count, average study JSON size, size distribution, and largest studies. Quick overview of the ClinicalTrials.gov database scope and data volume.
Inputs: no named parameters.
clinical_trials_statsARead-only
Get trial count breakdown by recruitment status for a condition or drug/intervention. Shows how many trials are recruiting, active, completed, terminated, etc. Works for diseases ('breast cancer') AND drug names ('semaglutide', 'pembrolizumab'). Queries 8 statuses in parallel for comprehensive breakdown.
Inputs: condition (required), search_as_drug.
cms_hospitalsARead-only
Query CMS hospital data: general info, quality ratings, mortality, readmissions, infections, patient surveys, Medicare spending. Filter by state or city.
Inputs: city, limit, state, dataset.
cms_nursing_homesARead-only
Query CMS nursing home data: provider info with five-star ratings, quality measures, health deficiencies/citations. Filter by state.
Inputs: limit, state, dataset.
cms_queryARead-only
General-purpose query against any CMS provider dataset by dataset identifier. Use cms_search to find available datasets and their IDs. Supports filtering by any field.
Inputs: dataset_id (required), limit, offset, filter_field, +1 more.
cms_searchARead-only
Search for CMS provider data datasets by keyword. Returns dataset IDs, titles, and descriptions. Use the ID with cms_query to fetch data.
Inputs: keyword (required).
code_modeARead-only
Run a JavaScript processing script against any tool's output in a WASM sandbox.
Calls the specified tool first, then runs your script with the raw response as DATA (string).
Only your script's console.log() output enters context — typically 65-99% smaller.
USE THIS when you need specific fields, counts, or filters from a large response. DO NOT use this when you need to read and interpret the full data for cross-referencing or analysis.
The script can: JSON.parse(DATA), use loops/map/filter/reduce, Math, string ops, console.log(). The script CANNOT: access files, network, Node.js APIs, or import modules.
Example — count serious reactions for a drug: tool='fda_drug_events', tool_args={"search":"patient.drug.openfda.brand_name:aspirin","limit":100}, code='const d=JSON.parse(DATA);const data=d.data||d;const items=data.items||data.results||[];' + 'const counts={};items.forEach(r=>{const rxs=r.reactions||[];rxs.forEach(rx=>{counts[rx]=(counts[rx]||0)+1})});' + 'Object.entries(counts).sort((a,b)=>b[1]-a[1]).slice(0,10).forEach(([k,v])=>console.log(k+": "+v))'
Inputs: code (required), tool (required), tool_args.
congress_amendment_amendmentsARead-only
Get sub-amendments to a specific amendment. Shows amendments that modify the parent amendment.
Inputs: congress (required), amendment_type (required), amendment_number (required), limit.
congress_amendment_cosponsorsARead-only
Get cosponsors of a specific amendment. Shows party affiliation and sponsorship details.
Inputs: congress (required), amendment_type (required), amendment_number (required), limit.
congress_amendment_detailsBRead-only
Get detailed information about a specific amendment, including its actions/timeline. Requires congress number, amendment type (hamdt/samdt), and amendment number.
Inputs: congress (required), amendment_type (required), amendment_number (required).
congress_amendmentsARead-only
Search/list amendments by congress and optional type (hamdt = House, samdt = Senate, suamdt = Senate Unnumbered). Returns amendment number, type, sponsor, purpose, and status.
Inputs: limit, congress, toDateTime, fromDateTime, +1 more.
congress_amendment_textARead-only
Get text versions for a specific amendment (from 117th Congress onwards). Returns version types and format URLs (PDF, HTML).
Inputs: congress (required), amendment_type (required), amendment_number (required).
congress_bill_actionsARead-only
Get the full action history / timeline for a bill — every step from introduction through committee, floor votes, amendments, and signing. Shows recorded roll-call vote numbers when available.
Use congress_search_bills first to find the congress number, bill type, and bill number.
Inputs: congress (required), bill_type (required), bill_number (required), limit.
congress_bill_amendmentsARead-only
Get amendments filed on a specific bill. Shows amendment sponsors, purposes, and status. Critical for tracking how bills are modified (e.g., 'gutted and replaced').
Inputs: congress (required), bill_type (required), bill_number (required), limit.
congress_bill_committeesARead-only
Get committees a bill was referred to, with activity dates. Shows which committees had jurisdiction and what actions they took (referral, hearings, markup, reporting).
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bill_cosponsorsARead-only
Get the full list of cosponsors for a bill with party affiliation and sponsorship dates. Returns individual cosponsor details unlike congress_bill_details which only provides a party breakdown summary.
Inputs: congress (required), bill_type (required), bill_number (required), sort, +1 more.
congress_bill_detailsARead-only
Get detailed information about a specific bill including sponsors, cosponsors with party breakdown, actions, committees, and current status.
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bill_full_profileARead-only
Get a COMPLETE bill profile in ONE call — combines bill details, all cosponsors (with party breakdown), full action timeline, CRS summaries, committees, legislative subjects, text versions, related bills, and all titles. Fetches 8 endpoints in parallel. Use this instead of calling congress_bill_details + congress_bill_actions + congress_bill_summaries + congress_bill_committees + congress_bill_subjects + congress_bill_text + congress_bill_related + congress_bill_titles individually.
Ideal for: Complete legislative analysis, bill research, accountability investigations, or getting everything needed to cross-reference with FEC (who funded the sponsors), lobbying_search (who lobbied), and FRED (economic impact after passage).
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bill_subjectsARead-only
Get legislative subjects tagged on a bill, plus the primary policy area. Useful for finding all bills on a topic and for cross-referencing with lobbying data.
Inputs: congress (required), bill_type (required), bill_number (required), limit.
congress_bill_summariesARead-only
Get CRS (Congressional Research Service) summaries of a bill. These are plain-English, non-partisan summaries written by CRS analysts. Multiple versions may exist (as introduced, as reported, as passed).
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bill_textARead-only
Get available text versions for a bill (e.g., introduced, reported, engrossed, enrolled). Returns version types and format URLs. For full bill text content, use govinfo_bill_text.
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bill_titlesARead-only
Get all titles for a bill — short titles, official titles, display titles, and titles as they appeared in different text versions. Useful for finding the popular name of legislation (e.g., 'Inflation Reduction Act').
Inputs: congress (required), bill_type (required), bill_number (required), limit.
congress_bill_votesARead-only
Find ALL roll-call votes on a specific bill and fetch the party-line breakdowns — the KEY tool for 'follow the money' investigations. Scans the bill's action timeline for recorded vote references, then fetches each House and Senate vote with member-level results and party tallies.
This is the critical bridge between legislation and accountability: • Bill → Votes (this tool) • Votes → Who voted how (party tallies returned here) • Who voted → Who funded them (fec_candidate_financials / fec_committee_disbursements) • Who lobbied → lobbying_search
Returns all House and Senate roll-call votes associated with the bill, with full party breakdowns.
Inputs: congress (required), bill_type (required), bill_number (required).
congress_bound_congressional_recordARead-only
Get bound Congressional Record issues — the permanent, final publication of proceedings. Filter by year, month, and day.
Inputs: day, year, limit, month.
congress_committee_billsARead-only
Get bills referred to a specific committee. Use congress_committees to find the committee system code. Useful for tracking which bills die in committee vs. get reported out.
Inputs: chamber (required), committee_code (required), limit.
congress_committee_detailsBRead-only
Get detailed information about a specific congressional committee by chamber and committee code. Returns full history, website URL, subcommittees, bill/report counts, and related communications.
Inputs: chamber (required), committee_code (required).
congress_committee_details_by_congressARead-only
Get detailed information about a committee filtered by a specific congress number. Shows membership for that specific congress vs. all-time details from congress_committee_details.
Inputs: chamber (required), congress (required), committee_code (required).
congress_committee_full_profileARead-only
Get a COMPLETE committee profile in ONE call — combines committee details (history, subcommittees, website), recent bills referred, recent reports published, and recent nominations referred (4 endpoints in parallel). Use this instead of calling congress_committee_details + congress_committee_bills + congress_committee_reports_for_committee + congress_committee_nominations_for_committee individually.
Ideal for: Understanding a committee's jurisdiction, workload, and oversight activity. Cross-reference committee chair (from congress_member_details) with FEC donors and lobbying_search.
Inputs: chamber (required), committee_code (required), limit.
congress_committee_house_communicationsARead-only
Get House communications referred to a specific House committee.
Inputs: committee_code (required), limit.
congress_committee_meeting_detailsARead-only
Get detailed information about a specific committee meeting including title, committees, witnesses, meeting documents, related bills, and video links.
Inputs: chamber (required), congress (required), event_id (required).
congress_committee_meetingsARead-only
List committee meetings (hearings, markups, etc.) with dates, locations, and topics. Filter by congress and chamber.
Inputs: limit, chamber, congress, toDateTime, +1 more.
congress_committee_nominations_for_committeeARead-only
Get nominations referred to a specific committee. Useful for tracking judicial or agency head nominations before a particular Senate committee.
Inputs: chamber (required), committee_code (required), limit.
congress_committee_print_detailsARead-only
Get details about a specific committee print by congress, chamber, and jacket number.
Inputs: chamber (required), congress (required), jacket_number (required).
congress_committee_printsARead-only
List committee prints — publications ordered by committees that are not committee reports. Often include Rules Committee prints with bill text for floor consideration.
Inputs: limit, chamber, congress, toDateTime, +1 more.
congress_committee_print_textARead-only
Get text versions for a committee print. Returns formatted text and PDF URLs.
Inputs: chamber (required), congress (required), jacket_number (required).
congress_committee_report_detailsBRead-only
Get detailed information about a specific committee report, including associated bills, title, issue date, and text versions.
Inputs: congress (required), report_type (required), report_number (required).
congress_committee_reportsARead-only
List committee reports — formal reports accompanying legislation reported out of committee. Filter by congress, report type (hrpt/srpt/erpt), and conference report flag. Critical for understanding committee intent and legislative history.
Inputs: limit, congress, conference, toDateTime, +2 more.
congress_committee_reports_for_committeeARead-only
Get reports published by a specific committee. Shows formal committee reports accompanying legislation — use congress_committees to find the committee system code.
Inputs: chamber (required), committee_code (required), limit, toDateTime, +1 more.
congress_committee_report_textARead-only
Get text versions for a committee report. Returns formatted text and PDF URLs.
Inputs: congress (required), report_type (required), report_number (required).
congress_committeesARead-only
List congressional committees. Filter by congress number and/or chamber (house, senate, joint). Returns committee name, system code, and chamber.
Inputs: limit, chamber, congress, toDateTime, +1 more.
congress_committee_senate_communicationsARead-only
Get Senate communications referred to a specific Senate committee.
Inputs: committee_code (required), limit.
congress_congressional_recordARead-only
Get Congressional Record issues — the official daily record of debate, speeches, and proceedings in Congress. Filter by year, month, and day.
Inputs: day, year, limit, month.
congress_crs_report_detailsARead-only
Get detailed information about a specific CRS report by report number/ID. Returns full summary, authors, topics, related legislation, and format links (PDF, etc.).
Inputs: report_number (required).
congress_crs_reportsCRead-only
Get Congressional Research Service reports — authoritative, nonpartisan analysis on legislative topics. CRS reports are considered the gold standard for policy research.
Inputs: limit, toDateTime, fromDateTime.
congress_daily_congressional_recordARead-only
Get daily Congressional Record issues with sections (Senate, House, Extensions of Remarks, Daily Digest). Filter by volume and issue number for specific issues, or list recent issues.
Inputs: limit, issue_number, volume_number.
congress_hearing_detailsBRead-only
Get detailed information about a specific hearing including title, date, committees, associated meeting, citation, and available text formats.
Inputs: chamber (required), congress (required), jacket_number (required).
congress_hearingsARead-only
List congressional hearings. Filter by congress and chamber. Hearings are formal proceedings where committees gather testimony from witnesses.
Inputs: limit, chamber, congress.
congress_house_communication_detailsARead-only
Get detailed information about a specific House communication including abstract, committees, submitting agency, and legal authority.
Inputs: congress (required), communication_type (required), communication_number (required).
congress_house_communicationsBRead-only
List House communications — executive communications, memorials, presidential messages, and petitions referred to House committees. Types: ec (Executive Communication), ml (Memorial), pm (Presidential Message), pt (Petition).
Inputs: limit, congress, communication_type.
congress_house_requirement_detailsARead-only
Get detailed information about a specific House requirement including legal authority, frequency, nature, and matching communications count.
Inputs: requirement_number (required).
congress_house_requirement_matching_communicationsARead-only
Get communications that match a specific House requirement. Shows agency submissions fulfilling a recurring reporting obligation.
Inputs: requirement_number (required), limit.
congress_house_requirementsARead-only
List House requirements — recurring reporting obligations from executive agencies to Congress. Shows requirement number, frequency, and matching communications count.
Inputs: limit.
congress_house_votesARead-only
Get House of Representatives roll call vote results with member-level party breakdown. Primary source: Congress.gov API (118th-119th Congress); falls back to clerk.house.gov XML for older congresses. Coverage: 1990 to present. Use year param for historical votes. Cross-reference with: congress_senate_votes (same bill's Senate vote), FEC (congress_member donors via fec_candidate_financials), lobbying_search (who lobbied on the bill), FRED (economic impact 1-3 years after passage). For Senate votes, use congress_senate_votes.
Inputs: year, limit, session, congress, +1 more.
congress_infoARead-only
Get information about congresses and their sessions — start/end dates, session numbers, and chambers. Use to look up when a congress was in session, or get current congress details.
Inputs: limit, current, congress.
congress_law_detailsARead-only
Get detailed information about a specific public or private law, including sponsors, CBO cost estimates, committee reports, and constitutional authority statement. Requires congress number, law type, and law number.
Inputs: congress (required), law_type (required), law_number (required).
congress_member_billsARead-only
Get bills sponsored or cosponsored by a specific member of Congress. Requires the member's BioGuide ID (use congress_search_members to find it).
Inputs: bioguide_id (required), type, limit.
congress_member_detailsARead-only
Get detailed information about a specific member of Congress by BioGuide ID. Returns full bio, party history, all terms served, committee assignments, photo URL, and official website.
Use congress_search_members first to find the BioGuide ID.
Inputs: bioguide_id (required).
congress_member_full_profileARead-only
Get a COMPLETE member of Congress profile in ONE call — combines bio/details, recent sponsored legislation, and recent cosponsored legislation (3 endpoints in parallel). Returns party history, terms served, committee assignments, photo, website, plus legislative activity.
Use this instead of calling congress_member_details + congress_member_bills (sponsored) + congress_member_bills (cosponsored) individually.
Ideal for: Accountability research — cross-reference with FEC (fec_candidate_financials) for donors, lobbying_search for industry lobbying, and congress_house_votes / congress_senate_votes for voting record.
Inputs: bioguide_id (required), bill_limit.
congress_nomination_committeesARead-only
Get committees associated with a nomination. Shows committee activities (referral, hearing, discharge).
Inputs: congress (required), nomination_number (required).
congress_nomination_detailsARead-only
Get detailed information about a specific presidential nomination, including all actions (committee referral, hearing, vote, confirmation/rejection).
Inputs: congress (required), nomination_number (required).
congress_nomination_full_profileARead-only
Get a COMPLETE presidential nomination profile in ONE call — combines nomination details, full action timeline, committee referrals/activity, and associated hearings (4 endpoints in parallel). Use this instead of calling congress_nomination_details + congress_nomination_committees + congress_nomination_hearings individually.
Ideal for: Tracking judicial and executive nominations from submission through confirmation/rejection. Cross-reference with lobbying_search for industry interest in the nominee.
Inputs: congress (required), nomination_number (required).
congress_nomination_hearingsARead-only
Get printed hearings associated with a nomination. Shows hearing dates, citations, and chambers.
Inputs: congress (required), nomination_number (required).
congress_nomination_nomineesARead-only
Get the list of nominees for a specific position within a nomination. Some nominations contain multiple positions (ordinals). Use congress_nomination_details first to see the ordinal numbers.
Inputs: ordinal (required), congress (required), nomination_number (required), limit.
congress_nominationsARead-only
List presidential nominations to federal offices (judges, cabinet, ambassadors, agency heads). Shows nominee name, position, organization, and confirmation status.
Inputs: limit, congress, toDateTime, fromDateTime.
congress_recent_lawsARead-only
Get recently enacted laws (bills signed by the President). Optionally filter by law type (public or private). Shows what legislation has become law.
Inputs: limit, congress, law_type.
congress_search_billsARead-only
Search for bills in Congress by keyword, congress number, or bill type. Returns bill number, title, sponsor, latest action, and status.
Congress numbers: 118th (2023-2024), 119th (2025-2026), 117th (2021-2022). Bill types: hr (House), s (Senate), hjres, sjres, hconres, sconres, hres, sres
Inputs: sort, limit, query, offset, +4 more.
congress_search_membersARead-only
Search for members of Congress by state, congress number, district, or get all current members. Supports: /member (all), /member/{stateCode} (by state), /member/{stateCode}/{district} (by district), /member/congress/{congress} (by congress), /member/congress/{congress}/{stateCode}/{district} (combined).
Inputs: limit, state, congress, district, +3 more.
congress_senate_communication_detailsARead-only
Get detailed information about a specific Senate communication including abstract, committees, and congressional record date.
Inputs: congress (required), communication_type (required), communication_number (required).
congress_senate_communicationsARead-only
List Senate communications — executive communications, presidential messages, and petitions/memorials referred to Senate committees. Types: ec (Executive Communication), pm (Presidential Message), pom (Petition or Memorial).
Inputs: limit, congress, communication_type.
congress_senate_votesARead-only
Get Senate roll call vote results from senate.gov XML. Shows how senators voted by party on specific legislation, nominations, and procedural motions. Coverage: 101st Congress (1989) to present. Cross-reference with: congress_house_votes (same bill's House vote), FEC (senator donors via fec_candidate_financials), lobbying_search (who lobbied on the bill), congress_member_bills (senator's voting vs sponsoring patterns). For House votes, use congress_house_votes.
Inputs: limit, session, congress, vote_number.
congress_summaries_searchARead-only
Search bill summaries across all bills and congresses. Unlike congress_bill_summaries (which requires a specific bill), this searches CRS summaries across the entire collection. Filter by congress, bill type, and date range. Sorted by last update date. Results include the associated bill reference.
Inputs: sort, limit, congress, bill_type, +2 more.
congress_treatiesARead-only
List treaties submitted to the Senate. Shows treaty topic, date transmitted, and ratification status.
Inputs: limit, congress, toDateTime, fromDateTime.
congress_treaty_committeesARead-only
Get committees associated with a treaty. Typically the Senate Foreign Relations Committee.
Inputs: congress (required), treaty_number (required).
congress_treaty_detailsBRead-only
Get detailed information about a specific treaty, including all Senate actions (committee referral, hearings, ratification vote).
Inputs: congress (required), treaty_number (required).
congress_treaty_full_profileARead-only
Get a COMPLETE treaty profile in ONE call — combines treaty details, full action timeline, and committee assignments (3 endpoints in parallel). Use this instead of calling congress_treaty_details + congress_treaty_committees individually.
Ideal for: International agreement research and Senate Foreign Relations Committee tracking.
Inputs: congress (required), treaty_number (required).
congress_treaty_partitioned_actionsARead-only
Get actions on a partitioned treaty (one with a suffix letter). Shows committee referral, hearings, and ratification votes for a specific treaty partition.
Inputs: congress (required), treaty_number (required), treaty_suffix (required), limit.
congress_treaty_partitioned_detailsARead-only
Get details about a partitioned treaty (one with a suffix letter like A, B, etc.). Some treaties are divided into parts, each identified by a suffix.
Inputs: congress (required), treaty_number (required), treaty_suffix (required).
coops_air_gapARead-only
Get air gap (bridge clearance) data from a NOAA CO-OPS station. Measures the distance between a bridge and the water surface.
Inputs: station (required), date, datum, units, +2 more.
coops_current_predictionsARead-only
Get current predictions for a NOAA CO-OPS station. Returns predicted current speed/direction.
Inputs: station (required), bin, date, units, +4 more.
coops_currentsARead-only
Get current speed/direction observations from a NOAA CO-OPS station. Requires a currents-capable station.
Inputs: station (required), bin, date, units, +3 more.
coops_high_lowARead-only
Get observed high/low tide data from a NOAA CO-OPS station. Returns verified high and low water level observations.
Inputs: station (required), date, datum, units, +2 more.
coops_meteorologicalARead-only
Get meteorological data from a NOAA CO-OPS station. Products: air_temperature, water_temperature, wind, air_pressure, humidity, visibility.
Inputs: product (required), station (required), date, units, +3 more.
coops_station_metadataARead-only
Get detailed metadata for a specific NOAA CO-OPS station. Returns location, sensors, datums, products available, etc.
Inputs: station_id (required).
coops_stationsARead-only
List/search NOAA CO-OPS stations. Optionally filter by station type (waterlevels, currentpredictions, etc.) and/or 2-letter state code.
Inputs: type, state.
coops_tide_predictionsARead-only
Get tide predictions for a NOAA CO-OPS station. Provide station ID + date range (YYYYMMDD) or date shortcut. Use interval='hilo' for high/low only.
Inputs: station (required), date, datum, units, +4 more.
coops_water_levelARead-only
Get observed water levels from a NOAA CO-OPS station. Provide station ID + date range (YYYYMMDD) or date shortcut (today/latest/recent).
Inputs: station (required), date, datum, units, +3 more.
coops_water_qualityARead-only
Get conductivity/salinity (water quality) data from a NOAA CO-OPS station.
Inputs: station (required), date, units, end_date, +1 more.
cos_licensingARead-only
Look up licensing and certification requirements for an occupation by state. Returns license names, types, issuing agencies, and application URLs. Useful for understanding state-specific professional requirements.
Inputs: state (required), keyword (required).
cos_occupation_searchARead-only
Search occupations by keyword using the CareerOneStop API. Returns matching occupations with ONET codes, titles, and descriptions. Use ONET codes from results for more specific lookups.
Inputs: keyword (required), location.
courtlistener_opinionARead-only
Get the full text of a court opinion by its CourtListener ID. Returns the complete opinion text, case name, court, date filed, and citations.
Inputs: id (required).
courtlistener_searchARead-only
Search case law opinions across federal and state courts. Find opinions by keyword, court, or date range. Court codes: 'scotus' (Supreme Court), 'ca1'-'ca11' (Circuit Courts), 'cadc' (DC Circuit), 'cafc' (Federal Circuit). Returns opinion metadata including case name, court, date filed, and citation.
Inputs: court, limit, query, filed_after, +1 more.
co_water_readingsARead-only
Get real-time Colorado streamflow, reservoir, and weather telemetry readings.
Parameters (measurement types):
DISCHRG: Discharge/streamflow (CFS)
GAGE_HT: Gage height (feet)
AIRTEMP: Air temperature (degrees F)
STORAGE: Reservoir storage (acre-feet)
PRECIP: Precipitation (inches)
WIND_SPEED: Wind speed (mph)
Use co_water_stations first to find station abbreviations.
Inputs: abbrev (required), end, limit, start, +1 more.
co_water_rightsARead-only
Search Colorado water rights and structures — adjudicated water rights, diversions, wells, and reservoirs with appropriation dates and decreed amounts.
Filter by county and/or water source name.
Inputs: limit, county, water_source, water_district.
co_water_stationsARead-only
Search Colorado telemetry stations — find monitoring stations by county, water district, or division.
Returns station abbreviations needed for co_water_readings, plus location, parameter type, and station metadata.
Inputs: limit, county, division, water_district.
cpsc_penalty_companiesARead-only
List companies that have CPSC penalties (civil or criminal). Use the company names from results with cpsc_penalty_search.
Inputs: penalty_type (required).
cpsc_penalty_searchARead-only
Search CPSC penalty records by type, company, product, fiscal year, or ID. Penalty type (civil or criminal) is required. Use cpsc_penalty_companies to discover valid company names.
Example: penalty_type='civil', company='IKEA'
Inputs: penalty_type (required), id, company, product, +1 more.
cpsc_recall_detailARead-only
Get full CPSC recall details by RecallID. Returns complete information including description, products, manufacturers, hazards, remedies, injuries, retailers, images, and consumer contact info. Use cpsc_recall_search first to find RecallIDs.
Inputs: recall_id (required).
cpsc_recall_searchARead-only
Search CPSC consumer product recalls by product name, manufacturer, hazard, date range, or recall number. All parameters are optional — use at least one to filter results. Date parameters use MM/DD/YYYY format.
Example: product_name='stroller', manufacturer='Fisher-Price', hazard='choking'
Inputs: hazard, manufacturer, product_name, product_type, +6 more.
cta_bus_arrivalsARead-only
Get bus arrival predictions for a CTA (Chicago) bus stop. Returns predicted arrival times, route, direction, destination, and delay status. Stop IDs are numeric (find them on CTA bus stop signs or the CTA website).
Inputs: stop_id (required).
cta_train_arrivalsARead-only
Get L train arrival predictions for a CTA (Chicago) station. Returns predicted arrival times, destination, run number, direction, and delay status. Station IDs are numeric (e.g. 40380 for Clark/Lake, 40530 for Washington/Wabash).
Inputs: station_id (required).
dap_agency_reportARead-only
Get an agency-specific web analytics report from the Digital Analytics Program. Returns analytics data for a specific federal agency's websites.
Example: agency='interior', report='traffic-source', limit=50
Inputs: agency (required), report (required), page, after, +2 more.
dap_domain_reportARead-only
Get a domain-specific web analytics report from the Digital Analytics Program. Returns analytics data for a specific government website domain.
Example: domain='nasa.gov', report='browser', limit=50
Inputs: domain (required), report (required), page, after, +2 more.
dap_gov_wide_reportARead-only
Get a government-wide web analytics report from the Digital Analytics Program. Returns aggregate data across all federal government websites. Report types include site visits, traffic sources, devices, browsers, OS, downloads, and more.
Example: report='site', limit=50, after='2025-01-01'
Inputs: report (required), page, after, limit, +1 more.
datagov_dataset_detailARead-only
Get full metadata for a Data.gov dataset by name (slug) or UUID. Returns title, description, organization, resources (with download URLs and formats), tags, license, author, maintainer, and modification dates.
Inputs: id (required).
datagov_list_organizationsARead-only
List federal agencies publishing data on Data.gov. Returns agency name, title, description, and dataset count. Sorted by dataset count (most prolific first) by default.
Inputs: sort, limit, offset.
datagov_search_datasetsARead-only
Search the Data.gov federal open data catalog (400K+ datasets). Find datasets by keyword, topic, agency, or format. Use fq for precise filtering: 'organization:nasa-gov', 'res_format:CSV', 'tags:climate'. Returns dataset name, title, organization, description, resource count, and tags.
Inputs: q, fq, rows, sort, +2 more.
doe_publicationsARead-only
Search DOE-funded scientific publications and technical reports. Covers research from national labs and universities funded by the Department of Energy. Filter by keyword, author, title, subject, and date range.
Inputs: limit, query, title, author, +3 more.
doj_blog_detailARead-only
Get the full text of a specific DOJ blog entry by UUID. Returns the complete body, component, topic, date, and URL.
Inputs: uuid (required).
doj_blog_entriesARead-only
Search DOJ Office of Public Affairs blog entries (3,200+ records). Blog entries often provide more context and analysis than press releases. Covers policy discussions, division activities, and enforcement context.
Inputs: page, sort, pagesize, direction.
doj_press_release_detailARead-only
Get the full text of a specific DOJ press release by UUID. Returns the complete body, component, topic, date, and URL.
Inputs: uuid (required).
doj_press_releasesARead-only
Search DOJ press releases (262K+ records covering all DOJ divisions). Includes enforcement actions, indictments, settlements, and policy announcements. Filter by title keyword and sort by date. Components: FBI, DEA, ATF, Civil Rights Division, Antitrust, USAO, and more. Topics: Drug Trafficking, Cybercrime, National Security, Civil Rights, Financial Fraud, etc.
Inputs: page, sort, title, pagesize, +1 more.
dol_osha_accident_injuriesARead-only
Get injury details from OSHA accident investigations. Returns demographics (age, sex), nature of injury, body part, source, degree of injury. Degree of injury: 1=Fatality, 2=Hospitalized, 3=Non-hospitalized. Link to accidents via summary_nr.
Inputs: limit, offset, summary_nr, degree_of_inj.
dol_osha_accidentsARead-only
Search OSHA accident and fatality investigations. Returns event descriptions, dates, locations, and industry codes. Use dol_osha_accident_injuries to get injury details for a specific accident.
Inputs: limit, state, offset, sort_by, +3 more.
dol_osha_inspectionsARead-only
Search OSHA workplace inspections. Find inspections by state, establishment name, industry (SIC/NAICS), or type. Inspection types: A=Accident, B=Complaint, C=Referral, H=Planned, L=Programmed high-hazard. Returns site details, inspection type/scope, open/close dates.
Inputs: limit, state, offset, sort_by, +5 more.
dol_osha_violationsARead-only
Search OSHA violations found during workplace inspections. Violation types: S=Serious, W=Willful, R=Repeat, O=Other, U=Unclassified, F=Failure to abate. Returns standard cited, penalty amounts (initial and current), abatement status. Link to inspections via activity_nr.
Inputs: limit, offset, sort_by, standard, +3 more.
dol_ui_claims_nationalARead-only
Get national weekly Unemployment Insurance (UI) initial and continued claims. Includes insured unemployment rate and covered employment. Key economic indicator — spikes indicate labor market stress.
Inputs: limit, offset, sort_by, sort_order.
dol_ui_claims_stateARead-only
Get state-level weekly Unemployment Insurance (UI) claims. Compare initial claims, continued claims, and insured unemployment rate across states.
Inputs: limit, state, offset, sort_by, +1 more.
dol_whd_enforcementARead-only
Search WHD (Wage and Hour Division) enforcement cases. Covers wage theft investigations: back wages owed, penalties assessed, violation counts. Laws enforced: FLSA (minimum wage/overtime), FMLA (family leave), Davis-Bacon (prevailing wage), SCA (service contracts). Data available since FY2005.
Inputs: limit, state, offset, sort_by, +3 more.
ecfr_searchARead-only
Search the Code of Federal Regulations (CFR) by keyword. Returns matching regulation sections with titles, parts, and context snippets.
The CFR contains all federal regulations organized into 50 titles by subject area (e.g. Title 21 = Food and Drugs, Title 26 = Internal Revenue, Title 40 = Environment).
Inputs: query (required), page, limit.
ecfr_sectionARead-only
Get the full text of a specific CFR section or part. Returns the rendered regulation content.
Use ecfr_search or ecfr_title_structure first to find the title, part, and section numbers.
Inputs: part (required), title (required), date, section.
ecfr_title_structureARead-only
Get the organizational structure of a CFR title — shows all parts, subparts, and sections. Useful for browsing what regulations exist within a title before reading specific sections.
Common titles: 7 (Agriculture), 12 (Banks), 14 (Aviation), 21 (Food & Drugs), 26 (Internal Revenue), 29 (Labor), 40 (Environment), 42 (Public Health), 47 (Telecommunications).
Inputs: title (required), date.
eia_electricityBRead-only
Get electricity retail prices, generation, or consumption by state and sector.
Sectors: residential (RES), commercial (COM), industrial (IND), transportation (TRA), all (ALL). Data types: 'price' (cents/kWh), 'revenue' (M$), 'sales' (MWh), 'customers'
Inputs: end, start, state, length, +4 more.
eia_natural_gasARead-only
Get natural gas prices — Henry Hub spot price, citygate, residential, commercial, industrial, electric power.
Process codes: PRS (citygate), PRP (electric power), PRC (commercial), PRI (industrial), PRR (residential), PNG (Henry Hub spot)
Inputs: end, start, length, offset, +2 more.
eia_petroleumARead-only
Get petroleum/oil prices — crude oil spot prices (WTI, Brent), retail gasoline prices, diesel, heating oil.
Product codes:
EPCBRENT: Brent crude oil spot price
EPCWTI: WTI crude oil spot price
EMM_EPMRU_PTE_NUS_DPG: US regular gasoline retail
EMM_EPMPU_PTE_NUS_DPG: US premium gasoline retail
EMD_EPD2D_PTE_NUS_DPG: US diesel retail
EER_EPJK_PF4_RGC_DPG: US jet fuel spot price
Inputs: end, start, length, offset, +2 more.
eia_state_energyARead-only
Get state-level energy data from the State Energy Data System (SEDS). Covers production, consumption, expenditures, and prices by energy source for all 50 states.
MSN codes (energy data codes):
TETCB: Total energy consumption (trillion BTU)
TETCD: Total energy consumption per capita
TEPRB: Total energy production (trillion BTU)
ESTCB: Electricity total consumption
CLTCB: Coal consumption
NNTCB: Natural gas consumption
PATCB: Petroleum consumption
RETCB: Renewable energy consumption
NUETB: Nuclear energy consumption
Inputs: end, msn, start, state, +2 more.
eia_total_energyARead-only
Get the monthly/annual U.S. energy overview — total production, consumption, imports, exports, and prices across all energy sources.
MSN codes:
ELETPUS: Electricity net generation
ELNIPUS: Electricity net imports
CLTCPUS: Coal consumption
NNTCPUS: Natural gas consumption
PATCPUS: All petroleum consumption
RETCPUS: Renewable energy consumption
NUETPUS: Nuclear electric power
Inputs: end, msn, start, length, +2 more.
epa_air_qualityARead-only
Get air quality data from EPA's Air Quality System (AQS). Returns annual summary data by state (county-level monitor readings for criteria pollutants). Parameters: '14129' (Lead (Pb)), '42101' (CO (Carbon Monoxide)), '42401' (SO2 (Sulfur Dioxide)), '42602' (NO2 (Nitrogen Dioxide)), '44201' (Ozone), '81102' (PM10), '88101' (PM2.5 (FRM/FEM)), '88502' (PM2.5 (non-FRM, e.g. continuous)). Services: 'annualData' (Annual summaries (yearly statistics per monitor)), 'dailyData' (Daily summaries (daily mean, max, etc.)), 'quarterlyData' (Quarterly summaries (quarterly statistics)), 'sampleData' (Raw sample data (hourly or finer grain)). States use 2-digit FIPS codes: '01'=AL, '06'=CA, '37'=NC, '48'=TX. bdate/edate must be in same year (YYYYMMDD format). Requires AQS_API_KEY and AQS_EMAIL. Signup: https://aqs.epa.gov/data/api/signup
Inputs: bdate (required), edate (required), param (required), state (required), +2 more.
epa_aqs_dailyARead-only
Get daily air quality summary data from EPA AQS. Returns daily mean, max, and observation count per monitor. Parameters: '14129' (Lead (Pb)), '42101' (CO (Carbon Monoxide)), '42401' (SO2 (Sulfur Dioxide)), '42602' (NO2 (Nitrogen Dioxide)), '44201' (Ozone), '81102' (PM10), '88101' (PM2.5 (FRM/FEM)), '88502' (PM2.5 (non-FRM, e.g. continuous)). Useful for tracking day-to-day pollution levels. Cross-reference with CDC health data. Requires AQS_API_KEY and AQS_EMAIL.
Inputs: bdate (required), edate (required), param (required), state (required), +1 more.
epa_aqs_monitorsARead-only
Find air quality monitoring stations from EPA AQS. Returns monitor locations, operational dates, measurement types, and operating agencies. Parameters: '14129' (Lead (Pb)), '42101' (CO (Carbon Monoxide)), '42401' (SO2 (Sulfur Dioxide)), '42602' (NO2 (Nitrogen Dioxide)), '44201' (Ozone), '81102' (PM10), '88101' (PM2.5 (FRM/FEM)), '88502' (PM2.5 (non-FRM, e.g. continuous)). Useful for finding what is being measured and where. Requires AQS_API_KEY and AQS_EMAIL.
Inputs: bdate (required), edate (required), param (required), state (required), +1 more.
epa_drinking_waterARead-only
Get Safe Drinking Water Information System (SDWIS) data by state. Returns public water systems with population served, source type, and system type. System types: 'CWS' (Community Water System (serves residents year-round)), 'NTNCWS' (Non-transient Non-community (serves 25+ of same people, e.g. schools)), 'TNCWS' (Transient Non-community (serves transient users, e.g. gas stations)). Cross-reference with CDC health data and Census population for per-capita analysis.
Inputs: state (required), rows.
epa_enforcementARead-only
Search EPA enforcement cases -- civil and criminal actions with penalties, settlements, and outcomes. Case types: 'JDC' (Judicial (court) case), 'AFR' (Administrative formal (EPA order)). Returns case name, primary law violated, penalties, settlement dates, and outcomes. Cross-reference with DOJ press releases, SEC financials, lobbying data, and FEC contributions.
Inputs: state (required), law, limit.
epa_facilitiesARead-only
Search EPA-regulated facilities for environmental compliance and violations via ECHO. Find facilities with air or water permit violations, inspections, and enforcement actions. Media types: 'air' (Clean Air Act (CAA) facilities via ICIS-Air), 'water' (Clean Water Act (CWA) facilities via ICIS-NPDES).
Inputs: state (required), limit, major_only, media_type, +1 more.
epa_facility_detailARead-only
Get a detailed facility report from ECHO by registry ID. Returns permits, enforcement actions, compliance summaries, NAICS/SIC codes, and inspection history. Use epa_facilities first to find a RegistryID, then pass it here for the full report.
Inputs: registry_id (required).
epa_greenhouse_gasARead-only
Get Greenhouse Gas (GHG) emissions data by state. Returns large emitters reporting under EPA's Greenhouse Gas Reporting Program (GHGRP). Includes CO2-equivalent emissions, facility name, sector, and location. Cross-reference with EIA energy data and BLS CPI energy component.
Inputs: state (required), rows.
epa_rcraARead-only
Search RCRA hazardous waste facilities by state via ECHO. Returns generators, transporters, and treatment/storage/disposal (TSD) facilities regulated under RCRA Subtitle C. Cross-reference with epa_toxic_releases (TRI) and epa_greenhouse_gas for multi-program facility analysis.
Inputs: state (required), limit.
epa_superfundARead-only
Get Superfund (CERCLA) contaminated sites by state. Returns site name, location, NPL status, and cleanup progress. NPL statuses: 'F' (Final NPL (active cleanup)), 'P' (Proposed NPL), 'D' (Deleted from NPL (cleanup completed)), 'N' (Not on NPL). Cross-reference with Census demographics, CDC health data, HUD housing values, and USAspending cleanup funding.
Inputs: state (required), rows.
epa_toxic_releasesARead-only
Get Toxics Release Inventory (TRI) data by state. TRI tracks chemical releases from industrial facilities reported under EPCRA Section 313. Common sectors: 'Chemicals', 'Metal Mining', 'Electric Utilities', 'Petroleum', 'Food/Beverages/Tobacco', 'Paper', 'Primary Metals'. Cross-reference with epa_facilities for compliance status and epa_greenhouse_gas for emissions.
Inputs: state (required), rows, county.
epa_uv_indexARead-only
Get UV index forecast for a U.S. location (ZIP code or city/state). UV Scale: 0-2 Low, 3-5 Moderate, 6-7 High, 8-10 Very High, 11+ Extreme. Useful for health recommendations -- high UV correlates with skin cancer risk.
Inputs: zip, city, state.
ercot_grid_conditionsARead-only
Get current Texas (ERCOT) grid conditions — load forecasts by weather zone, including total system load, capacity, and wind/solar generation.
ERCOT manages the Texas Interconnection, an independent grid covering ~90% of Texas.
Inputs: limit, offset, delivery_date_to, delivery_date_from.
ercot_pricesARead-only
Get Texas (ERCOT) settlement point prices — real-time wholesale electricity prices at specific nodes, zones, or hubs.
Common settlement points: HB_HOUSTON, HB_NORTH, HB_SOUTH, HB_WEST, HB_BUSAVG (hub average).
Inputs: limit, offset, delivery_date_to, settlement_point, +1 more.
faa_metarARead-only
Get METAR weather observations for airports. Returns current conditions: temperature, dewpoint, wind, visibility, ceiling, flight category. Station IDs are ICAO codes (e.g. KJFK, KLAX, KORD). Multiple stations can be comma-separated.
Inputs: ids (required), hours.
faa_pirepARead-only
Get pilot reports (PIREPs). Returns pilot-reported weather conditions including turbulence, icing, and weather phenomena. Optionally filter by recency (hours).
Inputs: hours.
faa_sigmetARead-only
Get active SIGMETs (Significant Meteorological Information). Returns hazardous weather advisories including turbulence, icing, convection, and volcanic ash. Covers all active SIGMETs across the national airspace.
Inputs: no named parameters.
faa_tafARead-only
Get TAF (Terminal Aerodrome Forecast) for airports. Returns forecast periods with expected conditions, wind, visibility, and clouds. Station IDs are ICAO codes. Multiple stations can be comma-separated.
Inputs: ids (required).
fbi_agenciesARead-only
List law enforcement agencies in a U.S. state from the FBI CDE. Returns agencies grouped by county with ORI codes, coordinates, and NIBRS participation dates. Use ORI codes from this tool to query agency-level data in other FBI tools.
Inputs: state (required).
fbi_arrest_dataARead-only
Get arrest statistics from the FBI at national, state, or agency level. Offense codes are numeric: 'all' (all offenses), '11' (murder), '20' (rape), '30' (robbery), '50' (aggravated assault), '150' (drug abuse), and 40+ more. Returns counts or totals broken down by year, age, sex, race, ethnicity.
Inputs: offense (required), ori, type, state, +2 more.
fbi_crime_summarizedARead-only
Get summarized UCR crime data from the FBI at national, state, or agency level. Covers 10 offense categories: V (violent crime), P (property crime), HOM (homicide), RPE (rape), ROB (robbery), ASS (aggravated assault), BUR (burglary), LAR (larceny/theft), MVT (motor vehicle theft), ARS (arson). Returns year-by-year data with counts and rates.
Inputs: offense (required), ori, state, to_year, +1 more.
fbi_expanded_homicideARead-only
Get expanded homicide (Supplementary Homicide Report) data from the FBI. Includes victim/offender demographics, weapons used, and circumstances. Available at national, state, or agency level.
Inputs: ori, type, state, to_year, +1 more.
fbi_expanded_propertyARead-only
Get expanded property crime details from the FBI (Supplemental Return / Return A data). Provides additional breakdowns beyond summarized counts: value of stolen/recovered property, type of property, premises involved. Available for burglary (NB), larceny (NL), motor vehicle theft (NMVT), and robbery (NROB).
Inputs: offense (required), ori, type, state, +2 more.
fbi_hate_crimeARead-only
Get hate crime data from the FBI at national, state, or agency level. Returns incidents broken down by bias category (race, religion, sexual orientation, etc.), offense type, victim type, offender demographics, and location type. Optionally filter by bias code (e.g., '12'=Anti-Black, '14'=Anti-Jewish, '22'=Anti-Islamic, '41'=Anti-Gay).
Inputs: ori, bias, type, state, +2 more.
fbi_law_enforcement_employeesARead-only
Get law enforcement employee data (sworn officers, civilian employees) at national, state, or agency level. Shows staffing levels over time.
Inputs: ori, state, to_year, from_year.
fbi_lesdcARead-only
Get Law Enforcement Suicide Data Collection (LESDC) statistics. Chart types: race, demographics, manner, location, employment, occupation, military, totals, duty, exp, experience, suffered, prior, investigation, wellness.
Inputs: year (required), chart_type (required).
fbi_nibrsARead-only
Get NIBRS (National Incident-Based Reporting System) data from the FBI. More detailed than summarized UCR data — includes victim/offender demographics, relationships, weapons, location, and time of day for 71 offense types. Offense codes use NIBRS format: '13A' (aggravated assault), '09A' (murder), '23H' (all other larceny), '35A' (drug violations), '220' (burglary), etc.
Inputs: offense (required), ori, type, state, +2 more.
fbi_use_of_forceARead-only
Get Use of Force data from the FBI. Covers incidents where law enforcement use of force resulted in death, serious injury, or firearm discharge. Available at federal (all federal agencies) or national (all participating agencies) level. Use scope='federal' for federal agencies, 'national' for all agencies participation data.
Inputs: year (required), scope (required), quarter.
fcc_broadband_coverageARead-only
Check broadband coverage at a specific location. Returns available providers, technology types, and advertised speeds. Provide latitude/longitude or an address.
Inputs: address, latitude, longitude, technology, +2 more.
fcc_broadband_providersARead-only
Search broadband providers by location or state. Returns ISP names, technology types (fiber, cable, DSL), and advertised speeds. Provide a state code, lat/lon, or both to filter results.
Inputs: limit, state, latitude, longitude, +1 more.
fda_animal_eventsARead-only
Search animal/veterinary adverse event reports (1.3M+ reports). Reports of drug side effects in animals — dogs, cats, horses, cattle, etc. Each report has: animal info (species, breed), drugs, reactions (VEDDRA terms), outcomes. Note: Some fields may contain 'MSK' (masked) values for privacy.
Example searches:
'animal.species:"Dog"' — dog events
'original_receive_date:[20200101+TO+20231231]' — events in date range
'serious_ae:true' — serious adverse events only
Count fields: animal.species.exact, primary_reporter.exact, serious_ae
Inputs: limit, search.
fda_approved_drugsARead-only
Search FDA-approved drugs (Drugs@FDA database). Find approved drugs by brand name, sponsor/manufacturer, or application number. Shows approval history, active ingredients, and marketing status.
Example searches:
'openfda.brand_name:"Ozempic"' — find Ozempic
'sponsor_name:"Pfizer"' — all Pfizer approvals
'products.active_ingredients.name:"SEMAGLUTIDE"' — by ingredient
Inputs: limit, search.
fda_countARead-only
Count/aggregate any OpenFDA endpoint by a specific field. Returns top terms with counts. Works on ALL FDA endpoints. IMPORTANT: Use '.exact' suffix for full phrase counts (e.g. 'brand_name.exact'). Without '.exact', multi-word values like 'Class III' are split into separate word counts.
Endpoints: drug/event, drug/label, drug/ndc, drug/enforcement, drug/drugsfda, drug/shortages, device/event, device/510k, device/classification, device/enforcement, device/recall, device/pma, device/udi, food/enforcement, food/event, animalandveterinary/event, tobacco/problem.
Example count_field values per endpoint:
drug/ndc → pharm_class.exact, dea_schedule, dosage_form.exact
drug/shortages → update_type, status.exact, therapeutic_category.exact
device/510k → country_code, advisory_committee, clearance_type.exact
tobacco/problem → tobacco_products.exact, reported_health_problems.exact
food/event → reactions.exact, outcomes.exact
animalandveterinary/event → animal.species.exact, primary_reporter.exact
Inputs: endpoint (required), count_field (required), limit, search.
fda_covid_serologyARead-only
Search COVID-19 serology test evaluation results. FDA's evaluation of antibody test performance (sensitivity/specificity).
Example searches:
'antibody_truth:"Positive"' — positive samples
'manufacturer:"Abbott"' — tests by manufacturer
Count fields: type (sample material), manufacturer.exact
Inputs: limit, search.
fda_device_510kARead-only
Search 510(k) premarket clearance decisions (174K+ since 1976). A 510(k) demonstrates a device is substantially equivalent to a legally marketed device.
Example searches:
'advisory_committee:cv' — cardiovascular devices
'openfda.regulation_number:868.5895' — by regulation number
'device_name:"pacemaker"' — by device name
'applicant:"Medtronic"' — by company
Count fields: country_code, advisory_committee, clearance_type.exact, decision_code
Inputs: limit, search.
fda_device_classificationARead-only
Search medical device classification — ~1,700 generic device types. Returns device class (1=Class I, 2=Class II, 3=Class III), product codes, definitions.
Example searches:
'regulation_number:872.6855' — by regulation number
'product_code:NOB' — by product code
'device_name:"pacemaker"' — by device name
'device_class:3' — Class III (highest risk) devices
Count fields: device_class, medical_specialty.exact
Inputs: limit, search.
fda_device_enforcementARead-only
Search FDA device recall enforcement reports. Same classification system as drug/food recalls: Class I (most dangerous) to Class III. Note: Records before June 2012 may lack some fields.
Example searches:
'classification:"Class I"' — most dangerous recalls
'report_date:[20200101+TO+20231231]' — recalls in date range
'recalling_firm:"Medtronic"' — by company
Count fields: voluntary_mandated.exact, classification.exact, status.exact
Inputs: limit, search.
fda_device_eventsARead-only
Search FDA medical device adverse event reports (MAUDE) — injuries, malfunctions, deaths.
Example searches:
'device.generic_name:pacemaker' — pacemaker events
'event_type:death' — events resulting in death
Inputs: limit, search.
fda_device_pmaARead-only
Search Premarket Approval (PMA) decisions for Class III medical devices. PMA is required for high-risk devices — evaluates safety and effectiveness.
Example searches:
'decision_code:APPR' — approved PMAs
'product_code:LWP' — by product code
'advisory_committee:CV' — cardiovascular devices
'applicant:"Medtronic"' — by company
Count fields: advisory_committee, decision_code
Inputs: limit, search.
fda_device_recallsARead-only
Search FDA medical device recall reports (RES system). Find recalled devices by name, manufacturer, or reason for recall.
Example searches:
'openfda.device_name:"pacemaker"' — pacemaker recalls
'reason_for_recall:"software"' — software-related recalls
Inputs: limit, search.
fda_device_registrationsARead-only
Search medical device establishment registrations & listings (336K+ records). Where devices are manufactured and which devices are made at each establishment.
Example searches:
'products.product_code:HQY' — establishments making product code HQY
'products.openfda.regulation_number:886.5850' — by regulation number
Count fields: products.openfda.device_class
Inputs: limit, search.
fda_device_udiARead-only
Search the Global Unique Device Identification Database (GUDID). Detailed device records: description, MRI safety, product codes, sterilization. Note: Booleans are stored as strings ('true'/'false').
Example searches:
'brand_name:"CoRoent"' — by brand
'is_rx:true' — prescription devices
'mri_safety:"MR Unsafe"' — MRI unsafe devices
'exists:public_device_record_key' — records with a public key
Count fields: product_codes.openfda.device_class, is_rx, mri_safety.exact
Inputs: limit, search.
fda_drug_countsARead-only
Aggregate/count FDA drug adverse event data by any field. For counting other endpoints, use fda_count instead.
Common count fields:
'patient.reaction.reactionmeddrapt.exact' — most common adverse reactions
'patient.drug.openfda.brand_name.exact' — most reported drug brands
'patient.drug.openfda.generic_name.exact' — most reported generic names
'receivedate' — reports over time
'primarysource.reportercountry.exact' — reports by country
Inputs: count_field (required), limit, search.
fda_drug_eventsARead-only
Search FDA adverse drug event reports (FAERS) — side effects, hospitalizations, deaths. Over 20 million reports. Search by drug name, reaction, seriousness.
Example searches:
'patient.drug.openfda.brand_name:aspirin' — events involving aspirin
'patient.drug.openfda.generic_name:ibuprofen+AND+serious:1' — serious ibuprofen events
'patient.reaction.reactionmeddrapt:nausea' — events where nausea was reported
Inputs: limit, search.
fda_drug_labelsARead-only
Search FDA drug product labeling (package inserts / prescribing information — SPL). Contains indications, warnings, boxed warnings, adverse reactions, drug interactions, dosage.
Example searches:
'openfda.brand_name:"Tylenol"' — labeling for Tylenol
'exists:boxed_warning' — all labels with a Black Box Warning
'effective_time:[20200101+TO+20231231]' — labels updated in date range
'openfda.product_type:"HUMAN PRESCRIPTION DRUG"' — prescription drug labels only
Count fields: openfda.product_type.exact, openfda.brand_name.exact, openfda.route.exact
Inputs: limit, search.
fda_drug_ndcARead-only
Search the NDC Directory — National Drug Code product listings (132K+ records). Find drugs by brand name, generic name, dosage form, DEA schedule, pharmacological class. Each entry has product data, active ingredients, packaging info, and openfda annotations.
Example searches:
'brand_name:"Tylenol"' — Tylenol products
'dea_schedule:"CII"' — Schedule II controlled substances
'dosage_form:"LOTION"' — all lotions
'active_ingredients.name:"OXYCODONE"' — products containing oxycodone
'finished:true' — finished drug products only
Count fields: pharm_class.exact, dea_schedule, dosage_form.exact, route.exact
Inputs: limit, search.
fda_drug_recallsARead-only
Search FDA drug recall enforcement reports. Find recalled drugs by classification (Class I=most serious), company, or reason.
Example searches:
'classification:"Class I"' — most dangerous recalls
'recalling_firm:"Pfizer"' — recalls by Pfizer
'reason_for_recall:listeria' — recalls due to listeria
Inputs: limit, search.
fda_drug_shortagesARead-only
Search FDA drug shortage listings — which drugs are in shortage and why. Tracks status, dosage form, therapeutic category, company, and shortage reason.
Example searches:
'status:"Currently in Shortage"' — active shortages
'dosage_form:"Capsule"' — capsule shortages
'therapeutic_category:"Antiviral"' — antiviral shortages
'generic_name:"Adderall"' — specific drug
Count fields: update_type, status.exact, therapeutic_category.exact
Inputs: limit, search.
fda_food_adverse_eventsARead-only
Search FDA food adverse event reports (CAERS database). Reports of illnesses, allergic reactions, and injuries from foods and dietary supplements.
Example searches:
'products.industry_name:"Dietary Supplements"' — supplement events
'reactions:"hospitalization"' — events involving hospitalization
Count fields: reactions.exact, outcomes.exact, products.industry_name.exact
Inputs: limit, search.
fda_food_recallsARead-only
Search FDA food recall enforcement reports. Class I (may cause death), Class II (temporary health problems), Class III (unlikely harm).
Example searches:
'classification:"Class I"' — most serious recalls
'recalling_firm:tyson' — recalls by a specific company
'reason_for_recall:listeria' — recalls due to listeria
Inputs: limit, search.
fda_historical_docsARead-only
Search historical FDA documents — press releases from 1913 to 2014 (OCR full-text search).
Example searches:
'doc_type:pr+AND+text:"poison prevention packaging"' — press releases about poison prevention
'year:1920+AND+text:Botulism' — 1920s botulism references
'text:"thalidomide"' — mentions of thalidomide
Inputs: limit, search.
fda_nsdeARead-only
Search NDC SPL Data Elements — comprehensive drug product data. Use 'missing:marketing_end_date' for products still on market. Use 'exists:marketing_end_date' for discontinued products.
Example searches:
'package_ndc:"55700-019-60"' — by NDC
'missing:"marketing_end_date"' — currently marketed products
Inputs: limit, search.
fda_substanceARead-only
Search FDA substance data — molecular-level ingredient information. Search by name, CAS code, UNII, or molecular formula.
Example searches:
'names.name:"PARACETAMOL"' — by substance name
'codes.code:"220127-57-1"' — by CAS registry number
'unii:"09211A0HHL"' — by UNII
'structure.formula:"C6H12"' — by molecular formula
Inputs: limit, search.
fda_tobacco_problemsARead-only
Search tobacco product problem reports (~1.3K reports). Reports about damaged, defective, or health-affecting tobacco products. E-cigarettes/vaping products dominate (~60% of reports).
Example searches:
'date_submitted:[20180101+TO+20200723]' — reports in date range
'nonuser_affected:"Yes"' — reports where non-users were affected
Count fields: tobacco_products.exact, reported_health_problems.exact
Inputs: limit, search.
fda_uniiARead-only
Search UNII (Unique Ingredient Identifiers) — links ingredient names to unique chemical IDs.
Example searches:
'unii:"L7V4I673D2"' — by UNII code
'substance_name:"ASPIRIN"' — by substance name
Inputs: limit, search.
fdic_depositsARead-only
Get Summary of Deposits — branch-level deposit data from annual survey (June 30). Shows deposit amounts at each bank branch. Filter by state or institution. Useful for market share analysis and banking access by geography.
Inputs: limit, offset, filters, sort_by, +1 more.
fdic_failuresARead-only
Get FDIC-insured bank failures — all failures since 1934. Includes failure date, estimated cost to FDIC, resolution type, and acquiring institution. Filter by state: PSTALP:"GA", by year range, or combine filters.
Inputs: limit, offset, filters, sort_by, +1 more.
fdic_financialsARead-only
Get quarterly Call Report financial data for FDIC-insured banks. Includes assets, deposits, net income, ROA, ROE, loan loss reserves. Filter by CERT number (specific bank) or STALP (state). Dollar values in thousands.
Inputs: limit, fields, offset, filters, +2 more.
fdic_historyARead-only
Get institution event history — mergers, acquisitions, name changes, charter conversions. Filter by CERT number to trace a specific bank's history.
Inputs: limit, offset, filters, sort_by, +1 more.
fdic_search_institutionsARead-only
Search FDIC-insured banks and savings institutions. Filter by state, name, charter type, asset size, active status. Filters: STALP:"CA", ACTIVE:1, ASSET:[1000000 TO *], INSTNAME:"Wells Fargo", CHARTER_CLASS:"N". Assets and deposits are in thousands of dollars.
Inputs: limit, fields, offset, search, +3 more.
fdic_summaryARead-only
Get aggregate banking statistics — industry totals by state or charter type. Useful for overview metrics: total banks, deposits, assets by state/year.
Inputs: limit, fields, offset, filters, +2 more.
fec_candidate_financialsARead-only
Get financial summary for a candidate — total raised, spent, cash on hand, debt. Requires a candidate_id (use fec_search_candidates to find one).
Inputs: candidate_id (required), cycle.
fec_committee_disbursementsARead-only
Get itemized disbursements from a PAC or committee — shows exactly which candidates and committees received money, how much, and when. This is the KEY tool for conflict-of-interest investigations: trace direct money from named industry PACs to named politicians. Example: fec_committee_disbursements(committee_id='C00004275', cycle=2018, recipient_name='Crapo') shows ABA BankPAC donations to Sen. Crapo. WORKFLOW: (1) fec_search_committees(name='Company', committee_type='Q') to find PAC ID, (2) this tool with recipient_name filter. Try multiple cycles (election year ± 1 cycle) since PACs often give early. Common PAC IDs: ABA BankPAC=C00004275, Wells Fargo=C00034595, Citigroup=C00008474, Goldman Sachs=C00350744, Pfizer=C00016683, Merck=C00097485.
Inputs: committee_id (required), cycle, per_page, recipient_name.
fec_committee_financialsARead-only
Get financial totals for a committee (PAC, campaign, party). Requires a committee_id (use fec_search_committees to find one).
Inputs: committee_id (required), cycle.
fec_search_candidatesARead-only
Search for federal election candidates by name, state, party, office, or election year. Data from the Federal Election Commission (FEC).
Inputs: name, page, party, state, +3 more.
fec_search_committeesARead-only
Search for political committees (PACs, campaign committees, party committees) by name, state, or type. CRITICAL for investigations: Use committee_type='Q' (Qualified PAC) + name='Company Name' to find corporate PAC IDs. Example: name='Wells Fargo', committee_type='Q' returns C00034595 (Wells Fargo Employee PAC). Then use fec_committee_disbursements with the committee_id to trace money to specific politicians.
Inputs: name, page, cycle, state, +2 more.
fec_top_candidatesARead-only
Get top candidates ranked by total money raised for a given office and election cycle.
Inputs: office (required), election_year (required), state, per_page.
fema_disaster_declarationsARead-only
Search FEMA disaster declarations (since 1953). Filter by state, year, incident type, or declaration type. Returns disaster name, type, affected area, programs declared.
Inputs: top, skip, year, state, +2 more.
fema_housing_assistanceARead-only
Get FEMA Individual Housing Program (IHP) assistance data for homeowners. Shows approved assistance amounts, inspections, and damage by county/zip for a disaster.
Inputs: top, skip, state, county, +1 more.
fema_public_assistanceARead-only
Get FEMA Public Assistance (PA) grant awards. Shows project-level grants to state/local/tribal governments and nonprofits for debris removal, emergency work, and permanent repair.
Inputs: top, skip, state, disaster_number.
fema_queryARead-only
General-purpose query against any OpenFEMA v2 dataset. Use this for NFIP flood insurance claims/policies, hazard mitigation grants, mission assignments, IHP registrations, etc. Supports OData $filter syntax.
Inputs: dataset (required), top, skip, filter, +2 more.
fema_regionsARead-only
Get FEMA region boundaries and associated states. 10 FEMA regions cover all U.S. states and territories.
Inputs: no named parameters.
fmcsa_carrier_detailARead-only
Get the full safety profile for a motor carrier by DOT number. Returns detailed information including safety rating, inspection results, crash data, driver counts, and operational details.
Inputs: dot_number (required).
fmcsa_carrier_searchARead-only
Search motor carriers registered with FMCSA by company name, DOT number, or state. Returns carrier profiles including legal name, DBA, state, driver count, power units, and safety rating. Use to find trucking companies, bus companies, and other motor carriers.
Inputs: name, state, dot_number.
foia_agenciesARead-only
List all federal agencies with FOIA offices and contact information. Returns agency names, abbreviations, FOIA request submission details, and websites. Use this to discover agency abbreviations for the foia_report tool.
Inputs: search.
foia_reportARead-only
Get annual FOIA report statistics for a specific federal agency. Includes request volumes, processing times, backlog data, exemption usage, and compliance metrics. Use foia_agencies first to find the correct agency abbreviation.
Inputs: agency_abbreviation (required).
fooddata_detailARead-only
Get complete nutritional details for a specific food by its FDC ID. Returns full nutrient breakdown: calories, protein, fat, carbs, vitamins, minerals, amino acids. Use fooddata_search first to find FDC IDs.
Inputs: fdcId (required).
fooddata_listARead-only
Browse a paged list of foods from the USDA database. Useful for exploring available foods by data type without a specific search term.
Inputs: sortBy, dataType, pageSize, sortOrder, +1 more.
fooddata_searchARead-only
Search the USDA FoodData Central database for foods by keyword. Returns matching foods with basic nutrient info. Covers 300K+ foods including branded products.
Data types: 'Foundation' (generic whole foods), 'SR Legacy' (historical USDA reference), 'Branded' (commercial products with UPC), 'Survey' (FNDDS dietary studies).
Inputs: query (required), sortBy, dataType, pageSize, +3 more.
fr_agenciesARead-only
List all federal agencies that publish in the Federal Register. Returns agency names, short names, slugs (for filtering), and URLs. 470+ agencies.
Inputs: no named parameters.
fr_document_detailARead-only
Get full details for a specific Federal Register document by document number. Returns title, abstract, full text URL, agencies, CFR references, and more.
Inputs: document_number (required).
fred_release_dataARead-only
Bulk fetch a FRED release. Common: 53 (GDP), 50 (Employment), 10 (CPI), 18 (Rates)
Inputs: release_id (required), limit.
fred_searchARead-only
Search FRED series by keyword. Examples: 'GDP', 'unemployment', 'CPI', 'mortgage rate'
Inputs: query (required), limit.
fred_series_dataARead-only
Get observations for a FRED series. Popular: GDP, UNRATE, CPIAUCSL, FEDFUNDS, DGS10, MORTGAGE30US
Inputs: series_id (required), limit, end_date, frequency, +2 more.
fred_series_infoARead-only
Get metadata for a FRED series — title, units, frequency, range, notes.
Inputs: series_id (required).
fr_executive_ordersARead-only
Search for presidential executive orders. Filter by president, year, or keyword. Covers all executive orders since 1994.
Inputs: page, year, keyword, per_page, +1 more.
fr_presidential_documentsARead-only
Search all presidential documents: executive orders, memoranda, proclamations, and other presidential actions.
Inputs: keyword, doc_type, end_date, per_page, +2 more.
fr_search_rulesARead-only
Search for proposed rules, final rules, and agency notices in the Federal Register. Use to track regulatory activity by agencies.
Inputs: agency, keyword, doc_type, end_date, +3 more.
ftc_dnc_complaintsARead-only
Search FTC Do Not Call (DNC) telemarketing complaints. Filter by consumer state, city, subject, or robocall flag. Returns complaint records with phone numbers, dates, and violation details.
Example: consumer_state='CA', is_robocall=true
Inputs: page, subject, page_size, is_robocall, +2 more.
ftc_hsr_noticesARead-only
Search FTC Hart-Scott-Rodino (HSR) merger early termination notices. Filter by company title or transaction number. Returns notices with transaction details and dates.
Example: title='Google'
Inputs: page, title, page_size, transaction_number.
ftm_contributionsARead-only
Search state-level campaign finance contributions by candidate, donor, state, and year. Covers all 50 states via the National Institute on Money in Politics.
Inputs: year, limit, state, donorId, +1 more.
fws_speciesARead-only
Search threatened and endangered species from the US Fish & Wildlife Service. Filter by name, status, state, or taxonomic group. Status codes: E=Endangered, T=Threatened, C=Candidate, PE=Proposed Endangered, PT=Proposed Threatened. Groups: Mammals, Birds, Reptiles, Amphibians, Fishes, Clams, Snails, Insects, Arachnids, Crustaceans, Flowering Plants, Ferns, etc.
Inputs: group, limit, query, state, +1 more.
fws_species_detailARead-only
Get detailed information about a listed species by TSN (Taxonomic Serial Number). Includes listing history, critical habitat, recovery plans, and range.
Inputs: tsn (required).
get_endpoint_fieldsARead-only
Get field names, data types, and formats for a specific Treasury Fiscal Data API endpoint. This helps you discover what fields are available before querying data.
Inputs: endpoint (required).
govinfo_bill_textARead-only
Get the FULL legislative text of a bill from GovInfo — the actual law language with section numbers, dollar amounts, legal citations, and provisions.
IMPORTANT: Try congress_bill_summaries first for a quick CRS summary (~500-2000 chars). Only use this tool when the user needs exact legislative language, specific provisions, or dollar amounts from the bill text.
Use preview_only=true first to check bill size before loading. Bills range from 5k chars (simple resolutions) to 500k+ (omnibus/appropriations). Default limit is 100k chars.
Version suffixes: enr (enrolled/signed), eh (engrossed House), es (engrossed Senate), ih (introduced House), is (introduced Senate)
Inputs: congress (required), bill_type (required), bill_number (required), version, +2 more.
govinfo_cbo_reportsARead-only
Search for Congressional Budget Office reports published through GovInfo. CBO scores tax bills with distributional analysis showing impact by income group.
Inputs: query (required), page_size.
govinfo_searchARead-only
Search across all government publications — bills, laws, CBO reports, Congressional Record, Federal Register, committee reports, and more.
Collections: BILLS, PLAW (public laws), CRPT (committee reports), CREC (Congressional Record), BUDGET, FR (Federal Register), CRECB (bound CR)
Inputs: query (required), congress, page_size, collection.
hmda_check_digitARead-only
Generate a ULI (Universal Loan Identifier) check digit from a loan ID. Appends the two-digit check digit to create a valid ULI. Used for HMDA reporting compliance.
Inputs: loan_id (required).
hmda_filersARead-only
List financial institutions that filed HMDA data for a given year. Returns institution names, LEIs, and filing details. Use to find LEIs for filtering aggregation queries by institution.
Inputs: year (required).
hmda_filtered_aggregationsARead-only
Get mortgage lending aggregation data filtered by geography or institution. Filter by state (FIPS code), MSA/MD, county, or institution (LEI). Same demographic filters as nationwide. At least one geographic or institution filter recommended.
Inputs: year (required), leis, races, sexes, +4 more.
hmda_nationwide_aggregationsARead-only
Get nationwide mortgage lending aggregation data from HMDA. Shows aggregate mortgage statistics across the entire U.S. for a given year. Filter by demographics (race, ethnicity, sex), loan characteristics, and actions taken. Useful for analyzing national mortgage lending trends and fair lending patterns.
Inputs: year (required), races, sexes, loan_types, +1 more.
hmda_rate_spreadARead-only
Calculate the rate spread for a mortgage loan using the CFPB rate spread calculator. Rate spread = difference between the loan APR and the average prime offer rate (APOR). Used for HMDA reporting and fair lending analysis.
Inputs: apr (required), loan_term (required), lock_in_date (required), reverse_mortgage (required), +2 more.
hmda_validate_uliARead-only
Validate a Universal Loan Identifier (ULI) by verifying its check digit. Returns whether the ULI is valid or invalid. Used for HMDA reporting compliance verification.
Inputs: uli (required).
hud_fair_market_rentsARead-only
Get HUD Fair Market Rents (FMR) for a county, metro area, or entire state. Shows monthly rent by bedroom count (efficiency through 4-bedroom). FMR determines Section 8 voucher amounts.
Inputs: year, state, entity_id.
hud_income_limitsARead-only
Get HUD Income Limits for a county, metro area, or entire state. Shows Very Low, Extremely Low, and Low income thresholds by household size (1-8 persons). Used for affordable housing eligibility.
Inputs: year, state, entity_id.
hud_list_countiesARead-only
List counties in a state with their FIPS codes. Use FIPS codes as entity_id in hud_fair_market_rents and hud_income_limits.
Inputs: state (required).
hud_list_metro_areasARead-only
List metropolitan/CBSA areas. CBSA codes can be used as entity_id in HUD tools.
Inputs: no named parameters.
hud_list_statesARead-only
List all U.S. states with their HUD state codes. Use these codes with other HUD tools.
Inputs: no named parameters.
isone_fuel_mixARead-only
Get current ISO New England generation fuel mix — breakdown of electricity generation by fuel type (natural gas, nuclear, hydro, wind, solar, oil, coal, etc.).
Shows real-time megawatt output by fuel category for the New England region.
Inputs: no named parameters.
isone_loadARead-only
Get current ISO New England system load (demand) — real-time 5-minute system load data.
ISO-NE serves Connecticut, Maine, Massachusetts, New Hampshire, Rhode Island, and Vermont.
Inputs: no named parameters.
ita_tariff_ratesARead-only
Search Free Trade Agreement (FTA) tariff rates by HTS code, partner country, or keyword. Returns tariff lines, rates, base rates, final year, and rule text for products covered by U.S. FTAs.
Inputs: limit, query, hts_subheading, partner_country.
ita_trade_eventsARead-only
Search international trade events including trade shows, trade missions, and seminars. Find upcoming events by keyword or country to help U.S. businesses expand internationally.
Inputs: limit, query, country.
jpl_close_approachesARead-only
Get asteroid/comet close approaches to Earth. Filter by date range, maximum distance (in AU), and result limit. 1 AU ≈ 150 million km (Earth-Sun distance). 0.05 AU ≈ 7.5 million km.
Example: date_min='2024-01-01', date_max='2024-12-31', dist_max='0.05'
Inputs: limit, date_max, date_min, dist_max.
jpl_fireballARead-only
Get reported fireball/bolide events from US Government sensors. Fireballs are very bright meteors — detected by DoD/DoE satellite sensors. Data includes date, location, velocity, energy, and altitude.
Example: date_min='2024-01-01', date_max='2024-12-31'
Inputs: limit, date_max, date_min.
jpl_small_bodyARead-only
Look up asteroid/comet orbital data by name, designation, or SPK-ID. Returns object identity, orbital elements, physical parameters, and close approach data.
Example: name='Apophis', name='2023 DW', name='Bennu'
Inputs: name (required).
la_metro_routesARead-only
List all LA Metro (Los Angeles) transit routes. Returns route IDs, names, types, and colors for bus and rail lines.
Inputs: no named parameters.
la_metro_stopsARead-only
List stops for an LA Metro (Los Angeles) route. Returns stop IDs, names, and coordinates. Optionally filter by route code.
Inputs: route.
la_metro_vehiclesARead-only
Get real-time bus and rail vehicle positions for LA Metro (Los Angeles). Returns GPS coordinates, route, trip, stop, and status for all active vehicles.
Inputs: no named parameters.
list_datasetsARead-only
List all 53 U.S. Treasury Fiscal Data API datasets and their 181 endpoints. Returns dataset name, data table name, API endpoint path, and description.
Inputs: no named parameters.
lobbying_contributionsARead-only
Search campaign contributions made by lobbyists — shows which lobbyists donated to which politicians. Required under the LDA to disclose political contributions by registered lobbyists.
Inputs: page_size, filing_year, lobbyist_name, registrant_name.
lobbying_detailARead-only
Get full detail on a specific lobbying filing — shows every issue lobbied, specific bills mentioned, and lobbyist names. Use the filing UUID from lobbying_search results.
Inputs: filing_uuid (required).
lobbying_lobbyistsARead-only
Search individual lobbyists by name or firm. Find specific people who lobby Congress and which firms they work for.
Inputs: firm, name, page_size.
lobbying_registrantsBRead-only
Search lobbying firms and organizations registered to lobby Congress.
Inputs: name (required), page_size.
lobbying_searchARead-only
Search lobbying disclosure filings — find out who is lobbying Congress, on what issues, and how much they're spending.
Search by:
registrant_name: lobbying firm or self-filing org ('Pfizer', 'Amazon', 'National Rifle Association')
client_name: who hired the lobbyist ('Google', 'ExxonMobil')
issue_code: policy area ('TAX', 'HCR' health, 'DEF' defense, 'ENV' environment, 'ENG' energy, 'IMM' immigration)
filing_year: year of filing (2020-2026)
Returns expenses/income amounts, issues lobbied, and registrant/client info.
Inputs: page_size, issue_code, client_name, filing_type, +2 more.
loc_browse_formatARead-only
Browse Library of Congress items by format/media type. Formats: audio, books, film-and-videos, legislation, manuscripts, maps, newspapers, photos, notated-music, web-archives.
Inputs: format (required), q, page.
loc_collection_browseARead-only
Browse a specific Library of Congress collection. Use loc_collections first to find collection slugs.
Inputs: slug (required), q, page.
loc_collectionsARead-only
List all Library of Congress digital collections. Returns collection names, descriptions, and item counts.
Inputs: no named parameters.
loc_item_detailARead-only
Get full metadata for a Library of Congress item. Returns title, subjects, dates, contributors, digital file links, and more.
Inputs: id (required).
loc_newspaper_searchARead-only
Full-text search of historical U.S. newspaper pages (Chronicling America, 1777–1963). Searches OCR text from digitized newspaper pages.
Inputs: text (required), page, rows, state, +2 more.
loc_newspaper_titlesARead-only
Search newspaper titles in Chronicling America. Find newspapers by name, state, or city.
Inputs: city, state, terms.
loc_searchARead-only
Search the Library of Congress across 40M+ items: books, maps, photos, manuscripts, audio, film, legislation. Examples: 'civil war', 'baseball cards', 'declaration of independence'
Inputs: q (required), page, sort, facet, +1 more.
marta_train_arrivalsARead-only
Get real-time MARTA rail arrival predictions for all stations in Atlanta, GA. Returns train destination, direction (N/S/E/W), line (RED, GOLD, BLUE, GREEN), station name, next arrival time, wait seconds, and GPS coordinates. Data covers all active trains across the entire MARTA rail network.
Inputs: no named parameters.
mbta_alertsARead-only
Get service alerts for MBTA (Boston) transit. Returns active alerts including delays, suspensions, detours, and planned service changes. Optionally filter by route.
Inputs: limit, route.
mbta_predictionsARead-only
Get real-time arrival/departure predictions for MBTA (Boston) transit. Filter by stop ID and/or route ID. Returns predicted arrival and departure times. Covers subway (Red, Orange, Blue, Green Lines), commuter rail, bus, and ferry.
Inputs: stop, limit, route.
mbta_routesARead-only
List MBTA (Boston) transit routes. Optionally filter by type: 0=Light Rail (Green Line), 1=Heavy Rail (Red/Orange/Blue), 2=Commuter Rail, 3=Bus, 4=Ferry.
Inputs: type, limit.
mbta_vehiclesARead-only
Get live vehicle positions for MBTA (Boston) transit. Returns GPS coordinates, speed, bearing, and current status for active vehicles. Optionally filter by route.
Inputs: limit, route.
md_bay_historicalARead-only
Get historical time-series data from a CBIBS buoy station. Query specific variable over a date range for trend analysis. Variables: 'water_temp' (Water Temperature (°C)), 'salinity' (Salinity (PSU)), 'dissolved_oxygen' (Dissolved Oxygen (mg/L)), 'ph' (pH), 'turbidity' (Turbidity (NTU)), 'chlorophyll' (Chlorophyll (µg/L)), 'wind_speed' (Wind Speed (m/s)), 'wind_direction' (Wind Direction (degrees)), ... (13 total). Stations: 'UP' (Upper Potomac), 'GR' (Gooses Reef), 'J' (Jamestown), 'FL' (First Landing), 'SR' (Stingray Point), 'PL' (Point Lookout), 'AN' (Annapolis), 'YS' (York Spit), 'N' (Norfolk), 'SN' (Susquehanna), 'S' (South).
Inputs: station (required), end_date (required), variable (required), start_date (required).
md_bay_latestARead-only
Get latest readings from a CBIBS buoy station. Returns current water temperature, salinity, dissolved oxygen, pH, wind, waves, and more. Stations: 'UP' (Upper Potomac), 'GR' (Gooses Reef), 'J' (Jamestown), 'FL' (First Landing), 'SR' (Stingray Point), 'PL' (Point Lookout), 'AN' (Annapolis), 'YS' (York Spit), 'N' (Norfolk), 'SN' (Susquehanna), 'S' (South).
Inputs: station (required).
md_bay_stationsARead-only
List all Chesapeake Bay CBIBS buoy stations with their locations and current status. Stations: 'UP' (Upper Potomac), 'GR' (Gooses Reef), 'J' (Jamestown), 'FL' (First Landing), 'SR' (Stingray Point), 'PL' (Point Lookout), 'AN' (Annapolis), 'YS' (York Spit), 'N' (Norfolk), 'SN' (Susquehanna), 'S' (South).
Inputs: no named parameters.
md_traffic_camerasARead-only
Get traffic camera locations across Maryland highways. Returns camera IDs, locations, and image URLs for real-time visual monitoring.
Inputs: no named parameters.
md_traffic_closuresARead-only
Get active road closures on Maryland highways. Includes planned and emergency closures with start/end times.
Inputs: no named parameters.
md_traffic_incidentsARead-only
Get active traffic incidents on Maryland highways in real-time. Includes accidents, disabled vehicles, debris, construction, and other events. Data from CHART (MDOT SHA) — updates continuously.
Inputs: no named parameters.
md_traffic_signsARead-only
Get dynamic message sign (DMS) content on Maryland highways. Shows current messages displayed on electronic highway signs — alerts, travel times, events.
Inputs: no named parameters.
md_traffic_speedsARead-only
Get speed sensor data from Maryland highways. Includes average speed, traffic volume, and lane occupancy from detector stations. Useful for identifying congestion and travel conditions.
Inputs: no named parameters.
md_traffic_travel_timesARead-only
Get travel time data for major Maryland highway routes. Shows current travel time vs free-flow time, average speed, and route distance.
Inputs: no named parameters.
md_traffic_weatherARead-only
Get road weather data from RWIS (Road Weather Information System) stations. Includes air/surface temperature, humidity, wind, precipitation, and visibility. Critical for winter weather road condition assessment.
Inputs: no named parameters.
md_transit_feedsARead-only
Get Maryland MTA GTFS feed URLs for all transit modes. Returns download URLs for static schedule data (ZIP archives containing GTFS CSVs). Modes: Local Bus, Light Rail, Metro Subway, MARC Train, Commuter Bus. Also includes real-time feed URLs (protobuf format) for MARC train and service alerts.
Inputs: no named parameters.
md_transit_trip_updatesARead-only
Get real-time trip updates (delays, cancellations) for Maryland MTA transit. Requires SWIFTLY_API_KEY environment variable (free, request from MTA). Agencies: 'mta-maryland' (Local Bus), 'mta-maryland-light-rail' (Light Rail), 'mta-maryland-metro' (Metro Subway), 'mta-maryland-commuter-bus' (Commuter Bus).
Inputs: agency (required).
md_transit_vehiclesARead-only
Get real-time vehicle positions for Maryland MTA transit. Requires SWIFTLY_API_KEY environment variable (free, request from MTA). Agencies: 'mta-maryland' (Local Bus), 'mta-maryland-light-rail' (Light Rail), 'mta-maryland-metro' (Metro Subway), 'mta-maryland-commuter-bus' (Commuter Bus).
Inputs: agency (required).
mn_lake_detailARead-only
Get full details for a Minnesota lake by ID. Includes fish species, surveys, water quality, depth, and consumption guidance. Use mn_lake_search or mn_lake_nearby to find lake IDs.
Inputs: id (required).
mn_lake_nearbyARead-only
Find Minnesota lakes near a latitude/longitude point. Returns lakes within the specified radius (in miles, default 5).
Inputs: lat (required), lon (required), radius.
mn_lake_searchARead-only
Search Minnesota lakes by name. Returns matching lakes with IDs, names, counties, acreage, and max depth. Use the lake ID from results with mn_lake_detail for full information.
Inputs: name (required).
naep_achievement_levelsBRead-only
Get the percentage of students at each NAEP achievement level: Below Basic, Basic, Proficient, Advanced. THIS IS THE KEY LITERACY/NUMERACY METRIC — shows what % of students can read/do math at grade level. Example: '37% of 4th graders scored Below Basic in reading' comes from this data.
Inputs: grade (required), subject (required), year, variable, +1 more.
naep_available_variablesARead-only
List available independent variables for a NAEP subject, cohort, and year. Use this to discover what demographic/survey variables are available before querying scores. Returns variable names (Varname), short labels, and long labels.
Inputs: years (required), cohort (required), subject (required).
naep_compare_groupsARead-only
Compare NAEP scores across demographic groups (race, gender, poverty) with significance testing. Shows achievement gaps between groups (e.g., White vs Black, Male vs Female, eligible vs not eligible for free lunch).
Inputs: grade (required), subject (required), variable (required), year, +1 more.
naep_compare_statesARead-only
Compare NAEP scores across states/jurisdictions with significance testing. Shows which states score significantly higher or lower than others. Example: Compare Massachusetts vs Mississippi reading scores.
Inputs: grade (required), subject (required), jurisdictions (required), year, +1 more.
naep_compare_yearsARead-only
Compare NAEP scores across assessment years with significance testing. Shows whether score changes between years are statistically significant. Great for tracking the COVID learning loss and recovery.
Inputs: grade (required), years (required), subject (required), variable, +1 more.
naep_gap_variable_jurisdictionARead-only
Compare how achievement gaps between demographic groups differ across states. Example: Is the poverty gap in math bigger in Mississippi than Massachusetts? Returns innerdiff1 (group gap for focal jurisdiction), innerdiff2 (group gap for target), and the gap between them.
Inputs: grade (required), subject (required), variable (required), jurisdictions (required), +1 more.
naep_gap_variable_yearsARead-only
Compare how achievement gaps between demographic groups change over time. Example: Is the racial achievement gap in reading getting bigger or smaller since 2017? Returns innerdiff1 (group gap for focal year), innerdiff2 (group gap for target year), and the gap between them.
Inputs: grade (required), years (required), subject (required), variable (required), +1 more.
naep_gap_year_jurisdictionARead-only
Compare how score changes between years differ across jurisdictions. Example: Did the COVID learning loss hit California harder than Massachusetts? Returns innerdiff1 (year gap for focal jurisdiction), innerdiff2 (year gap for target), and the gap between them.
Inputs: grade (required), years (required), subject (required), jurisdictions (required), +1 more.
naep_scoresARead-only
Get NAEP test scores (Nation's Report Card) — the gold standard for measuring U.S. student achievement. Returns average scale scores by subject, grade, state, and demographic group.
Subjects: 'reading', 'math', 'science', 'writing', 'civics', 'history', 'geography', 'economics', 'tel', 'music' Grades: 4, 8, 12 (math: 4,8 only; economics/tel/music: 8 or 12 only) Variables: 'TOTAL' (all students), 'SDRACE' (race), 'GENDER', 'SLUNCH3' (school lunch/poverty), 'PARED' (parent education) Jurisdiction: 'NP' (national public), or state codes ('CA', 'TX', 'NY', 'MS')
Inputs: grade (required), subject (required), year, subscale, +4 more.
nara_recordARead-only
Get full details for a specific National Archives record by NARA ID. Returns complete metadata, descriptions, creators, and links to digitized content when available.
Inputs: nara_id (required).
nara_searchARead-only
Search the National Archives catalog for historical records, documents, photographs, and government publications. Returns record metadata including titles, descriptions, dates, and links to digitized content. Rate limited to 10,000 queries/month.
Inputs: query (required), limit, offset.
nasa_donkiBRead-only
Get space weather events from NASA DONKI. Types: CME, CMEAnalysis, GST (geomagnetic storm), IPS, FLR (solar flare), SEP, MPC, RBE, HSS, notifications.
Inputs: type, end_date, start_date.
nasa_eonetBRead-only
Get Earth natural events from NASA EONET. Categories: wildfires, severeStorms, volcanoes, seaLakeIce, earthquakes, floods, landslides, etc.
Inputs: limit, status, category.
nasa_image_assetARead-only
Get all rendition URLs (original, large, medium, small, thumbnail) for a NASA media asset. Use a nasa_id from search results.
Inputs: nasa_id (required).
nasa_image_captionsARead-only
Get the URL to the SRT subtitle/captions file for a NASA video asset.
Inputs: nasa_id (required).
nasa_image_metadataARead-only
Get the URL to the full EXIF/XMP/IPTC metadata JSON file for a NASA media asset.
Inputs: nasa_id (required).
nasa_image_searchARead-only
Search NASA's image, video, and audio library. Filter by keyword, center (JSC, KSC, JPL, GSFC, etc.), media type, year range, and more.
Inputs: q, page, title, center, +9 more.
nasa_mars_photosARead-only
Get Mars Rover photos by sol (Mars day) or Earth date. Rovers: curiosity, opportunity, spirit. Cameras: FHAZ, RHAZ, MAST, CHEMCAM, NAVCAM, etc.
Inputs: sol, rover, camera, earth_date.
nasa_neoARead-only
Search Near-Earth Objects (asteroids/comets) by date range. Returns close approach data, estimated diameter, velocity, and hazard assessment.
Inputs: end_date, start_date.
nasa_neo_detailARead-only
Get detailed information about a specific Near-Earth Object by asteroid ID.
Inputs: asteroid_id (required).
nc_linc_queryARead-only
Query a specific NC LINC dataset with optional filters. Use nc_linc_search first to find dataset IDs. Common datasets: 'employment-and-income-linc', 'census-population-and-housing-linc', 'vehicle-registration', 'government', 'nc-transportation-linc'.
Inputs: dataset_id (required), limit, where, offset.
nc_linc_searchARead-only
Search across all NC LINC datasets by keyword. Returns matching datasets with IDs, titles, descriptions, and record counts. Use the dataset ID from results with nc_linc_query to fetch actual data.
Inputs: query (required), limit.
nhtsa_car_seat_stationsARead-only
Find car seat inspection stations near a location. Search by ZIP code, state, or geographic coordinates. Car seat inspection stations help parents verify proper installation.
Example: state='CA', or zip='90210', or lat=30.18 + long=-96.39 + miles=50
Inputs: lat, zip, long, miles, +1 more.
nhtsa_complaint_detailARead-only
Get a specific complaint by its ODI number. ODI numbers are in complaint search results (e.g. 11184030).
Inputs: odi_number (required).
nhtsa_complaintsARead-only
Search NHTSA vehicle complaints by make, model, and model year. All three parameters are required by the NHTSA API. Use nhtsa_models to find valid models for a make.
Example: make='tesla', model='model 3', model_year=2023
Inputs: make (required), model (required), model_year (required).
nhtsa_decode_vinARead-only
Decode a Vehicle Identification Number (VIN) to get specifications. Returns make, model, year, engine, body class, drive type, plant info. VINs are 17 characters.
Inputs: vin (required).
nhtsa_makesARead-only
List vehicle makes for a model year that have recalls or complaints. Use issue_type='r' for recalls, 'c' for complaints.
Example: model_year=2024, issue_type='r'
Inputs: issue_type (required), model_year (required).
nhtsa_modelsARead-only
List vehicle models for a make and year that have recalls or complaints. Or list all models for a make from the vPIC database (omit issue_type).
Example: make='tesla', model_year=2024, issue_type='r'
Inputs: make (required), issue_type, model_year.
nhtsa_model_yearsARead-only
List model years that have recalls or complaints in the NHTSA database. Use issue_type='r' for recalls (1949–present), 'c' for complaints. Useful for discovering available data before querying.
Inputs: issue_type (required).
nhtsa_recall_detailARead-only
Get recall details by NHTSA campaign number. Campaign numbers look like '23V838000' or '12V176000'. Returns full recall information including affected vehicles, summary, consequence, and remedy.
Inputs: campaign_number (required).
nhtsa_recallsARead-only
Search NHTSA vehicle recalls by make, model, and model year. All three parameters are required by the NHTSA API. Use nhtsa_models to find valid models for a make, or nhtsa_recall_detail for a specific campaign.
Example: make='tesla', model='model 3', model_year=2024
Inputs: make (required), model (required), model_year (required).
nhtsa_safety_rating_detailARead-only
Get detailed NHTSA 5-star safety ratings for a specific vehicle variant. Requires a VehicleId from nhtsa_safety_ratings search results. Returns crash test ratings, rollover risk, and safety technology assessments.
Inputs: vehicle_id (required).
nhtsa_safety_ratingsARead-only
Search NHTSA 5-star safety ratings (NCAP) by make, model, and year. Returns vehicle variants with VehicleId. Use the VehicleId with nhtsa_safety_rating_detail.
Ratings: 5 stars = highest, 1 star = lowest. Data from 1990 to present.
Inputs: make (required), model (required), model_year (required).
nih_projects_by_agencyARead-only
Get project counts by NIH institute/center for a fiscal year. Shows which institutes fund the most research: NCI (cancer), NIAID (infectious diseases), etc. Useful for understanding NIH budget allocation across disease areas.
Inputs: fiscal_year (required), agencies.
nih_search_projectsARead-only
Search NIH-funded research projects by text, disease area, investigator, institution, state, agency, spending category, grant type, and funding amount. Returns project number, title, PI, organization, award amount, agency, activity code, and dates. Use to find research grants for any disease, track institutional funding, or identify PIs.
Inputs: text, limit, offset, pi_name, +13 more.
nih_search_publicationsARead-only
Search for publications linked to NIH-funded projects. Search by PubMed IDs (PMIDs), application IDs, or core project numbers. Returns PMID and linked project number.
Inputs: limit, pmids, offset, appl_ids, +1 more.
nih_spending_by_categoryARead-only
Get NIH project counts and estimated funding for a disease/research area across fiscal years. Uses RCDC spending categories with an agency-based fallback for more accurate counts. Common category IDs: 27=Cancer, 7=Alzheimer's, 41=Diabetes, 60=HIV/AIDS, 93=Opioids, 30=Cardiovascular, 85=Mental Health, 38=COVID-19, 118=Stroke, 92=Obesity. Note: For the most reliable counts by disease area, also try nih_projects_by_agency with the relevant institute.
Inputs: category_id (required), fiscal_years (required).
noaa_climate_dataARead-only
Get climate observations (temperature, precipitation, snow, wind) from NOAA. Requires dataset ID + date range. Optionally filter by station or location.
Inputs: end_date (required), dataset_id (required), start_date (required), limit, +3 more.
noaa_datasetsARead-only
List available NOAA climate datasets (GHCND daily, GSOM monthly, GSOY annual, normals, etc.)
Inputs: no named parameters.
noaa_locationsARead-only
Search NOAA location IDs (states, cities, countries) for use with other NOAA tools.
Inputs: limit, category, dataset_id.
noaa_stationsARead-only
Search for NOAA weather stations by location or dataset. Use location IDs like FIPS:36 (New York), FIPS:06 (California), CITY:US360019 (NYC).
Inputs: limit, dataset_id, location_id.
nps_alertsARead-only
Get current park alerts including closures, dangers, cautions, and general information. Optionally filter by park code. Useful for checking conditions before visiting.
Inputs: limit, park_code.
nps_campgroundsARead-only
Search campgrounds in national parks. Returns campground names, descriptions, reservation info, site counts, and coordinates. Filter by park code, state, or keyword.
Inputs: limit, query, state, park_code.
nps_eventsARead-only
Get upcoming events at national parks. Returns event titles, dates, locations, categories, and registration info. Optionally filter by park code.
Inputs: limit, park_code.
nps_parksARead-only
Search national parks by state, name, or keyword. Returns park names, descriptions, states, designations, coordinates, and weather info. Use this to discover park codes needed by other NPS tools.
Inputs: limit, query, state, park_code.
nrel_fuel_stationsARead-only
Search for EV charging stations, hydrogen stations, biodiesel, CNG, and other alternative fuel stations. Covers all U.S. alt fuel infrastructure. Filter by state, zip, fuel type, radius.
Fuel types: 'ELEC' (EV), 'HY' (hydrogen), 'CNG' (natural gas), 'LPG' (propane), 'BD' (biodiesel), 'E85' (ethanol)
Inputs: zip, limit, state, radius, +2 more.
nrel_solarARead-only
Get solar energy resource data for any U.S. location — monthly and annual solar irradiance. Shows potential for solar panels at a given location.
Inputs: lat (required), lon (required).
nrel_utility_ratesARead-only
Get residential, commercial, and industrial electricity rates for any U.S. location. Provide latitude/longitude to get the local utility and their rates ($/kWh).
Inputs: lat (required), lon (required).
nsf_award_detailARead-only
Get full details of an NSF research award by award ID. Returns title, PI info, institution, funding, abstract, program, and co-PIs.
Inputs: awardId (required).
nsf_awards_searchARead-only
Search NSF research awards by keyword, principal investigator, institution, or program. Returns award titles, PI names, institutions, funding amounts, and dates.
Inputs: limit, offset, piName, keyword, +2 more.
ntsb_aviation_accidentsARead-only
Search NTSB aviation accident investigation data. Find accident reports by aircraft type, location, date, or other keywords. Returns event details, injuries, aircraft info, probable cause, and report status.
Example: query='Boeing 737 MAX', query='Cessna engine failure', query='helicopter New York'
Inputs: query (required), limit, offset.
ntsb_queryARead-only
Query any NTSB investigation dataset by transportation mode. Modes: Aviation, Highway, Marine, Rail, Pipeline. Returns investigation records with event details, injuries, and probable cause.
Example: mode='Highway', query='truck rollover'; mode='Marine', query='ferry collision'
Inputs: mode (required), query (required), limit, offset.
nvd_cve_detailARead-only
Get full details of a CVE vulnerability by its CVE ID. Returns CVSS scores, attack vectors, affected products (CPE), weaknesses (CWE), and references.
Inputs: cveId (required).
nvd_cve_searchARead-only
Search CVE vulnerabilities in the National Vulnerability Database by keyword, CVSS severity, and date range. Returns CVE IDs, descriptions, CVSS scores, severity levels, and publication dates.
Severity values: LOW, MEDIUM, HIGH, CRITICAL
Inputs: limit, keyword, severity, pubEndDate, +1 more.
nws_alert_detailARead-only
Get full details for a specific weather alert by ID. Includes complete description, instruction text, affected areas, and timing.
Inputs: alert_id (required).
nws_alerts_activeBRead-only
Get active weather alerts (warnings, watches, advisories). Filter by state, event type, severity, urgency, or certainty.
Inputs: area, event, limit, urgency, +2 more.
nws_alerts_by_stateARead-only
Get all active weather alerts for a specific state. Returns warnings, watches, and advisories currently in effect.
Inputs: state (required).
nws_aviation_sigmetsARead-only
Get current aviation SIGMETs (Significant Meteorological Information). Returns active SIGMETs with phenomenon type, timing, and affected areas.
Inputs: no named parameters.
nws_forecastARead-only
Get 7-day weather forecast. Provide EITHER (office + grid_x + grid_y) from a point lookup, OR (latitude + longitude) to auto-resolve. Returns forecast periods with temperature, wind, and conditions.
Inputs: grid_x, grid_y, office, latitude, +1 more.
nws_forecast_hourlyARead-only
Get hourly weather forecast. Provide EITHER (office + grid_x + grid_y) from a point lookup, OR (latitude + longitude) to auto-resolve. Returns hourly periods with temperature, wind, and conditions.
Inputs: grid_x, grid_y, office, latitude, +1 more.
nws_glossaryARead-only
Get NWS weather glossary — definitions of weather terms and abbreviations.
Inputs: no named parameters.
nws_observation_historyARead-only
Get recent observation history from a weather station. Returns multiple observations with temperature, wind, humidity, etc. Optionally filter by date range.
Inputs: station_id (required), end, limit, start.
nws_observation_latestARead-only
Get the latest weather observation from a station. Returns temperature, wind, humidity, pressure, visibility, and conditions. Station IDs are ICAO codes (e.g. KJFK, KLAX, KORD).
Inputs: station_id (required).
nws_point_lookupARead-only
Resolve latitude/longitude to an NWS forecast grid point. Returns grid office, gridX, gridY needed for forecast calls, plus timezone and county info. This is the essential first step before getting forecasts.
Inputs: latitude (required), longitude (required).
nws_radar_stationsARead-only
List NWS radar stations across the U.S. Returns station IDs, names, types, and coordinates.
Inputs: no named parameters.
nws_stationsARead-only
Find weather observation stations. Search by state code, or provide latitude + longitude to find nearby stations. Station IDs can be used with observation tools.
Inputs: limit, state, latitude, longitude.
nws_text_productsARead-only
Get NWS text products like Area Forecast Discussions (AFD), Hazardous Weather Outlooks (HWO), etc. Requires a product type code. Optionally filter by WFO location.
Inputs: type (required), location.
nws_zone_forecastARead-only
Get text forecast for a specific NWS forecast zone. Zone IDs look like 'NYZ072', 'CAZ006', etc.
Inputs: zone_id (required).
nws_zonesARead-only
List NWS forecast zones. Filter by zone type (forecast, fire, county, coastal) and/or state.
Inputs: area, type, limit.
oba_arrivalsARead-only
Get real-time arrival and departure predictions for a Puget Sound (Seattle area) transit stop. Returns predicted and scheduled times, route info, vehicle tracking, and distance from stop. Covers King County Metro, Sound Transit, Pierce Transit, Community Transit, and more.
Inputs: stop_id (required).
oba_routesARead-only
List transit routes for a Puget Sound agency. Default agency '1' is King County Metro (Seattle). Returns route names, types, and descriptions.
Inputs: agency_id.
ofac_consolidated_listARead-only
Get the consolidated non-SDN sanctions list (sectoral sanctions, foreign sanctions evaders, etc.).
Inputs: limit.
ofac_exportsARead-only
List available OFAC sanctions data export files and formats.
Inputs: no named parameters.
ofac_filterARead-only
Filter OFAC SDN list by program, entity type, or country (substring match). At least one filter parameter should be provided.
Inputs: limit, country, program, entity_type.
ofac_sdn_listBRead-only
Get the OFAC SDN (Specially Designated Nationals) list — primary U.S. sanctions targets. Returns top entries. Large list; use limit to control size.
Inputs: limit.
ofac_searchARead-only
Search OFAC SDN sanctions list by name or entity (case-insensitive substring match).
Inputs: name (required), limit.
open_payments_by_companyARead-only
Get payment summary data grouped by pharmaceutical/device company (all years combined). Shows total amounts and number of payments per company.
Inputs: limit.
open_payments_by_hospitalARead-only
Get payments grouped by teaching hospital. Shows total pharma payments to teaching hospitals — useful for identifying institutional conflicts of interest.
Inputs: limit.
open_payments_by_physicianARead-only
Get payments grouped by individual physician across all years. Pre-aggregated totals — shows how much each doctor received from pharma overall.
Inputs: limit.
open_payments_by_specialtyARead-only
Get national payment totals and averages by medical specialty. Shows which specialties receive the most pharma money — cardiologists, orthopedic surgeons, psychiatrists, etc.
Inputs: limit.
open_payments_ownershipARead-only
Search Open Payments OWNERSHIP data — doctors with ownership or investment stakes in pharma/device companies. The deepest form of conflict of interest. Shows which doctors have financial interests in the companies whose products they prescribe.
Inputs: year, limit, state, doctor, +1 more.
open_payments_researchARead-only
Search Open Payments RESEARCH payment data — grants, clinical research funding from pharma to doctors. Separate from general payments. Shows research funding amounts, sponsors, and principal investigators.
Inputs: year, limit, state, doctor, +1 more.
open_payments_searchARead-only
Search CMS Open Payments (Sunshine Act) data — payments from pharma/device companies to doctors. 15M+ records per year. Shows exact dollar amounts, payment type, doctor name/specialty, and which drugs/devices are involved. Cross-reference with FDA (drug safety), lobbying (company influence), and clinical trials.
Inputs: year, limit, state, doctor, +2 more.
open_payments_summaryARead-only
Get national-level Open Payment totals and averages across all years. Shows how much money flows from pharma to doctors nationally.
Inputs: no named parameters.
open_payments_topARead-only
Find the HIGHEST pharma payments to doctors — sorted by amount descending.\nUse this to find the biggest consulting fees, royalties, and speaking fees in a state or specialty.\nSupports sorting by payment amount — unlike the basic search which returns results in default order.
Inputs: year, limit, state, doctor, +2 more.
open_payments_top_doctorsARead-only
Find the HIGHEST-PAID doctors by TOTAL payments received — aggregates all individual payments per doctor. Groups by doctor and sums all their payments, sorted by total descending. This is the key tool for finding doctors with the biggest pharma relationships.
Inputs: year, limit, state, company, +1 more.
openstates_bill_detailARead-only
Get full details for a specific state bill by its OpenStates ID. Returns complete bill information including sponsors, actions, votes, and documents.
Inputs: openstates_id (required).
openstates_billsARead-only
Search bills across all 50 state legislatures. Filter by state (jurisdiction), keyword query, and legislative session. Returns bill identifiers, titles, sessions, and sponsors.
Inputs: page, limit, query, session, +1 more.
openstates_legislatorsARead-only
Search state legislators across all 50 states. Filter by state (jurisdiction) and name. Returns legislator names, parties, chambers, districts, and contact info.
Inputs: name, page, limit, jurisdiction.
opm_current_statusARead-only
Get the current federal government operating status for the Washington, DC area. Returns status title, summary, messages, and posting date. Covers weather closures, emergencies, and other events affecting federal offices. Optionally query a specific date's status using MM/DD/YYYY format.
Inputs: date, useutc.
opm_status_historyARead-only
Get historical federal government operating status records. Returns past status changes including closures, delays, and early departures. Supports pagination with startrow and count parameters (max 5000 per request).
Inputs: count, startrow.
opm_status_typesARead-only
List all possible federal government operating status types. Returns reference data for status categories: Open, Closed, Delayed Arrival, Early Departure, etc.
Inputs: no named parameters.
os_candidate_summaryARead-only
Get a candidate's fundraising summary — total raised, spent, cash on hand, debt. Requires OpenSecrets CID (e.g. N00007360).
Inputs: cid (required), cycle.
os_industry_totalsBRead-only
Get industry contribution totals for a candidate. Shows how much each industry sector contributed via PACs and individuals.
Inputs: cid (required), cycle.
os_top_contributorsARead-only
Get top contributors (organizations) to a candidate. Shows PAC and individual contributions by organization.
Inputs: cid (required), cycle.
path_arrivalsARead-only
Get real-time PATH train arrival times for all stations in the NY/NJ metro area. Returns station names, line info, projected arrival times, and train status. PATH connects Manhattan to Jersey City, Hoboken, Harrison, and Newark. No API key required.
Inputs: no named parameters.
pubmed_cited_byARead-only
Find articles that cite a given PMID. Useful for tracking the impact and influence of a paper — which subsequent papers reference it. Use pubmed_summary on the returned PMIDs to get article details.
Inputs: pmid (required).
pubmed_databasesARead-only
List all available NCBI Entrez databases (PubMed, PMC, Gene, Protein, etc.). Useful for discovering which NCBI databases exist beyond PubMed.
Inputs: no named parameters.
pubmed_fetchARead-only
Get full article abstracts as plain text or XML for one or more PMIDs. Returns the complete abstract text including title, authors, affiliation, and abstract body. Use for reading full abstracts when pubmed_summary metadata is not enough.
Inputs: pmids (required), format.
pubmed_infoARead-only
Get PubMed database statistics: total record count, last update, searchable fields, and available link types. Useful for discovering which fields are available for targeted searches (e.g. [MeSH Terms], [Author], [Journal]).
Inputs: no named parameters.
pubmed_searchARead-only
Search PubMed for biomedical articles by keyword, MeSH term, author, or date range. Returns PMIDs and search metadata. Use pubmed_summary to get full article details for the returned PMIDs. Supports Boolean operators (AND, OR, NOT) and field tags like [MeSH Terms], [Author], [Journal].
Inputs: query (required), sort, offset, max_date, +3 more.
pubmed_search_and_summarizeARead-only
Combined search + summary: searches PubMed and returns full article metadata in one call. Convenience tool that chains pubmed_search → pubmed_summary. Returns article titles, authors, journals, dates, and DOIs directly.
Inputs: query (required), sort, offset, max_date, +3 more.
pubmed_summaryARead-only
Get article summaries (title, authors, journal, date, DOI) for one or more PMIDs. Use after pubmed_search to get full metadata for returned PMIDs. Accepts up to 200 PMIDs at once.
Inputs: pmids (required).
query_fiscal_dataARead-only
Query the U.S. Treasury Fiscal Data API. Supports field selection, filtering, sorting, and pagination.
Filter operators: eq (equal), gt, gte, lt, lte, in. Example filter: 'record_date:gte:2024-01-01' Example sort: '-record_date' (descending) Multiple filters: 'country_currency_desc:in:(Canada-Dollar,Mexico-Peso),record_date:gte:2024-01-01'
Inputs: endpoint (required), sort, fields, filter, +2 more.
rec_areasARead-only
Search federal recreation areas by keyword or state. Recreation areas are larger regions that may contain multiple facilities.
Returns area names, descriptions, and locations.
Inputs: limit, query, state, offset.
rec_campsitesARead-only
Search available campsites at a specific recreation facility. Use rec_facilities first to find facility IDs.
Returns campsite names, types, loops, and accessibility info.
Inputs: facility_id (required), limit.
rec_facilitiesARead-only
Search federal recreation facilities — campgrounds, parks, trails, lakes, and more. Filter by keyword, state, or activity type.
Returns facility names, types, locations, and IDs (use IDs with rec_campsites).
Inputs: limit, query, state, offset, +1 more.
regulations_comment_detailARead-only
Get detailed information for a specific public comment by its comment ID.
Inputs: commentId (required).
regulations_docket_detailARead-only
Get detailed information for a specific regulatory docket by its docket ID (e.g. 'EPA-HQ-OAR-2003-0129').
Inputs: docketId (required).
regulations_document_detailARead-only
Get detailed information for a specific regulatory document by its document ID (e.g. 'FDA-2009-N-0501-0012').
Inputs: documentId (required).
regulations_search_commentsARead-only
Search for public comments on federal regulations. Filter by keyword, agency, docket, or date. Shows what the public said about proposed rules.
Sort: 'postedDate' (asc) or '-postedDate' (desc, newest first).
Inputs: sort, agencyId, docketId, pageSize, +4 more.
regulations_search_docketsARead-only
Search for regulatory dockets — organizational folders containing related rules, comments, and documents. Each docket represents a rulemaking or non-rulemaking action by a federal agency.
Sort: 'title', '-title'.
Inputs: sort, agencyId, pageSize, docketType, +2 more.
regulations_search_documentsARead-only
Search for federal regulatory documents — proposed rules, final rules, and supporting materials. Filter by agency, docket, date, or keyword. Complements Federal Register data with rulemaking context.
Document types: 'Proposed Rule', 'Rule', 'Supporting & Related Material', 'Other'. Sort: 'postedDate' (asc) or '-postedDate' (desc, newest first).
Inputs: sort, agencyId, docketId, pageSize, +6 more.
sam_entitiesBRead-only
Search registered entities (businesses/orgs) on SAM.gov. Lookup by UEI, CAGE code, business name, or state.
Inputs: uei, name, limit, state, +1 more.
sam_exclusionsARead-only
Search SAM.gov exclusions (debarments/suspensions). Check if an entity is excluded from federal contracting.
Inputs: uei, name, limit, classification.
samhsa_treatment_searchARead-only
Find substance abuse and mental health treatment facilities by location. Service types: SA (substance abuse), MH (mental health), BOTH.
Inputs: address (required), limit, serviceType.
sam_opportunitiesARead-only
Search federal contract opportunities on SAM.gov. Filter by keyword, NAICS code, set-aside type, and posted date range.
Inputs: limit, naics, keyword, posted_to, +2 more.
sbir_awards_searchARead-only
Search SBIR/STTR small business innovation research awards. Find government-funded R&D awards by keyword, agency, company, or year. Covers all federal agencies that participate in SBIR/STTR programs.
Common agencies: DOD, NASA, NIH, NSF, DOE, USDA, EPA, DOT.
Example: keyword='quantum computing', agency='DOD', limit=10
Inputs: year, limit, agency, offset, +2 more.
scorecard_compareARead-only
Compare specific colleges side-by-side on cost, graduation rate, earnings, and debt. Provide school names to search and compare.
Inputs: schools (required).
scorecard_queryARead-only
Advanced College Scorecard query with custom field filters and ranges.
Filter examples:
'latest.admissions.admission_rate.overall__range=0..0.10' (schools with <10% admission rate)
'latest.cost.tuition.in_state__range=..5000' (tuition under $5K)
'school.degrees_awarded.predominant=3' (bachelor's-granting)
'latest.earnings.10_yrs_after_entry.median__range=80000..' (high-earning graduates)
Inputs: filters (required), sort, per_page.
scorecard_searchARead-only
Search U.S. colleges and universities from the College Scorecard. Returns tuition, admission rate, graduation rate, median earnings after graduation, student debt.
Search by name, state, or school type. Sort by cost, earnings, or graduation rate.
Inputs: name, sort, state, per_page, +1 more.
scorecard_topARead-only
Get top-ranked colleges by earnings, graduation rate, or lowest cost. Rankings: 'earnings' (highest median pay 10yr after entry), 'graduation' (highest completion rate), 'expensive' (highest tuition)
Inputs: ranking (required), state, per_page, ownership.
search_datasetsARead-only
Search for Treasury Fiscal Data datasets and endpoints by keyword. Searches across all 53 datasets (181 endpoints) by name, table name, endpoint path, and description.
Inputs: query (required).
sec_company_financialsARead-only
Get financial data (revenue, net income, assets, etc.) from SEC XBRL filings for a company. Returns standardized financial data extracted from 10-K and 10-Q filings.
Requires CIK number. Use sec_company_search to look up filings first.
Common XBRL concepts: Revenues, NetIncomeLoss, Assets, Liabilities, StockholdersEquity, EarningsPerShareBasic, CashAndCashEquivalentsAtCarryingValue
Inputs: cik (required), metric.
sec_company_searchARead-only
Look up a company on SEC EDGAR by CIK number. Returns company name, tickers, SIC code, state, and recent filings list.
Common CIK numbers:
Apple: 0000320193
Microsoft: 0000789019
Amazon: 0001018724
Lockheed Martin: 0000936468
Raytheon (RTX): 0000101829
Boeing: 0000012927
To find CIK: search by company name using sec_filing_search.
Inputs: cik (required).
sec_filing_searchARead-only
Full-text search across all SEC EDGAR filings. Search by company name, keyword, or topic.
Form types: 10-K (annual), 10-Q (quarterly), 8-K (current events), DEF 14A (proxy), S-1 (IPO registration)
Inputs: query (required), forms, end_date, start_date.
septa_alertsARead-only
Get service alerts for all SEPTA (Philadelphia) transit routes. Returns current messages, advisories, detour information, and snow alerts.
Inputs: no named parameters.
septa_bus_viewARead-only
Get real-time bus/trolley positions for a SEPTA (Philadelphia) route. Returns GPS coordinates, vehicle ID, direction, destination, and delay for all active vehicles on the route.
Inputs: route (required).
septa_next_to_arriveARead-only
Get next trains arriving between two SEPTA (Philadelphia) regional rail stations. Returns departure/arrival times, delays, line info, and connection details.
Inputs: end (required), start (required), count.
septa_train_viewARead-only
Get all active SEPTA (Philadelphia) regional rail train positions. Returns real-time GPS coordinates, line, destination, current/next stop, and delay minutes for every active train.
Inputs: no named parameters.
smithsonian_detailARead-only
Get full details of a Smithsonian collection record by ID, including images, provenance, dimensions, and extended metadata. Use smithsonian_search first to find record IDs.
Inputs: id (required).
smithsonian_searchARead-only
Search Smithsonian Institution collections (11M+ records across all museums). Filter by keyword, museum, date. Returns matching records with basic metadata.
Covers: National Air and Space Museum, American History, Natural History, American Art, and more.
Inputs: query (required), limit, offset.
ssa_beneficiariesARead-only
Get SSA OASDI and SSI beneficiary data resources. Returns links to downloadable datasets for Social Security beneficiaries by state, county, and ZIP code.
Inputs: no named parameters.
state_businessesARead-only
Query business data for a US state. May include: business counts, registrations, licenses, industry breakdowns.
Inputs: state (required), q, limit, where.
state_crimeARead-only
Query crime statistics for a US state. Data varies by state: may include violent crime, property crime, arrests, by county/jurisdiction. Filter by year, jurisdiction, or use full-text search.
Inputs: state (required), q, year, limit, +2 more.
state_economyBRead-only
Query economic data for a US state. May include: GDP, employment, workforce metrics, tax comparisons, income data. Cross-reference with federal BEA/BLS tools for national context.
Inputs: state (required), q, limit, where.
state_educationARead-only
Query education data for a US state. May include: school enrollment, assessment scores, graduation rates, demographics. Filter by county, year, or search by keyword.
Inputs: state (required), q, year, limit, +2 more.
state_environmentBRead-only
Query environmental data for a US state. May include: air quality violations, water quality assessments, sewer overflows, permits. Cross-reference with federal EPA tools for national context.
Inputs: state (required), q, limit, where, +1 more.
state_gis_boundariesARead-only
Query political boundaries for a US state via ArcGIS. May include: counties, municipalities, congressional districts, state legislative districts. Layer IDs vary by state — use state_gis_services to check available layers.
Inputs: state (required), limit, where, layer_id.
state_gis_parcelsARead-only
Query property parcel boundaries for a US state via ArcGIS. Returns parcel ID, owner name, address, land area, and use codes. Filter by county, owner name, address, or ZIP using SQL where clause.
Inputs: state (required), limit, where.
state_gis_queryARead-only
Query any ArcGIS REST service layer for a US state. Supports attribute and spatial queries with SQL-like where clauses. Use state_gis_services to discover available services and layer IDs. Not all states have GIS services in the registry — use state_list to check.
Inputs: state (required), service (required), limit, where, +3 more.
state_gis_servicesARead-only
Discover available GIS services for a US state. Lists service folders and layers available on the state's ArcGIS REST endpoint. Use the results to find service paths for state_gis_query.
Inputs: state (required), folder.
state_healthARead-only
Query health indicator data for a US state. May include: disease rates, overdose deaths, infant mortality, immunization, hospital data. Data availability varies by state.
Inputs: state (required), q, limit, where.
state_housingARead-only
Query housing data for a US state. May include: building permits, housing units authorized, foreclosure filings. Cross-reference with HUD tools for federal housing data.
Inputs: state (required), q, year, limit, +2 more.
state_listARead-only
List all US states in the registry with their data coverage. Shows which states have Socrata portals, how many dataset categories are mapped, and whether GIS services are available. Use this to see what data is available before querying a specific state.
Inputs: state.
state_propertyARead-only
Query property assessment/tax data for a US state. May include: assessed values, owner info, property details, land use codes. Filter by county, city, ZIP, or search by address/owner.
Inputs: state (required), q, zip, city, +3 more.
state_queryARead-only
Query any state's Socrata open data dataset by its 4-character ID. Works for ANY state in the registry, even without category mappings. Find dataset IDs by browsing the state's portal (e.g., data.ny.gov, opendata.maryland.gov). Supports full SoQL: $select, $where, $order, $group, $q (full-text), $limit, $offset.
Inputs: state (required), dataset_id (required), q, group, +5 more.
state_transportationARead-only
Query transportation data for a US state. May include: vehicle registrations, EV adoption, traffic data. For real-time traffic, use state-specific traffic modules (e.g., md_traffic_*).
Inputs: state (required), q, year, limit, +2 more.
swpc_alertsARead-only
Get current space weather alerts and warnings from NOAA SWPC. Includes watches, warnings, and alerts for geomagnetic storms, solar radiation, and radio blackouts.
Inputs: no named parameters.
swpc_aurora_forecastARead-only
Get 24-hour northern hemisphere aurora probability forecast. Returns OVATION model predictions. Higher probability at higher latitudes during geomagnetic activity.
Inputs: no named parameters.
swpc_dst_indexARead-only
Get Dst (disturbance storm time) index. Negative Dst indicates geomagnetic disturbance. Below -50 nT = moderate storm, below -100 nT = intense storm.
Inputs: no named parameters.
swpc_forecastARead-only
Get 3-day space weather forecast text from NOAA SWPC. Includes solar activity, geomagnetic, and radiation environment forecasts.
Inputs: no named parameters.
swpc_goes_particlesARead-only
Get GOES satellite energetic particle flux data. Elevated particle flux indicates solar energetic particle (SEP) events that can affect satellites and polar aviation.
Inputs: no named parameters.
swpc_goes_xrayARead-only
Get GOES satellite X-ray flux data. X-ray flares classified as A, B, C, M, X (increasing intensity). M and X class flares can cause radio blackouts.
Inputs: no named parameters.
swpc_kp_indexARead-only
Get recent planetary Kp index values. Kp ranges 0-9: 0-3 = quiet, 4 = unsettled, 5+ = geomagnetic storm (G1-G5).
Inputs: no named parameters.
swpc_scalesARead-only
Get current NOAA space weather scale levels. Shows R (radio blackout), S (solar radiation), and G (geomagnetic storm) scale levels from 0-5.
Inputs: no named parameters.
swpc_solar_cycleARead-only
Get predicted solar cycle progression. Shows observed and predicted sunspot numbers and F10.7 flux for the current solar cycle (~11-year cycle).
Inputs: no named parameters.
swpc_solar_fluxARead-only
Get F10.7 cm solar radio flux data. F10.7 is a key indicator of solar activity. Values > 100 SFU = elevated activity, > 150 = high activity.
Inputs: no named parameters.
swpc_solar_windARead-only
Get 7-day solar wind data. Plasma data includes density, speed, temperature. Magnetic field data includes Bz, Bt components. Southward Bz (negative) drives geomagnetic storms.
Inputs: type.
swpc_sunspotsARead-only
Get monthly sunspot numbers. Tracks the ~11-year solar cycle. Higher sunspot counts correlate with more solar activity and space weather events.
Inputs: no named parameters.
traffic_511_listARead-only
List all states with 511 traffic data and their platform type.
Inputs: no named parameters.
traffic_511_queryARead-only
Query real-time traffic data for a state. 15 states supported. Actions: incidents: Active traffic incidents (accidents, closures, construction); cameras: Traffic camera locations and image URLs; signs: Dynamic message sign content; weather: Road weather station (RWIS) data — temperature, precipitation, visibility; conditions: Road conditions — construction, speed data, traffic flow.
Inputs: state (required), action (required).
transit_arrivalsARead-only
Get real-time arrivals/predictions for any of 12 US transit systems. Systems: bart, mbta, septa, cta, la-metro, trimet, onebusaway, wsdot-ferries, marta, path-train, wmata, md-transit. Station/stop IDs are system-specific (BART: EMBR, WMATA: A01, CTA: 40380, etc.).
Inputs: system (required), station.
transit_statusARead-only
Get service alerts and incidents for a transit system. Supported: bart, mbta, septa, wmata. Others return arrivals data instead.
Inputs: system (required).
transit_systemsARead-only
List all 12 available US transit systems with their regions and capabilities.
Inputs: no named parameters.
travel_advisoriesARead-only
Get U.S. State Department travel advisories for all countries or a specific country. Advisory levels: 1 = Exercise Normal Precautions, 2 = Exercise Increased Caution, 3 = Reconsider Travel, 4 = Do Not Travel. Includes advisory text, date published, and country information.
Inputs: level, country_code.
trimet_arrivalsARead-only
Get real-time arrival predictions for TriMet (Portland, OR) buses and MAX light rail at a specific stop. Returns estimated and scheduled arrival times, route info, and vehicle status.
Inputs: stop_id (required).
urban_ed_collegesARead-only
Query college/university enrollment data (FTE) from IPEDS. Covers all Title IV postsecondary institutions.
Inputs: year (required), limit, offset, stateFips.
urban_ed_districtsARead-only
Query district-level enrollment data from the CCD. Covers all public school districts in the US.
Inputs: year (required), limit, offset, stateFips.
urban_ed_schoolsARead-only
Query school-level enrollment data from the CCD (Common Core of Data). Covers all public schools in the US.
Inputs: year (required), grade, limit, offset, +1 more.
usa_agency_overviewBRead-only
Get an overview of a federal agency's spending, including budgetary resources and obligations.
Common codes: '097' (DOD), '075' (HHS), '069' (Treasury), '089' (DOE), '012' (USDA), '015' (Justice), '036' (VA), '070' (DHS), '080' (NASA)
Inputs: agency_code (required), fiscal_year.
usace_levelsARead-only
Get water level data for USACE locations. Returns level IDs, dates, constant values, and units. Use a level-id-mask pattern to filter (supports wildcards).
Inputs: office, level_id_mask.
usace_locationsARead-only
Search CWMS monitoring locations by name, office, or type. Corps district offices: SWL (Little Rock), LRL (Louisville), MVS (St. Louis), NWK (Kansas City), MVP (St. Paul). Returns location name, coordinates, type, state, and county.
Inputs: names, office, location_type.
usace_timeseriesARead-only
Get USACE time-series data: water level, flow, storage, precipitation. Time-series names follow the format 'Location.Parameter.Type.Interval.Duration.Version'. Use usace_locations first to find location names.
Inputs: name (required), end, begin, office.
usajobs_detailARead-only
Get full details of a federal job listing by its control number. Returns duties, qualifications, salary, location, application instructions, and deadlines.
Inputs: controlNumber (required).
usajobs_searchARead-only
Search federal job listings on USAJobs.gov by keyword, location, agency, and salary range. Returns position titles, agencies, locations, salary ranges, and application deadlines.
Inputs: limit, agency, keyword, location, +2 more.
usa_spending_by_agencyARead-only
Get total federal spending broken down by awarding agency. Shows which agencies are spending the most.
Inputs: limit, state, keyword, award_type, +1 more.
usa_spending_by_awardARead-only
Search federal spending awards (contracts, grants, loans, direct payments). Filter by keyword, agency, recipient, date range, award type, and amount.
Award type groups: 'contracts', 'grants', 'loans', 'direct_payments'. Or use codes: 'A,B,C,D' (contracts), '02,03,04,05' (grants), '07,08' (loans), '06,10' (direct payments)
Inputs: page, limit, state, agency, +8 more.
usa_spending_by_recipientARead-only
Get the top recipients (companies, organizations) of federal spending. Use state and agency filters to narrow results.
Inputs: limit, state, agency, award_type, +1 more.
usa_spending_by_stateARead-only
Get federal spending by state or territory. Shows total awards and per-capita spending.
Inputs: state, fiscal_year.
usa_spending_over_timeARead-only
Get federal spending aggregated by time period (monthly, quarterly, or fiscal year). Useful for identifying trends.
Inputs: group, state, agency, keyword, +3 more.
uscis_case_statusARead-only
Check the status of a USCIS immigration case by receipt number. Returns the current case status, form type, and latest action taken. Receipt numbers are 13 characters: 3-letter center code + 10 digits (e.g. 'EAC2190000001').
Inputs: receipt_number (required).
usda_ag_queryARead-only
Custom query to USDA NASS QuickStats — any combination of filters. Max 50,000 records. Use usda_ag_count first for large queries.
Inputs: year, freq_desc, sector_desc, source_desc, +4 more.
usda_crop_dataARead-only
Get crop production data — area planted, harvested, production, yield. Commodities: CORN, SOYBEANS, WHEAT, COTTON, RICE, SORGHUM
Inputs: commodity (required), year, state, category.
usda_livestockARead-only
Get livestock data — inventory, slaughter, production. Commodities: CATTLE, HOGS, CHICKENS, MILK, EGGS
Inputs: commodity (required), year, state, category.
usda_pricesARead-only
Get prices received by farmers for agricultural commodities. Works for any commodity: CORN, WHEAT, SOYBEANS, CATTLE, MILK, etc.
Inputs: commodity (required), year, state.
usgs_daily_water_dataARead-only
Get USGS daily value water data (historical daily averages). Unlike real-time instantaneous values, these are aggregated daily means — better for trend analysis. Parameter codes: 00060=discharge (cfs), 00065=gage height (ft), 00010=water temp (°C).
Inputs: sites, end_dt, period, start_dt, +2 more.
usgs_earthquake_countARead-only
Count earthquakes matching criteria without fetching full details. Useful for statistics: 'How many M5+ earthquakes occurred in 2024?'
Inputs: endtime, latitude, longitude, starttime, +3 more.
usgs_earthquakesARead-only
Search for earthquakes by magnitude, location, date range, and more. Returns magnitude, location, depth, time, alert level, tsunami risk, and felt reports. Magnitude scale: 2.5+ felt by people, 4.0+ moderate, 5.0+ significant, 7.0+ major.
Inputs: limit, endtime, orderby, latitude, +6 more.
usgs_significantARead-only
Get significant earthquakes from the past 30 days (typically M4.5+ or felt/damaging events). Quick way to see the latest notable seismic activity worldwide.
Inputs: no named parameters.
usgs_water_dataBRead-only
Get real-time water data (streamflow, gage height, temperature) from USGS monitoring sites. 13,000+ stations nationwide. Parameter codes: 00060=discharge (cfs), 00065=gage height (ft), 00010=water temp (°C). Query by site ID, state, county, or hydrologic unit code (HUC).
Inputs: sites, end_dt, period, start_dt, +2 more.
usgs_water_sitesBRead-only
Search for USGS water monitoring sites by state, county, or hydrologic unit. Site types: ST=stream, GW=groundwater, LK=lake, SP=spring.
Inputs: state_cd, county_cd, site_type.
usitc_trade_dataARead-only
Query U.S. import/export trade statistics from the USITC DataWeb. Search by HTS (Harmonized Tariff Schedule) code, partner country, year, and trade type. Returns trade values, quantities, and product descriptions.
Inputs: year, hts_code, trade_type, country_code.
uspto_application_assignmentsARead-only
Get assignment (ownership transfer) records for a patent application. Shows conveyance type, assignor, assignee, and dates.
Inputs: application_number (required).
uspto_application_continuityARead-only
Get continuity (parent/child application chain) data for a patent application. Shows parent applications (continuations, divisionals, CIPs) and child applications.
Inputs: application_number (required).
uspto_application_detailsARead-only
Get full patent application data by application number. Returns all metadata including filing date, grant date, status, inventors, applicant, patent number, type, and prosecution details.
Inputs: application_number (required).
uspto_application_documentsARead-only
List documents filed in a patent application (office actions, amendments, drawings, etc.). Filter by document code or date range.
Inputs: application_number (required), date_to, date_from, document_codes.
uspto_application_transactionsARead-only
Get transaction (prosecution history) events for a patent application. Shows office actions, responses, examiner actions, and status changes with dates.
Inputs: application_number (required).
uspto_petition_decisionsARead-only
Search USPTO petition decisions - petitions for extension of time, revival, suspension, etc. Search by applicant name, decision type, technology center, date range.
Inputs: q, sort, limit, fields, +3 more.
uspto_ptab_decisionsARead-only
Search PTAB trial decisions. Find institution decisions, final written decisions, and other PTAB rulings. Search by trial type, outcome, patent owner, grant date range.
Inputs: q, sort, limit, fields, +3 more.
uspto_ptab_proceeding_detailsARead-only
Get details for a specific PTAB trial proceeding by trial number (e.g. 'IPR2025-01319').
Inputs: trial_number (required).
uspto_ptab_proceedingsARead-only
Search PTAB (Patent Trial and Appeal Board) trial proceedings - IPR, PGR, CBM, and derivation proceedings. Search by trial number, patent owner, petitioner, technology center, status, or date range.
Inputs: q, sort, limit, fields, +3 more.
uspto_search_applicationsARead-only
Search USPTO patent applications using ODP query syntax (POST). The q param supports opensearch DSL: boolean (AND/OR/NOT), wildcards (* ?), exact phrases (""), field:value, ranges ([from TO to]), comparisons (>=600). Filters narrow results by field value. Range filters narrow by date/number range. All params are optional -- an empty search returns recent applications.
Inputs: q, sort, limit, facets, +4 more.
va_facilitiesARead-only
Search VA facilities (hospitals, clinics, cemeteries, benefits offices, vet centers) by state and type. Returns facility names, addresses, phone numbers, and services.
Facility types: 'health' (hospitals/clinics), 'benefits' (regional offices), 'cemetery' (national cemeteries), 'vet_center' (readjustment counseling).
Example: state='CA', type='health', limit=10
Inputs: page, type, limit, state.
wb_compareARead-only
Compare a World Bank indicator across multiple countries. Great for 'How does US compare to...' questions.
Inputs: countries (required), indicator (required), date_range.
wb_countriesARead-only
List World Bank countries with region, income level, and capital city.
Inputs: no named parameters.
wb_indicatorARead-only
Get a World Bank indicator for a country. Popular: NY.GDP.MKTP.CD (GDP), SP.DYN.LE00.IN (life expectancy), SH.XPD.CHEX.PC.CD (health spend/capita), SL.UEM.TOTL.ZS (unemployment)
Inputs: indicator (required), country, date_range.
wb_searchARead-only
Search World Bank indicators by keyword. Examples: 'GDP', 'health expenditure', 'life expectancy', 'CO2 emissions'
Inputs: query (required).
wmata_bus_predictionsARead-only
Get next bus arrival predictions at a WMATA bus stop. Requires a 7-digit stop ID.
Inputs: stop_id (required).
wmata_incidentsARead-only
Get current WMATA service incidents — rail delays, bus disruptions, and elevator/escalator outages.
Inputs: type.
wmata_train_positionsARead-only
Get real-time positions of all WMATA Metro trains on the system.
Inputs: no named parameters.
wmata_train_predictionsARead-only
Get next train arrival predictions at a WMATA Metro station. Station codes: A01=Metro Center, B01=Gallery Place, C05=Rosslyn, D02=Smithsonian, etc. Use 'All' or omit for all stations.
Inputs: station.
wqp_resultsARead-only
Get water quality sample results by station ID and/or parameter name. Common parameters: 'Temperature, water', 'pH', 'Dissolved oxygen', 'Nitrogen', 'Phosphorus'.
Inputs: limit, siteId, endDate, startDate, +2 more.
wqp_stationsARead-only
Search water quality monitoring stations by state, county, or HUC code. Data from USGS, EPA, and 400+ state agencies.
Inputs: huc, limit, siteType, stateCode, +1 more.
wsdot_ferry_scheduleARead-only
Get Washington State Ferries sailing schedules for a specific date. Returns route descriptions, crossing times, and individual sailing times.
Inputs: date (required).
wsdot_ferry_terminalsARead-only
Get current terminal wait times and vehicle space availability at Washington State Ferry terminals. Shows how full each sailing is and estimated wait times for drive-up customers.
Inputs: no named parameters.
wsdot_ferry_vesselsARead-only
Get real-time positions of all Washington State Ferry vessels. Returns vessel names, GPS coordinates, speed, heading, dock status, and departure/arrival terminals.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 563 tools
Generic tools like `transit_arrivals`, `cdc_query`, `census_query`, `epa_air_quality`, and `fda_count` overlap with system-specific or endpoint-specific tools (`bart_departures`, `cdc_mortality_rates`, `epa_aqs_daily`, `fda_drug_counts`), making boundaries unclear. Congress `*_full_profile` bundle tools also duplicate their constituent detail tools. With 563 tools, an agent has no clear rule for choosing among several near-equivalent options.
Most tools use a `<source>_<action>` pattern (e.g., `nws_forecast`, `fda_drug_events`, `congress_bill_details`), which makes the set readable overall. However, verb/noun ordering is inconsistent (`cfpb_search_complaints` vs `cfpb_complaint_detail`), and several tools break the prefix pattern (`list_datasets`, `get_endpoint_fields`, `clear_cache`, `code_mode`). The mixed conventions are still navigable but far from uniform.
With 563 tools, this server is an extreme mismatch for a single MCP server; it aggregates dozens of independent government APIs with no apparent scoping. Even if each tool is individually useful, the combined surface is unmanageable for coherent agent selection and tool-choice reasoning.
The server covers most major U.S. government data areas — Congress, FDA, EPA, labor, energy, climate, transit, courts, and spending — and includes generic query tools that help fill gaps. Missing pieces such as full court docket/filing search or detailed tax records are minor relative to the enormous scope covered.
Maintenance
Related MCP Connectors
Hosted MCP servers for US federal data: 19 servers, 147 tools, one endpoint.
This MCP server provides seamless access to Malaysia's government open data, including datasets, w…
Hosted MCP server for finding authoritative primary data sources and official portals.
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides access to government datasets from Data.gov, enabling users to search packages, view dataset details, list groups and tags, and access resources by URL.476 npm20MIT
- AlicenseAqualityDmaintenanceAn MCP server that connects AI agents to over 200 tools across 27 Brazilian public APIs, covering economic, legislative, transparency, and judicial data. It enables users to query and cross-reference extensive government datasets from sources like IBGE, the Central Bank, and the Brazilian Congress.2271,861MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides tools to search, query, and aggregate data from any Socrata open data portal.-
- AlicenseAqualityFmaintenanceCited Australian stats via the ausdata.io gateway — stable AU.* series IDs, source_url + retrieved_at on every response. Free tier. Not a data broker; upgrade for Embed / signed / webhooks.2832 npm2MIT