US Government Open Data MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MODULES | No | Selective loading — comma-separated list of modules to load (e.g., 'fred,treasury,congress'). Omit to load all. | |
| MCP_HOST | No | Host binding for HTTP Stream transport (default: 127.0.0.1). Set to 0.0.0.0 for Docker/remote access. | |
| MCP_PORT | No | Port for HTTP Stream transport (default: 8080). | |
| AQS_EMAIL | No | EPA AQS — email address registered with AQS API (required alongside AQS_API_KEY). | |
| AQS_API_KEY | No | EPA Air Quality System — ambient air monitoring data. Get key: https://aqs.epa.gov/data/api/signup | |
| BEA_API_KEY | No | Bureau of Economic Analysis — state GDP, GDP by industry, personal income. Get key: https://apps.bea.gov/API/signup/ | |
| BLS_API_KEY | No | Bureau of Labor Statistics — employment, wages, CPI. Optional (works without at lower limits). Get key: https://www.bls.gov/developers/home.htm | |
| DOL_API_KEY | No | Department of Labor — OSHA inspections, WHD enforcement, UI claims. Get key: https://data.dol.gov/registration | |
| EIA_API_KEY | No | Energy Information Administration — petroleum, electricity, natural gas prices. Get key: https://www.eia.gov/opendata/register.php | |
| FRED_API_KEY | No | FRED (Federal Reserve Economic Data) — 800K+ time series. Get key: https://fredaccount.stlouisfed.org/apikeys | |
| NOAA_API_KEY | No | NOAA Climate Data — weather observations, temperature, precipitation. Get key: https://www.ncei.noaa.gov/cdo-web/token | |
| MCP_TRANSPORT | No | Transport type: 'stdio' (default) or 'httpStream'. | |
| USPTO_API_KEY | No | USPTO Open Data Portal — patent applications, PTAB trials. Get key: https://data.uspto.gov/apis/getting-started | |
| CENSUS_API_KEY | No | Census Bureau — population, demographics, income, housing. Get key: https://api.census.gov/data/key_signup.html | |
| HUD_USER_TOKEN | No | HUD — Fair Market Rents, Income Limits. Get token: https://www.huduser.gov/hudapi/public/register | |
| DATA_GOV_API_KEY | No | Shared Data.gov key — works for Congress, FEC, FBI, GovInfo, College Scorecard, NREL, Regulations.gov, USDA FoodData, and FDA. Get one free at https://api.data.gov/signup/ | |
| SEC_CONTACT_EMAIL | No | SEC EDGAR — contact email for User-Agent header (required by SEC fair access policy). Any valid email. | |
| USDA_NASS_API_KEY | No | USDA NASS — crop production, livestock, farm prices. Get key: https://quickstats.nass.usda.gov/api |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
| prompts | {} |
| resources | {} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bea_gdp_nationalA | 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:
|
| bea_gdp_by_stateA | Get gross domestic product for U.S. states from BEA Regional dataset. Table options:
GeoFips: 'STATE' for all states, or 5-digit FIPS (e.g. '06000' for CA) |
| bea_personal_incomeA | Get personal income data by state from BEA Regional dataset. Table options:
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 |
| bea_gdp_by_industryA | Get GDP contribution by industry sector nationally from BEA GDPbyIndustry dataset. TableID options:
Industry='ALL' returns all sectors. |
| bea_dataset_infoA | Discover BEA datasets, parameters, and valid parameter values. Essential for exploring the BEA API before making data requests. Actions:
Datasets: NIPA, NIUnderlyingDetail, FixedAssets, MNE, GDPbyIndustry, Regional, ITA, IIP, InputOutput, UnderlyingGDPbyIndustry, IntlServTrade |
| bea_nipa_underlying_detailA | 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. |
| bea_fixed_assetsA | 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. |
| bea_international_transactionsA | 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:
Frequency: A=annual, QSA=quarterly seasonally adjusted, QNSA=not adjusted |
| bea_international_investmentA | Get U.S. international investment position (IIP) data. Shows end-of-period accumulated stocks of U.S. financial assets and liabilities. TypeOfInvestment examples:
Component: 'Pos' (position), 'ChgPosTrans' (change from transactions), 'ChgPosPrice' (from price changes), 'ChgPosXRate' (from exchange rates) |
| bea_intl_services_tradeA | 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' |
| bea_multinational_enterprisesA | Get data on Direct Investment (DI) and Activities of Multinational Enterprises (AMNE). DirectionOfInvestment (required):
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). |
| bea_input_outputA | 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. |
| bea_underlying_gdp_by_industryA | 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. |
| bls_series_dataA | Fetch time series data from the Bureau of Labor Statistics. Returns monthly/quarterly/annual observations for employment, wages, prices, and more. Popular series IDs:
Series ID prefixes: CES (jobs by industry), LNS (unemployment), CU (CPI), WP (PPI), OE (wages), JT (JOLTS) |
| bls_search_seriesA | 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 |
| bls_cpi_breakdownA | Get a breakdown of Consumer Price Index by component — food, shelter, energy, medical care, transportation, etc. Shows which categories are driving inflation. |
| bls_employment_by_industryA | Get employment numbers broken down by major industry sector. Shows which sectors are growing or shrinking. |
| bts_transport_statsB | 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. |
| bts_border_crossingsA | 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. |
| cdc_causes_of_deathB | 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. |
| cdc_life_expectancyA | 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. |
| cdc_mortality_ratesA | 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. |
| cdc_places_healthA | 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. |
| cdc_places_cityA | 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). |
| cdc_weekly_deathsA | 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. |
| cdc_disabilityB | 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' |
| cdc_drug_overdoseA | Get drug poisoning/overdose mortality by state (1999–2016).\nIncludes death rates by state, sex, race, and age group. Critical for opioid crisis analysis. |
| cdc_nutrition_obesityA | 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. |
| cdc_death_rates_historicalA | 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. |
| cdc_birth_indicatorsA | 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' |
| cdc_covidA | Get COVID-19 weekly case and death counts by state (data through early 2023). States use two-letter abbreviations: 'NY', 'CA', 'TX'. |
| cdc_queryB | 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) |
| census_queryA | 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) |
| census_populationA | Get population data for U.S. states using the American Community Survey. Quick shortcut — for more flexibility use census_query directly. |
| census_search_variablesA | 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. |
| cfpb_search_complaintsA | 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'. |
| cfpb_complaint_aggregationsA | 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'. |
| cfpb_complaint_trendsA | 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. |
| cfpb_complaint_detailA | Get full details for a specific complaint by its Complaint ID. Returns all fields: product, issue, company, narrative (if consented), response, dates, etc. |
| cfpb_state_complaintsA | 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.). |
| cfpb_suggest_companyA | Autocomplete/suggest company names from the CFPB complaint database. Useful for finding the exact company name before searching complaints. |
| clinical_trials_searchA | 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'. |
| clinical_trials_detailA | 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). |
| clinical_trials_resultsA | 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. |
| clinical_trials_statsA | 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. |
| clinical_trials_by_locationA | 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. |
| clinical_trials_field_valuesA | 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. |
| clinical_trials_enumsA | 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. |
| clinical_trials_metadataA | Explore the ClinicalTrials.gov study data model — field names, types, and descriptions.
Use to discover available fields for the |
| clinical_trials_field_sizesB | 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. |
| clinical_trials_size_statsB | 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. |
| cms_searchA | Search for CMS provider data datasets by keyword. Returns dataset IDs, titles, and descriptions. Use the ID with cms_query to fetch data. |
| cms_hospitalsA | Query CMS hospital data: general info, quality ratings, mortality, readmissions, infections, patient surveys, Medicare spending. Filter by state or city. |
| cms_nursing_homesA | Query CMS nursing home data: provider info with five-star ratings, quality measures, health deficiencies/citations. Filter by state. |
| cms_queryA | 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. |
| scorecard_searchA | 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. |
| scorecard_compareA | Compare specific colleges side-by-side on cost, graduation rate, earnings, and debt. Provide school names to search and compare. |
| scorecard_topA | 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) |
| scorecard_queryA | Advanced College Scorecard query with custom field filters and ranges. Filter examples:
|
| congress_search_billsA | 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 |
| congress_bill_detailsA | Get detailed information about a specific bill including sponsors, cosponsors with party breakdown, actions, committees, and current status. |
| congress_search_membersA | 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). |
| congress_house_votesA | 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. |
| congress_senate_votesA | 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. |
| congress_recent_lawsA | Get recently enacted laws (bills signed by the President). Optionally filter by law type (public or private). Shows what legislation has become law. |
| congress_member_billsA | Get bills sponsored or cosponsored by a specific member of Congress. Requires the member's BioGuide ID (use congress_search_members to find it). |
| congress_bill_actionsA | 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. |
| congress_bill_amendmentsA | 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'). |
| congress_bill_summariesA | 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). |
| congress_bill_textA | 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. |
| congress_bill_relatedA | Find related/companion bills. Identifies House-Senate companion bills, identical bills, and bills with related provisions. Useful for tracking legislation across chambers. |
| congress_bill_subjectsA | 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. |
| congress_bill_committeesA | Get committees a bill was referred to, with activity dates. Shows which committees had jurisdiction and what actions they took (referral, hearings, markup, reporting). |
| congress_bill_titlesA | 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'). |
| congress_bill_cosponsorsA | 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. |
| congress_member_detailsA | 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. |
| congress_committeesA | List congressional committees. Filter by congress number and/or chamber (house, senate, joint). Returns committee name, system code, and chamber. |
| congress_committee_billsA | 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. |
| congress_committee_detailsB | 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. |
| congress_amendmentsA | Search/list amendments by congress and optional type (hamdt = House, samdt = Senate, suamdt = Senate Unnumbered). Returns amendment number, type, sponsor, purpose, and status. |
| congress_amendment_detailsA | Get detailed information about a specific amendment, including its actions/timeline. Requires congress number, amendment type (hamdt/samdt), and amendment number. |
| congress_nominationsB | List presidential nominations to federal offices (judges, cabinet, ambassadors, agency heads). Shows nominee name, position, organization, and confirmation status. |
| congress_nomination_detailsA | Get detailed information about a specific presidential nomination, including all actions (committee referral, hearing, vote, confirmation/rejection). |
| congress_treatiesB | List treaties submitted to the Senate. Shows treaty topic, date transmitted, and ratification status. |
| congress_treaty_detailsA | Get detailed information about a specific treaty, including all Senate actions (committee referral, hearings, ratification vote). |
| congress_crs_reportsB | Get Congressional Research Service reports — authoritative, nonpartisan analysis on legislative topics. CRS reports are considered the gold standard for policy research. |
| congress_crs_report_detailsA | Get detailed information about a specific CRS report by report number/ID. Returns full summary, authors, topics, related legislation, and format links (PDF, etc.). |
| congress_summaries_searchA | 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. |
| congress_infoA | 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. |
| congress_congressional_recordB | Get Congressional Record issues — the official daily record of debate, speeches, and proceedings in Congress. Filter by year, month, and day. |
| congress_law_detailsA | 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. |
| congress_committee_reportsA | 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. |
| congress_committee_report_detailsA | Get detailed information about a specific committee report, including associated bills, title, issue date, and text versions. |
| congress_committee_printsA | List committee prints — publications ordered by committees that are not committee reports. Often include Rules Committee prints with bill text for floor consideration. |
| congress_committee_print_detailsA | Get details about a specific committee print by congress, chamber, and jacket number. |
| congress_committee_meetingsB | List committee meetings (hearings, markups, etc.) with dates, locations, and topics. Filter by congress and chamber. |
| congress_committee_meeting_detailsA | Get detailed information about a specific committee meeting including title, committees, witnesses, meeting documents, related bills, and video links. |
| congress_hearingsA | List congressional hearings. Filter by congress and chamber. Hearings are formal proceedings where committees gather testimony from witnesses. |
| congress_hearing_detailsB | Get detailed information about a specific hearing including title, date, committees, associated meeting, citation, and available text formats. |
| congress_daily_congressional_recordA | 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. |
| congress_bound_congressional_recordA | Get bound Congressional Record issues — the permanent, final publication of proceedings. Filter by year, month, and day. |
| congress_house_communicationsA | 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). |
| congress_house_communication_detailsB | Get detailed information about a specific House communication including abstract, committees, submitting agency, and legal authority. |
| congress_house_requirementsB | List House requirements — recurring reporting obligations from executive agencies to Congress. Shows requirement number, frequency, and matching communications count. |
| congress_house_requirement_detailsB | Get detailed information about a specific House requirement including legal authority, frequency, nature, and matching communications count. |
| congress_senate_communicationsA | 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). |
| congress_senate_communication_detailsB | Get detailed information about a specific Senate communication including abstract, committees, and congressional record date. |
| congress_nomination_committeesA | Get committees associated with a nomination. Shows committee activities (referral, hearing, discharge). |
| congress_nomination_hearingsA | Get printed hearings associated with a nomination. Shows hearing dates, citations, and chambers. |
| congress_treaty_committeesB | Get committees associated with a treaty. Typically the Senate Foreign Relations Committee. |
| congress_amendment_textB | Get text versions for a specific amendment (from 117th Congress onwards). Returns version types and format URLs (PDF, HTML). |
| congress_amendment_cosponsorsB | Get cosponsors of a specific amendment. Shows party affiliation and sponsorship details. |
| congress_amendment_amendmentsA | Get sub-amendments to a specific amendment. Shows amendments that modify the parent amendment. |
| congress_committee_details_by_congressA | 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. |
| congress_committee_reports_for_committeeA | Get reports published by a specific committee. Shows formal committee reports accompanying legislation — use congress_committees to find the committee system code. |
| congress_committee_nominations_for_committeeA | Get nominations referred to a specific committee. Useful for tracking judicial or agency head nominations before a particular Senate committee. |
| congress_committee_house_communicationsA | Get House communications referred to a specific House committee. |
| congress_committee_senate_communicationsA | Get Senate communications referred to a specific Senate committee. |
| congress_committee_report_textA | Get text versions for a committee report. Returns formatted text and PDF URLs. |
| congress_committee_print_textB | Get text versions for a committee print. Returns formatted text and PDF URLs. |
| congress_nomination_nomineesA | 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. |
| congress_house_requirement_matching_communicationsA | Get communications that match a specific House requirement. Shows agency submissions fulfilling a recurring reporting obligation. |
| congress_treaty_partitioned_detailsA | 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. |
| congress_treaty_partitioned_actionsA | Get actions on a partitioned treaty (one with a suffix letter). Shows committee referral, hearings, and ratification votes for a specific treaty partition. |
| congress_bill_full_profileA | 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). |
| congress_member_full_profileA | 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. |
| congress_nomination_full_profileA | 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. |
| congress_treaty_full_profileA | 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. |
| congress_committee_full_profileA | 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. |
| congress_bill_votesA | 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. |
| doj_press_releasesA | 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. |
| doj_press_release_detailA | Get the full text of a specific DOJ press release by UUID. Returns the complete body, component, topic, date, and URL. |
| doj_blog_entriesA | 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. |
| doj_blog_detailA | Get the full text of a specific DOJ blog entry by UUID. Returns the complete body, component, topic, date, and URL. |
| dol_osha_inspectionsA | 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. |
| dol_osha_violationsA | 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. |
| dol_osha_accidentsA | 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. |
| dol_osha_accident_injuriesA | 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. |
| dol_whd_enforcementA | 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. |
| dol_ui_claims_nationalA | 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. |
| dol_ui_claims_stateA | Get state-level weekly Unemployment Insurance (UI) claims. Compare initial claims, continued claims, and insured unemployment rate across states. |
| eia_petroleumA | Get petroleum/oil prices — crude oil spot prices (WTI, Brent), retail gasoline prices, diesel, heating oil. Product codes:
|
| eia_electricityA | 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' |
| eia_natural_gasA | 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) |
| eia_state_energyA | 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):
|
| eia_total_energyA | Get the monthly/annual U.S. energy overview — total production, consumption, imports, exports, and prices across all energy sources. MSN codes:
|
| epa_facilitiesB | 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). |
| epa_facility_detailA | 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. |
| epa_uv_indexA | 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. |
| epa_toxic_releasesA | 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. |
| epa_greenhouse_gasA | 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. |
| epa_drinking_waterA | 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. |
| epa_enforcementA | 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. |
| epa_superfundA | 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. |
| epa_rcraA | 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. |
| epa_air_qualityA | 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 |
| epa_aqs_dailyA | 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. |
| epa_aqs_monitorsA | 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. |
| fbi_agenciesA | 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. |
| fbi_crime_summarizedA | 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. |
| fbi_arrest_dataA | 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. |
| fbi_expanded_homicideA | 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. |
| fbi_hate_crimeA | 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). |
| fbi_law_enforcement_employeesA | Get law enforcement employee data (sworn officers, civilian employees) at national, state, or agency level. Shows staffing levels over time. |
| fbi_lesdcC | 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. |
| fbi_use_of_forceA | 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. |
| fbi_nibrsA | 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. |
| fbi_expanded_propertyA | 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). |
| fda_drug_eventsA | Search FDA adverse drug event reports (FAERS) — side effects, hospitalizations, deaths. Over 20 million reports. Search by drug name, reaction, seriousness. Example searches:
|
| fda_drug_countsA | Aggregate/count FDA drug adverse event data by any field. For counting other endpoints, use fda_count instead. Common count fields:
|
| fda_drug_labelsA | Search FDA drug product labeling (package inserts / prescribing information — SPL). Contains indications, warnings, boxed warnings, adverse reactions, drug interactions, dosage. Example searches:
Count fields: openfda.product_type.exact, openfda.brand_name.exact, openfda.route.exact |
| fda_drug_ndcA | 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:
Count fields: pharm_class.exact, dea_schedule, dosage_form.exact, route.exact |
| fda_drug_recallsA | Search FDA drug recall enforcement reports. Find recalled drugs by classification (Class I=most serious), company, or reason. Example searches:
|
| fda_approved_drugsA | 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:
|
| fda_drug_shortagesA | Search FDA drug shortage listings — which drugs are in shortage and why. Tracks status, dosage form, therapeutic category, company, and shortage reason. Example searches:
Count fields: update_type, status.exact, therapeutic_category.exact |
| fda_device_eventsA | Search FDA medical device adverse event reports (MAUDE) — injuries, malfunctions, deaths. Example searches:
|
| fda_device_510kA | 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:
Count fields: country_code, advisory_committee, clearance_type.exact, decision_code |
| fda_device_classificationA | 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:
Count fields: device_class, medical_specialty.exact |
| fda_device_enforcementA | 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:
Count fields: voluntary_mandated.exact, classification.exact, status.exact |
| fda_device_recallsA | Search FDA medical device recall reports (RES system). Find recalled devices by name, manufacturer, or reason for recall. Example searches:
|
| fda_device_pmaA | Search Premarket Approval (PMA) decisions for Class III medical devices. PMA is required for high-risk devices — evaluates safety and effectiveness. Example searches:
Count fields: advisory_committee, decision_code |
| fda_device_registrationsA | Search medical device establishment registrations & listings (336K+ records). Where devices are manufactured and which devices are made at each establishment. Example searches:
Count fields: products.openfda.device_class |
| fda_device_udiA | 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:
Count fields: product_codes.openfda.device_class, is_rx, mri_safety.exact |
| fda_covid_serologyA | Search COVID-19 serology test evaluation results. FDA's evaluation of antibody test performance (sensitivity/specificity). Example searches:
Count fields: type (sample material), manufacturer.exact |
| fda_food_recallsA | Search FDA food recall enforcement reports. Class I (may cause death), Class II (temporary health problems), Class III (unlikely harm). Example searches:
|
| fda_food_adverse_eventsA | Search FDA food adverse event reports (CAERS database). Reports of illnesses, allergic reactions, and injuries from foods and dietary supplements. Example searches:
Count fields: reactions.exact, outcomes.exact, products.industry_name.exact |
| fda_animal_eventsA | 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:
Count fields: animal.species.exact, primary_reporter.exact, serious_ae |
| fda_tobacco_problemsA | 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:
Count fields: tobacco_products.exact, reported_health_problems.exact |
| fda_historical_docsA | Search historical FDA documents — press releases from 1913 to 2014 (OCR full-text search). Example searches:
|
| fda_nsdeA | 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:
|
| fda_substanceA | Search FDA substance data — molecular-level ingredient information. Search by name, CAS code, UNII, or molecular formula. Example searches:
|
| fda_uniiA | Search UNII (Unique Ingredient Identifiers) — links ingredient names to unique chemical IDs. Example searches:
|
| fda_countA | 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:
|
| fdic_search_institutionsA | 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. |
| fdic_failuresB | 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. |
| fdic_financialsA | 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. |
| fdic_summaryA | Get aggregate banking statistics — industry totals by state or charter type. Useful for overview metrics: total banks, deposits, assets by state/year. |
| fdic_depositsA | 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. |
| fdic_historyA | Get institution event history — mergers, acquisitions, name changes, charter conversions. Filter by CERT number to trace a specific bank's history. |
| fec_search_candidatesA | Search for federal election candidates by name, state, party, office, or election year. Data from the Federal Election Commission (FEC). |
| fec_search_committeesA | 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. |
| fec_candidate_financialsA | Get financial summary for a candidate — total raised, spent, cash on hand, debt. Requires a candidate_id (use fec_search_candidates to find one). |
| fec_committee_financialsA | Get financial totals for a committee (PAC, campaign, party). Requires a committee_id (use fec_search_committees to find one). |
| fec_top_candidatesA | Get top candidates ranked by total money raised for a given office and election cycle. |
| fec_committee_disbursementsA | 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. |
| fec_individual_contributionsA | Get itemized individual contributions (Schedule A) — who donated to a committee, their employer and occupation, amount, and date. This is the KEY tool for donor research: 'who funds this candidate and where do they work?' The full dataset is ~123M records, so ALWAYS pass a filter — typically committee_id (the recipient committee) and/or contributor_name/employer. WORKFLOW: (1) fec_search_committees or fec_search_candidates to find the committee_id, (2) this tool filtered by committee_id, optionally narrowing by contributor_employer (e.g. 'Goldman Sachs') or contributor_state. |
| fec_independent_expendituresA | Get itemized independent expenditures (Schedule E) — outside spending by Super PACs and other groups FOR or AGAINST a candidate (ad buys, mailers, etc.). This is the KEY tool for tracking outside money: 'how much did Super PACs spend against Senator X?' Filter by candidate_id (most common), committee_id (the spender), and/or support_oppose ('S'=support, 'O'=oppose). WORKFLOW: (1) fec_search_candidates to find candidate_id, (2) this tool filtered by candidate_id. Use fec_outside_spending_by_candidate for totals instead of line items. |
| fec_outside_spending_by_candidateA | Get TOTAL independent (outside) spending supporting vs. opposing a candidate (Schedule E totals). Use this for an exact summary — 'how much outside money supported vs. opposed this candidate?' — instead of paginating raw line items. For the itemized breakdown of who spent it, use fec_independent_expenditures. |
| fr_executive_ordersA | Search for presidential executive orders. Filter by president, year, or keyword. Covers all executive orders since 1994. |
| fr_presidential_documentsA | Search all presidential documents: executive orders, memoranda, proclamations, and other presidential actions. |
| fr_search_rulesA | Search for proposed rules, final rules, and agency notices in the Federal Register. Use to track regulatory activity by agencies. |
| fr_document_detailA | Get full details for a specific Federal Register document by document number. Returns title, abstract, full text URL, agencies, CFR references, and more. |
| fr_agenciesA | List all federal agencies that publish in the Federal Register. Returns agency names, short names, slugs (for filtering), and URLs. 470+ agencies. |
| fr_public_inspectionA | List documents currently on public inspection — approved for publication but NOT yet officially published (appearing in the Federal Register tomorrow, or imminently for 'special' filings). This is the forward-looking view: 'what regulations are about to come out?' Special filings are expedited/emergency documents. |
| fr_suggested_searchesA | List the Office of the Federal Register's curated topic bundles (e.g. 'Dodd-Frank', 'Endangered Species'). Each topic shows how many documents appeared in the last year and how many currently have OPEN public comment periods — useful for discovering active regulatory topics and where the public can still weigh in. Sections: money, environment, world, science-and-technology, business-and-industry, health-and-public-welfare. |
| fema_disaster_declarationsA | Search FEMA disaster declarations (since 1953). Filter by state, year, incident type, or declaration type. Returns disaster name, type, affected area, programs declared. |
| fema_housing_assistanceB | Get FEMA Individual Housing Program (IHP) assistance data for homeowners. Shows approved assistance amounts, inspections, and damage by county/zip for a disaster. |
| fema_public_assistanceA | 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. |
| fema_regionsA | Get FEMA region boundaries and associated states. 10 FEMA regions cover all U.S. states and territories. |
| fema_queryA | 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. |
| fred_searchA | Search FRED series by keyword. Examples: 'GDP', 'unemployment', 'CPI', 'mortgage rate' |
| fred_series_infoA | Get metadata for a FRED series — title, units, frequency, range, notes. |
| fred_series_dataB | Get observations for a FRED series. Popular: GDP, UNRATE, CPIAUCSL, FEDFUNDS, DGS10, MORTGAGE30US |
| fred_release_dataA | Bulk fetch a FRED release. Common: 53 (GDP), 50 (Employment), 10 (CPI), 18 (Rates) |
| govinfo_searchB | 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) |
| govinfo_bill_textA | 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) |
| govinfo_cbo_reportsB | Search for Congressional Budget Office reports published through GovInfo. CBO scores tax bills with distributional analysis showing impact by income group. |
| calc_search_ratesA | 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. |
| calc_suggestA | 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). |
| calc_contract_ratesB | 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. |
| hud_fair_market_rentsA | 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. |
| hud_income_limitsA | 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. |
| hud_list_statesA | List all U.S. states with their HUD state codes. Use these codes with other HUD tools. |
| hud_list_countiesA | List counties in a state with their FIPS codes. Use FIPS codes as entity_id in hud_fair_market_rents and hud_income_limits. |
| hud_list_metro_areasA | List metropolitan/CBSA areas. CBSA codes can be used as entity_id in HUD tools. |
| naep_scoresA | 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') |
| naep_achievement_levelsA | 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. |
| naep_compare_yearsA | 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. |
| naep_compare_statesA | 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. |
| naep_compare_groupsA | 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). |
| naep_gap_year_jurisdictionA | 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. |
| naep_gap_variable_yearsA | 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. |
| naep_gap_variable_jurisdictionA | 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. |
| naep_available_variablesA | 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. |
| nhtsa_recallsA | 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 |
| nhtsa_recall_detailA | 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. |
| nhtsa_complaintsA | 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 |
| nhtsa_complaint_detailA | Get a specific complaint by its ODI number. ODI numbers are in complaint search results (e.g. 11184030). |
| nhtsa_model_yearsA | 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. |
| nhtsa_makesA | 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' |
| nhtsa_modelsA | 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' |
| nhtsa_decode_vinA | Decode a Vehicle Identification Number (VIN) to get specifications. Returns make, model, year, engine, body class, drive type, plant info. VINs are 17 characters. |
| nhtsa_safety_ratingsA | 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. |
| nhtsa_safety_rating_detailA | 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. |
| nhtsa_car_seat_stationsA | 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 |
| nih_search_projectsA | 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. |
| nih_search_publicationsA | 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. |
| nih_spending_by_categoryA | 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. |
| nih_projects_by_agencyA | 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. |
| noaa_datasetsA | List available NOAA climate datasets (GHCND daily, GSOM monthly, GSOY annual, normals, etc.) |
| noaa_stationsB | Search for NOAA weather stations by location or dataset. Use location IDs like FIPS:36 (New York), FIPS:06 (California), CITY:US360019 (NYC). |
| noaa_climate_dataA | Get climate observations (temperature, precipitation, snow, wind) from NOAA. Requires dataset ID + date range. Optionally filter by station or location. |
| noaa_locationsA | Search NOAA location IDs (states, cities, countries) for use with other NOAA tools. |
| nrel_fuel_stationsA | 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) |
| nrel_utility_ratesB | Get residential, commercial, and industrial electricity rates for any U.S. location. Provide latitude/longitude to get the local utility and their rates ($/kWh). |
| nrel_solarA | Get solar energy resource data for any U.S. location — monthly and annual solar irradiance. Shows potential for solar panels at a given location. |
| nws_point_infoA | Resolve a lat/lon to its NWS forecast gridpoint, office, time zone, forecast zone, county zone, and nearest radar station. Useful for debugging or when you need the zone ID for nws_zone_forecast. Most callers can skip this and use nws_forecast directly. |
| nws_forecastA | Get the 7-day NWS forecast for a lat/lon. Returns ~14 periods (Today / Tonight / Tomorrow / Tomorrow Night / …) with temperature, wind, precipitation probability, and a detailed text forecast. Forecasts use US units (°F, mph). |
| nws_forecast_hourlyA | Get the hourly forecast (next ~156 hours / ~6.5 days) for a lat/lon. Each period is one hour with temperature, wind, precip probability, and short forecast. Large response — consider nws_forecast for daily summaries. |
| nws_zone_forecastA | Get the public text-based forecast for an NWS forecast zone (e.g. 'CAZ006'). Find the zone ID via nws_point_info. |
| nws_alerts_activeA | Get currently-active NWS weather alerts (tornado warnings, flood watches, winter storm advisories, etc.) filtered by area (state), zone, or point. Pass at most one of area/zone/point. Severity and urgency filters are optional.
Without a geographic filter this returns ALL active U.S. alerts (often hundreds) — capped to |
| nws_alertA | Get a single NWS alert by its URN (e.g. 'urn:oid:2.49.0.1.840…'). Use the |
| nws_alert_typesA | List all valid NWS alert event types (e.g. 'Tornado Warning', 'Flood Watch'). Reference data — cached aggressively. |
| nws_stations_nearA | List NWS observation stations near a lat/lon. Use the resulting stationIdentifier with nws_observation_latest. |
| nws_observation_latestA | Get the latest observation from an NWS observation station (e.g. 'KDCA' for Reagan National Airport). Returns SI units: temperature/dewpoint in °C, wind speed in km/h, pressure in Pa, visibility in m. |
| nws_glossaryA | Get the full NWS weather glossary (term → definition). Useful for explaining technical terms in forecasts. |
| open_payments_searchB | 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. |
| open_payments_topA | 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. |
| open_payments_top_doctorsA | 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. |
| open_payments_by_companyA | Get payment summary data grouped by pharmaceutical/device company (all years combined). Shows total amounts and number of payments per company. |
| open_payments_summaryA | Get national-level Open Payment totals and averages across all years. Shows how much money flows from pharma to doctors nationally. |
| open_payments_researchA | 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. |
| open_payments_ownershipB | 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. |
| open_payments_by_physicianA | Get payments grouped by individual physician across all years. Pre-aggregated totals — shows how much each doctor received from pharma overall. |
| open_payments_by_hospitalA | Get payments grouped by teaching hospital. Shows total pharma payments to teaching hospitals — useful for identifying institutional conflicts of interest. |
| open_payments_by_specialtyA | Get national payment totals and averages by medical specialty. Shows which specialties receive the most pharma money — cardiologists, orthopedic surgeons, psychiatrists, etc. |
| regulations_search_documentsA | 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). |
| regulations_document_detailB | Get detailed information for a specific regulatory document by its document ID (e.g. 'FDA-2009-N-0501-0012'). |
| regulations_search_commentsA | 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). |
| regulations_comment_detailA | Get detailed information for a specific public comment by its comment ID. |
| regulations_search_docketsB | 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'. |
| regulations_docket_detailA | Get detailed information for a specific regulatory docket by its docket ID (e.g. 'EPA-HQ-OAR-2003-0129'). |
| sec_company_searchA | Look up a company on SEC EDGAR by CIK number. Returns company name, tickers, SIC code, state, and recent filings list. Common CIK numbers:
To find CIK: search by company name using sec_filing_search. |
| sec_company_financialsA | 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 |
| sec_filing_searchA | 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) |
| sec_company_conceptA | Get the full reported history of a single XBRL financial concept for one company. Faster and smaller than sec_company_financials when you only need one metric's time series (e.g. quarterly revenue for 10 years). Common concepts: Revenues, NetIncomeLoss, Assets, Liabilities, StockholdersEquity, EarningsPerShareBasic, CashAndCashEquivalentsAtCarryingValue. |
| sec_concept_across_companiesA | Compare a single XBRL financial concept across ALL reporting companies for one period (SEC frames API). The most powerful cross-company tool: rank every filer by revenue, net income, assets, etc. in one call. PERIOD FORMAT:
UNITS: 'USD' (default), 'shares', 'USD-per-shares' (for EarningsPerShareBasic). |
| lobbying_searchA | Search lobbying disclosure filings — find out who is lobbying Congress, on what issues, and how much they're spending. Search by:
Returns expenses/income amounts, issues lobbied, and registrant/client info. |
| lobbying_detailA | 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. |
| lobbying_contributionsA | Search campaign contributions made by lobbyists — shows which lobbyists donated to which politicians. Required under the LDA to disclose political contributions by registered lobbyists. |
| lobbying_registrantsB | Search lobbying firms and organizations registered to lobby Congress. |
| lobbying_lobbyistsB | Search individual lobbyists by name or firm. Find specific people who lobby Congress and which firms they work for. |
| list_datasetsA | 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. |
| search_datasetsA | 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. |
| get_endpoint_fieldsA | 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. |
| query_fiscal_dataA | 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' |
| usa_spending_by_awardA | 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) |
| usa_spending_by_agencyB | Get total federal spending broken down by awarding agency. Shows which agencies are spending the most. |
| usa_spending_by_stateA | Get federal spending by state or territory. Shows total awards and per-capita spending. |
| usa_spending_by_recipientA | Get the top recipients (companies, organizations) of federal spending. Use state and agency filters to narrow results. |
| usa_spending_over_timeA | Get federal spending aggregated by time period (monthly, quarterly, or fiscal year). Useful for identifying trends. |
| usa_agency_overviewA | 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) |
| fooddata_searchA | 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). |
| fooddata_detailA | 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. |
| fooddata_listA | Browse a paged list of foods from the USDA database. Useful for exploring available foods by data type without a specific search term. |
| usda_crop_dataA | Get crop production data — area planted, harvested, production, yield. Commodities: CORN, SOYBEANS, WHEAT, COTTON, RICE, SORGHUM |
| usda_livestockB | Get livestock data — inventory, slaughter, production. Commodities: CATTLE, HOGS, CHICKENS, MILK, EGGS |
| usda_pricesB | Get prices received by farmers for agricultural commodities. Works for any commodity: CORN, WHEAT, SOYBEANS, CATTLE, MILK, etc. |
| usda_ag_queryA | Custom query to USDA NASS QuickStats — any combination of filters. Max 50,000 records. Use usda_ag_count first for large queries. |
| usgs_earthquakesA | 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. |
| usgs_significantA | 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. |
| usgs_earthquake_countA | Count earthquakes matching criteria without fetching full details. Useful for statistics: 'How many M5+ earthquakes occurred in 2024?' |
| usgs_water_dataA | 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). |
| usgs_water_sitesC | Search for USGS water monitoring sites by state, county, or hydrologic unit. Site types: ST=stream, GW=groundwater, LK=lake, SP=spring. |
| usgs_daily_water_dataA | 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). |
| usgs_water_statisticsA | Get period-of-record streamflow statistics for a USGS site — for each day of the year, the min/mean/max and p05–p95 percentiles across ALL years on record. Answers 'is the current flow historically high or low for this date?' — far more analytically useful than raw readings for drought/flood context. Parameter codes: 00060=discharge (cfs, default), 00065=gage height (ft). Optionally filter to a specific month/day. |
| uspto_search_applicationsA | 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. |
| uspto_application_detailsA | 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. |
| uspto_application_continuityA | Get continuity (parent/child application chain) data for a patent application. Shows parent applications (continuations, divisionals, CIPs) and child applications. |
| uspto_application_assignmentsA | Get assignment (ownership transfer) records for a patent application. Shows conveyance type, assignor, assignee, and dates. |
| uspto_application_transactionsA | Get transaction (prosecution history) events for a patent application. Shows office actions, responses, examiner actions, and status changes with dates. |
| uspto_application_documentsA | List documents filed in a patent application (office actions, amendments, drawings, etc.). Filter by document code or date range. |
| uspto_ptab_proceedingsA | 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. |
| uspto_ptab_proceeding_detailsA | Get details for a specific PTAB trial proceeding by trial number (e.g. 'IPR2025-01319'). |
| uspto_ptab_decisionsA | Search PTAB trial decisions. Find institution decisions, final written decisions, and other PTAB rulings. Search by trial type, outcome, patent owner, grant date range. |
| uspto_petition_decisionsB | Search USPTO petition decisions - petitions for extension of time, revival, suspension, etc. Search by applicant name, decision type, technology center, date range. |
| wb_indicatorA | 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) |
| wb_compareA | Compare a World Bank indicator across multiple countries. Great for 'How does US compare to...' questions. |
| wb_searchA | Search World Bank indicators by keyword across the full ~29,000-indicator catalog. Examples: 'GDP', 'health expenditure', 'life expectancy', 'CO2 emissions'. |
| wb_countriesA | List World Bank countries with region, income level, and capital city. |
| wb_topicsA | Browse World Bank indicators by theme. With no topic_id, lists all 21 topics (Agriculture, Health, Climate Change, Education, etc.). With a topic_id, lists every indicator under that topic — the best way to discover indicators for a subject without keyword guessing. |
| wb_sourcesA | Browse World Bank data source databases. With no source_id, lists all ~70 sources (World Development Indicators, Doing Business, International Debt Statistics, etc.). With a source_id, lists every indicator in that database. |
| wb_referenceA | Get World Bank classification lookup tables: regions, income levels, or lending types. Use the resulting codes to filter wb_countries-style queries (e.g. income level 'LIC' = low income). |
| clear_cacheA | Clear cached API responses to force fresh data on next query. Specify a source name or omit to clear all. |
| code_modeA | 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 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))' |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| jobs_report | Get a comprehensive labor market overview — employment by industry, unemployment demographics, wages, and job openings. |
| health_overview | Comprehensive U.S. health snapshot: leading causes of death, life expectancy, and international comparison. |
| state_profile | Complete demographic and economic profile of a U.S. state. |
| college_roi | Analyze the return on investment of college — compare costs, debt, and earnings across school types. |
| legislation_tracker | Track the status and details of a specific bill or recent legislation on a topic, with full cross-source analysis. |
| energy_snapshot | Current U.S. energy prices, production trends, and state comparisons. |
| crime_overview | National and state crime trends overview. |
| campaign_finance_summary | Overview of fundraising in the current election cycle with connections to voting records and lobbying. |
| recession_check | Analyze whether the U.S. is in or approaching a recession using key economic indicators with legislative context. |
| recent_legislation_text | Get the full text of recently enacted legislation with vote breakdown and impact analysis. |
| climate_trends | Temperature and precipitation trends for a U.S. location over time. |
| company_snapshot | Quick financial overview of a public company from SEC filings. |
| debt_analysis | Analyze the national debt trend with legislative context and vote breakdowns. |
| exchange_rates | Look up Treasury exchange rates for a specific currency. |
| auction_results | Get recent Treasury securities auction results. |
| interest_rate_comparison | Compare current interest rates across all Treasury security types. |
| federal_spending_overview | Comprehensive overview of federal spending with connections to authorizing legislation and votes. |
| farm_economy | Overview of U.S. agricultural production, prices, and trends. |
| international_comparison | Compare the U.S. to peer nations on key economic and social indicators. |
| compare_presidents | Compare the economic performance of two or more presidents using identical metrics. |
| fiscal_snapshot | Current state of U.S. government finances: debt, deficit, revenue, spending, interest costs. |
| cost_of_living | Analyze the current cost of living: inflation breakdown, housing, gas, food, medical, and wages. |
| follow_the_money | Trace the lobbying and campaign finance pipeline for a specific bill or industry. |
| industry_influence | Map an industry's full influence: lobbying spend, PAC money to both parties, and policy outcomes. |
| politician_profile | Build a complete financial and legislative profile of a politician. |
| state_deep_dive | Comprehensive profile of a U.S. state using 10+ data sources. |
| compare_states | Side-by-side comparison of two states across economic, health, education, and quality-of-life metrics. |
| health_dashboard | National or state health dashboard: leading causes of death, life expectancy, obesity, drug overdose, healthcare spending. |
| workplace_safety | Investigate workplace safety for a company, industry, or state using OSHA data. |
| education_report_card | Education quality assessment: NAEP scores, achievement gaps, college outcomes, and spending. |
| company_accountability | Investigate a company's consumer complaints, safety record, lobbying activity, and financial health. |
| bank_health_check | Assess the health of a bank or the banking system: FDIC data, complaints, failures, interest rate risk. |
| energy_landscape | Current U.S. energy picture: prices, production, renewables, emissions, and policy. |
| disaster_analysis | Analyze a specific disaster or a state/region's disaster history: declarations, aid, weather data, and federal response. |
| vehicle_investigation | Investigate a vehicle make/model for safety recalls, consumer complaints, crash ratings, and manufacturer lobbying. |
| drug_safety | Investigate a drug's safety record: adverse events, labels, FDA data, and manufacturer profile. |
| food_recall_tracker | Track food safety: recent recalls, contamination patterns, and the companies involved. |
| innovation_landscape | Map the innovation landscape for a technology area: patents, R&D spending, key companies, and federal funding. |
| housing_affordability | Analyze housing affordability: rents, home prices, mortgage rates, income, and policy. |
| crime_analysis | Analyze crime trends: national or state-level crime rates, arrest data, and contextual factors. |
| regulation_tracker | Track a federal regulation from proposal to final rule: public comments, lobbying, and impact. |
| college_comparison | Compare specific colleges on cost, outcomes, debt, and ROI — or find the best schools for a criteria. |
| where_the_money_goes | Trace federal spending: by agency, state, recipient, or keyword. Find who gets taxpayer dollars. |
| nutrition_lookup | Compare foods nutritionally, check for food safety issues, and see what Americans actually eat. |
| us_vs_world | Compare the U.S. to other nations on any metric: economy, health, education, environment, military. |
| agriculture_report | Analyze crop production, farm prices, agricultural trade, and rural economics. |
| hospital_check | Check hospital or nursing home quality: ratings, mortality, infections, patient experience. |
| earthquake_risk | Assess earthquake risk and recent seismic activity for a location or region. |
| drug_pipeline | Analyze the clinical trial pipeline for a disease or drug company. |
| transportation_report | Analyze transportation trends: airline delays, border crossings, transit ridership, infrastructure spending. |
| housing_market | Comprehensive housing market analysis: prices, rents, affordability, mortgage rates. |
| environmental_justice | Investigate environmental hazards and their proximity to communities — pollution, enforcement, health impacts. |
| government_contractor | Investigate a government contractor — contracts, lobbying, campaign contributions, safety record, and financials. |
| water_quality | Investigate water quality and safety for a location — drinking water, monitoring data, contamination sources. |
| pharma_pricing | Investigate why a drug costs what it does — manufacturer profits, lobbying, doctor payments, shortages, and alternatives. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| API Reference |
TDQS
Scored across 345 tools
The tool set spans dozens of agencies and domains, and while many tools are domain-specific, there are numerous overlapping tools within domains (e.g., congress_bill_details vs congress_bill_full_profile, epa_air_quality vs epa_aqs_daily, fda_device_enforcement vs fda_device_recalls, nhtsa_recalls vs nhtsa_recall_detail, multiple 'search' vs 'query' tools). The sheer scale and redundant 'full profile' convenience tools create significant ambiguity about which tool to select.
Most tools follow a consistent agency_prefix + noun + verb pattern (e.g., congress_search_bills, fda_drug_events, nws_forecast), but there are notable deviations: 'code_mode' and 'clear_cache' break the pattern, some tools use inconsistent verb placement (e.g., 'search_datasets' vs 'list_datasets' vs 'get_endpoint_fields'), and the 'full_profile' tools mix conventions. Overall readable but not uniform.
345 tools is an extreme count for a single MCP server. Even though it aggregates many government data sources, the server would be far more usable split into per-agency servers. The count is far beyond what an agent can effectively navigate, and many tools are redundant convenience wrappers.
The server covers an impressively broad range of government data domains, and many domains have reasonable search/detail coverage. However, completeness is uneven: some domains have deep coverage (Congress, FDA, EPA) while others are thin (e.g., only a few CDC tools, no update/delete operations since this is read-only data). The 'query' tools partially fill gaps, but the overall surface is more broad than systematically complete.