Skip to content
MCP server

U.S. Government Open Data

Open data from 40+ U.S. government APIs covering economy, Congress, health and energy

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
2026.10.8
Listing updated
1 day ago

About U.S. Government Open Data

U.S. Government Open Data is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

This server wraps dozens of federal data sources behind one install, from Federal Reserve and Census economic series to Congress, FEC, SEC, energy, health, disaster and air quality datasets. It is also published as a TypeScript SDK.

Many modules need their own free API key, such as FRED, Census, BEA, EIA or a shared api.data.gov key, and unconfigured modules can be hidden. You can load only chosen modules or domains, and a discovery mode exposes just find_tools and call_tool so a client does not load every tool at once.

Responses are capped at 150,000 bytes by default with rows trimmed beyond that. Several agencies ask for a contact email in the user agent, which can be set.

Install

Run in a terminal

claude mcp add us-gov-open-data-mcp --env DATA_GOV_API_KEY='<DATA_GOV_API_KEY>' --env FRED_API_KEY='<FRED_API_KEY>' --env CENSUS_API_KEY='<CENSUS_API_KEY>' --env BLS_API_KEY='<BLS_API_KEY>' --env BEA_API_KEY='<BEA_API_KEY>' --env EIA_API_KEY='<EIA_API_KEY>' --env NOAA_API_KEY='<NOAA_API_KEY>' --env USDA_NASS_API_KEY='<USDA_NASS_API_KEY>' --env HUD_USER_TOKEN='<HUD_USER_TOKEN>' --env DOL_API_KEY='<DOL_API_KEY>' --env USPTO_API_KEY='<USPTO_API_KEY>' --env LDA_API_KEY='<LDA_API_KEY>' --env AQS_API_KEY='<AQS_API_KEY>' -- npx -y us-gov-open-data-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "us-gov-open-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "us-gov-open-data-mcp"
      ],
      "env": {
        "DATA_GOV_API_KEY": "<DATA_GOV_API_KEY>",
        "FRED_API_KEY": "<FRED_API_KEY>",
        "CENSUS_API_KEY": "<CENSUS_API_KEY>",
        "BLS_API_KEY": "<BLS_API_KEY>",
        "BEA_API_KEY": "<BEA_API_KEY>",
        "EIA_API_KEY": "<EIA_API_KEY>",
        "NOAA_API_KEY": "<NOAA_API_KEY>",
        "USDA_NASS_API_KEY": "<USDA_NASS_API_KEY>",
        "HUD_USER_TOKEN": "<HUD_USER_TOKEN>",
        "DOL_API_KEY": "<DOL_API_KEY>",
        "USPTO_API_KEY": "<USPTO_API_KEY>",
        "LDA_API_KEY": "<LDA_API_KEY>",
        "AQS_API_KEY": "<AQS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "us-gov-open-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "us-gov-open-data-mcp"
      ],
      "env": {
        "DATA_GOV_API_KEY": "<DATA_GOV_API_KEY>",
        "FRED_API_KEY": "<FRED_API_KEY>",
        "CENSUS_API_KEY": "<CENSUS_API_KEY>",
        "BLS_API_KEY": "<BLS_API_KEY>",
        "BEA_API_KEY": "<BEA_API_KEY>",
        "EIA_API_KEY": "<EIA_API_KEY>",
        "NOAA_API_KEY": "<NOAA_API_KEY>",
        "USDA_NASS_API_KEY": "<USDA_NASS_API_KEY>",
        "HUD_USER_TOKEN": "<HUD_USER_TOKEN>",
        "DOL_API_KEY": "<DOL_API_KEY>",
        "USPTO_API_KEY": "<USPTO_API_KEY>",
        "LDA_API_KEY": "<LDA_API_KEY>",
        "AQS_API_KEY": "<AQS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "us-gov-open-data-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "us-gov-open-data-mcp"
      ],
      "env": {
        "DATA_GOV_API_KEY": "<DATA_GOV_API_KEY>",
        "FRED_API_KEY": "<FRED_API_KEY>",
        "CENSUS_API_KEY": "<CENSUS_API_KEY>",
        "BLS_API_KEY": "<BLS_API_KEY>",
        "BEA_API_KEY": "<BEA_API_KEY>",
        "EIA_API_KEY": "<EIA_API_KEY>",
        "NOAA_API_KEY": "<NOAA_API_KEY>",
        "USDA_NASS_API_KEY": "<USDA_NASS_API_KEY>",
        "HUD_USER_TOKEN": "<HUD_USER_TOKEN>",
        "DOL_API_KEY": "<DOL_API_KEY>",
        "USPTO_API_KEY": "<USPTO_API_KEY>",
        "LDA_API_KEY": "<LDA_API_KEY>",
        "AQS_API_KEY": "<AQS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "us-gov-open-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "us-gov-open-data-mcp"
      ],
      "env": {
        "DATA_GOV_API_KEY": "<DATA_GOV_API_KEY>",
        "FRED_API_KEY": "<FRED_API_KEY>",
        "CENSUS_API_KEY": "<CENSUS_API_KEY>",
        "BLS_API_KEY": "<BLS_API_KEY>",
        "BEA_API_KEY": "<BEA_API_KEY>",
        "EIA_API_KEY": "<EIA_API_KEY>",
        "NOAA_API_KEY": "<NOAA_API_KEY>",
        "USDA_NASS_API_KEY": "<USDA_NASS_API_KEY>",
        "HUD_USER_TOKEN": "<HUD_USER_TOKEN>",
        "DOL_API_KEY": "<DOL_API_KEY>",
        "USPTO_API_KEY": "<USPTO_API_KEY>",
        "LDA_API_KEY": "<LDA_API_KEY>",
        "AQS_API_KEY": "<AQS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "us-gov-open-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "us-gov-open-data-mcp"
      ],
      "env": {
        "DATA_GOV_API_KEY": "<DATA_GOV_API_KEY>",
        "FRED_API_KEY": "<FRED_API_KEY>",
        "CENSUS_API_KEY": "<CENSUS_API_KEY>",
        "BLS_API_KEY": "<BLS_API_KEY>",
        "BEA_API_KEY": "<BEA_API_KEY>",
        "EIA_API_KEY": "<EIA_API_KEY>",
        "NOAA_API_KEY": "<NOAA_API_KEY>",
        "USDA_NASS_API_KEY": "<USDA_NASS_API_KEY>",
        "HUD_USER_TOKEN": "<HUD_USER_TOKEN>",
        "DOL_API_KEY": "<DOL_API_KEY>",
        "USPTO_API_KEY": "<USPTO_API_KEY>",
        "LDA_API_KEY": "<LDA_API_KEY>",
        "AQS_API_KEY": "<AQS_API_KEY>"
      }
    }
  }
}

Configuration

  • DATA_GOV_API_KEYapi.data.gov key, shared by Congress, FEC, GovInfo, FBI, NREL, Regulations.gov, College Scorecard, USDA FoodData, openFDA and USGS Water
  • FRED_API_KEYFRED (Federal Reserve Economic Data) API key
  • CENSUS_API_KEYCensus Bureau API key
  • BLS_API_KEYBureau of Labor Statistics API key (optional; raises rate limits)
  • BEA_API_KEYBureau of Economic Analysis API key
  • EIA_API_KEYEnergy Information Administration API key
  • NOAA_API_KEYNOAA Climate Data Online token (station climate data works without it)
  • USDA_NASS_API_KEYUSDA NASS Quick Stats API key
  • HUD_USER_TOKENHUD User API token
  • DOL_API_KEYDepartment of Labor API key
  • USPTO_API_KEYUSPTO Open Data Portal API key
  • LDA_API_KEYSenate Lobbying Disclosure (lda.gov) API key (optional; raises rate limits)
  • AQS_API_KEYEPA Air Quality System API key (used with AQS_EMAIL)
  • AQS_EMAILEmail address registered for the EPA AQS API key
  • SEC_CONTACT_EMAILYour email for the SEC User-Agent; SEC asks automated tools for a contact and may block requests without one
  • NWS_USER_AGENTUser-Agent for the National Weather Service API, with your contact details (a default is sent otherwise)
  • MODULESComma-separated modules to load (default: all), e.g. 'fred,bls,treasury'
  • DOMAINSComma-separated domains to load, e.g. 'economy,health' (added to MODULES)
  • HIDE_UNCONFIGUREDSet to 1 to skip modules whose required API key is not set
  • TOOL_MODE'full' (every tool) or 'discovery' (find_tools and call_tool only)
  • MAX_RESPONSE_BYTESLargest tool result in bytes before rows are trimmed (default 150000)

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

find_tools
Discover available tools in discovery mode
call_tool
Call a tool in discovery mode

What it does

Dozens of agencies
Economy, spending, Congress, health, energy, disasters and more.
Module selection
Load only the modules or domains you need.
Discovery mode
Exposes find_tools and call_tool instead of every tool.
Hide unconfigured
Skip modules missing a key.
Response size limit
Trims rows beyond a byte cap.
SDK
Also a TypeScript SDK.

Good for

  • Pull economic series for analysis
  • Research lobbying or campaign finance
  • Check energy and air quality statistics
  • Track disaster and health data

Pricing

Open source

Free; some upstream APIs need free keys.

Prices change. Check lzinga.github.io before you buy.

U.S. Government Open Data FAQ

Are API keys required?

Many modules need free agency keys; some work without.

How do I limit tools?

Use MODULES, DOMAINS or discovery mode.

What is the output cap?

150,000 bytes by default.

Is U.S. Government Open Data free?

Yes. U.S. Government Open Data is open source, so you can use and self-host it for free.

How do I add U.S. Government Open Data to Claude Code?

Run this command in your terminal: claude mcp add us-gov-open-data-mcp --env DATA_GOV_API_KEY='<DATA_GOV_API_KEY>' --env FRED_API_KEY='<FRED_API_KEY>' --env CENSUS_API_KEY='<CENSUS_API_KEY>' --env BLS_API_KEY='<BLS_API_KEY>' --env BEA_API_KEY='<BEA_API_KEY>' --env EIA_API_KEY='<EIA_API_KEY>' --env NOAA_API_KEY='<NOAA_API_KEY>' --env USDA_NASS_API_KEY='<USDA_NASS_API_KEY>' --env HUD_USER_TOKEN='<HUD_USER_TOKEN>' --env DOL_API_KEY='<DOL_API_KEY>' --env USPTO_API_KEY='<USPTO_API_KEY>' --env LDA_API_KEY='<LDA_API_KEY>' --env AQS_API_KEY='<AQS_API_KEY>' -- npx -y us-gov-open-data-mcp

What are the best alternatives to U.S. Government Open Data?

The closest alternatives to U.S. Government Open Data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to U.S. Government Open Data

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government