US Data.gov MCP Servers

US government public data portal (data.gov) API Model Context Protocol (MCP) servers.

What is MCP?

Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

MCP servers are lightweight programs that expose specific functionality through the Model Context Protocol. AI tools like Claude Desktop, Cline, Cursor, and Windsurf can communicate with these servers as MCP clients.

Why US Public Data MCP Servers?

The US government's data.gov portal provides access to thousands of datasets from various federal agencies through APIs. This project wraps these APIs as MCP servers, enabling AI tools to easily access and utilize US public data.

Key Benefits:

Standardized Access: Use various public APIs through a unified MCP interface
AI Tool Integration: Direct access to public data from Claude, Cline, and other AI assistants
Easy Installation: Install via pip or uv
Type Safety: Strong type validation using Pydantic
Developer Friendly: Template-based rapid server creation

Available MCP Servers

Phase 1 - Core Servers

us-data-mcp.census-data

US Census Bureau demographic and economic data

us-data-mcp.sec-edgar

SEC EDGAR company filings and financial information

us-data-mcp.fda-drugs

FDA drug approvals, recalls, and safety information

us-data-mcp.bls-labor

Bureau of Labor Statistics employment and economic data

us-data-mcp.epa-airquality

EPA air quality and environmental monitoring

Phase 2 - Extended Servers (Coming Soon)

us-data-mcp.usa-spending

Federal spending, contracts, and grants

Installation & Setup

Using UV (Recommended)

# Census data server
uv pip install us-data-mcp.census-data

# SEC EDGAR server
uv pip install us-data-mcp.sec-edgar

# FDA drugs server
uv pip install us-data-mcp.fda-drugs

# BLS labor statistics server
uv pip install us-data-mcp.bls-labor

# EPA air quality server
uv pip install us-data-mcp.epa-airquality

Using pip

# Census data server
pip install us-data-mcp.census-data

# SEC EDGAR server
pip install us-data-mcp.sec-edgar

# FDA drugs server
pip install us-data-mcp.fda-drugs

# BLS labor statistics server
pip install us-data-mcp.bls-labor

# EPA air quality server
pip install us-data-mcp.epa-airquality

Claude Desktop Configuration

Add MCP servers to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "uvx",
      "args": ["us-data-mcp.census-data@latest"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.sec-edgar": {
      "command": "uvx",
      "args": ["us-data-mcp.sec-edgar@latest"]
    },
    "us-data-mcp.fda-drugs": {
      "command": "uvx",
      "args": ["us-data-mcp.fda-drugs@latest"]
    },
    "us-data-mcp.bls-labor": {
      "command": "uvx",
      "args": ["us-data-mcp.bls-labor@latest"],
      "env": {
        "BLS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.epa-airquality": {
      "command": "uvx",
      "args": ["us-data-mcp.epa-airquality@latest"],
      "env": {
        "EPA_AQS_EMAIL": "your-email@example.com",
        "EPA_AQS_KEY": "your-api-key-here"
      }
    }
  }
}

Note: Using @latest ensures you always run the latest version.

Cline Configuration

Configure MCP servers in VS Code's Cline extension:

.vscode/cline_mcp_settings.json:

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "python",
      "args": ["-m", "us_data_mcp.census_data.server"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage for Each Server

Census Bureau Data (us-data-mcp.census-data)

Access US Census Bureau demographic and economic data.

Environment Variables

export CENSUS_API_KEY="your-api-key-here"  # Get from https://api.census.gov/data/key_signup.html

Available Tools

search_population: Search population data by geography

Parameters:

year: Year of data (e.g., 2020)
state: State FIPS code (2 digits)
county: County FIPS code (3 digits, optional)
variables: List of census variables to retrieve

search_economic: Search economic indicators

Parameters:

year: Year of data
dataset: Dataset name (e.g., "acs/acs5")
variables: List of economic variables
geography: Geographic level (state, county, etc.)

Usage Examples

"Get population data for California in 2020"
"Find median household income for New York County"
"Show employment statistics for Texas"

SEC EDGAR (us-data-mcp.sec-edgar)

Access SEC company filings and financial information.

Environment Variables

No API key required - uses public SEC EDGAR API.

Available Tools

search_company: Search for companies by name, ticker, or CIK

Parameters:

query: Company name, ticker symbol, or CIK

get_company_facts: Get company financial facts (XBRL data)

Parameters:

cik: Central Index Key

get_insider_trades: Get recent insider trading reports (Form 4)

Parameters:

cik: Central Index Key
limit: Number of trades to retrieve (default: 20)

get_form_types: Get reference list of SEC form types

Usage Examples

"Find recent 10-K filings for Apple"
"Search for company with ticker MSFT"
"Get financial facts for CIK 0000320193"
"Show recent insider trades for Tesla"

FDA Drug Information (us-data-mcp.fda-drugs)

Access FDA drug approvals, recalls, and safety information.

Environment Variables

No API key required - uses public openFDA API.

Available Tools

search_drugs: Search drug database

Parameters:

brand_name: Brand name of drug (optional)
generic_name: Generic name (optional)
application_number: FDA application number (optional)
limit: Max results (default: 10)

search_recalls: Search drug recalls

Parameters:

product_description: Product description
classification: Recall classification (I, II, III)
status: Recall status (ongoing, completed)
limit: Max results (default: 10)

search_adverse_events: Search adverse event reports

Parameters:

drug_name: Drug name
reaction: Specific reaction/side effect (optional)
limit: Max results (default: 10)

search_devices: Search for medical devices

Parameters:

device_name: Device name
limit: Max results (default: 10)

search_all_recalls: Search all FDA recalls (food, drug, device)

Parameters:

category: Category (food, drug, device)
product_description: Product name or keywords
limit: Max results (default: 10)

Usage Examples

"Find FDA approval info for Lipitor"
"Search for recent food recalls"
"Get information on heart valve devices"
"Get adverse event reports for aspirin"

BLS Labor Statistics (us-data-mcp.bls-labor)

Access Bureau of Labor Statistics employment and economic data.

Environment Variables

export BLS_API_KEY="your-api-key-here"  # Get from https://www.bls.gov/developers/api_signature_v2.htm

Available Tools

get_series_data: Fetch data for BLS series IDs

Parameters:

series_ids: List of series IDs (e.g., ["LNS14000000"])
start_year: Start year
end_year: End year

get_common_series: Get reference list of common series IDs

Usage Examples

"Get national unemployment rate from 2020 to 2023"
"Find CPI data for inflation analysis"
"Show total nonfarm employment statistics"

EPA Air Quality (us-data-mcp.epa-airquality)

Access EPA Air Quality System (AQS) environmental data.

Environment Variables

export EPA_AQS_EMAIL="your-email@example.com"
export EPA_AQS_KEY="your-api-key-here"  # Get from https://aqs.epa.gov/data/api/signup

Available Tools

get_daily_air_quality: Fetch daily air quality summaries

Parameters:

param_code: Pollutant parameter code (e.g., "44201" for Ozone)
bdate: Begin date (YYYYMMDD)
edate: End date (YYYYMMDD)
state: 2-digit State FIPS code
county: 3-digit County FIPS code (optional)

get_common_aqs_parameters: Get reference list of pollutant codes

Usage Examples

"Get Ozone levels in California for July 2023"
"Find PM2.5 levels in Los Angeles County"
"Show common air pollutant codes for EPA data"

Developer Guide

Development Environment Setup

# Clone repository
git clone https://github.com/sechan9999/us-data-mcp-servers.git
cd us-data-mcp-servers

# Install UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync --dev

🚀 Quickly Create a New MCP Server

Using Automation Script (Recommended)

The fastest way is to use the provided template generation script:

# Run interactive script
uv run python scripts/create_mcp_server.py

The script will guide you through the process step-by-step and generate a new MCP server in minutes.

Manual Template Usage

# Install Cookiecutter (if needed)
uv pip install cookiecutter

# Create new server from template
uv run cookiecutter template/ -o src/

For detailed template usage, see TEMPLATE_USAGE.md.

For the complete developer guide, see CONTRIBUTING.md.

Running Tests

# Run all tests
uv run pytest

# Run tests for specific server
uv run pytest src/census-data/tests/

API Keys

Service	API Key Required	Documentation/Sign Up Link
Census Bureau	Recommended	Census API Key
SEC EDGAR	No	SEC EDGAR API
FDA openFDA	No	openFDA API
BLS	Yes	BLS API Key
EPA AQS	Yes	EPA AQS Sign Up

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Acknowledgments

Inspired by the Korean data.go.kr MCP servers project.

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
examples		examples
src		src
.env.example		.env.example
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
CONTRIBUTING.md		CONTRIBUTING.md
IMPLEMENTATION_PLAN.md		IMPLEMENTATION_PLAN.md
LICENSE		LICENSE
PHASE1_COMPLETE.md		PHASE1_COMPLETE.md
PROJECT_COMPLETE.md		PROJECT_COMPLETE.md
PROJECT_STATUS.md		PROJECT_STATUS.md
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
QUICKSTART.md		QUICKSTART.md
README.md		README.md
pyproject.toml		pyproject.toml

License

sechan9999/McpServers

Folders and files

Latest commit

History

Repository files navigation

US Data.gov MCP Servers

Table of Contents

What is MCP?

Why US Public Data MCP Servers?

Key Benefits:

Available MCP Servers

Phase 1 - Core Servers

Phase 2 - Extended Servers (Coming Soon)

Installation & Setup

Using UV (Recommended)

Using pip

Claude Desktop Configuration

Cline Configuration

Usage for Each Server

Census Bureau Data (us-data-mcp.census-data)

Environment Variables

Available Tools

Usage Examples

SEC EDGAR (us-data-mcp.sec-edgar)

Environment Variables

Available Tools

Usage Examples

FDA Drug Information (us-data-mcp.fda-drugs)

Environment Variables

Available Tools

Usage Examples

BLS Labor Statistics (us-data-mcp.bls-labor)

Environment Variables

Available Tools

Usage Examples

EPA Air Quality (us-data-mcp.epa-airquality)

Environment Variables

Available Tools

Usage Examples

Developer Guide

Development Environment Setup

🚀 Quickly Create a New MCP Server

Using Automation Script (Recommended)

Manual Template Usage

Running Tests

API Keys

Contributing

License

Acknowledgments

Resources

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages