Mcpservers

🚀 US Data.gov MCP Servers

This project provides API Model Context Protocol (MCP) servers for the US government's public data portal (data.gov), enabling seamless integration between AI tools and various US public data sources.

🚀 Quick Start

The US government's data.gov portal offers access to thousands of datasets from different federal agencies via APIs. This project encapsulates these APIs as MCP servers, allowing AI tools to easily access and utilize US public data.

✨ Features

• 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.

📦 Installation

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 Examples

Census Bureau Data (us-data-mcp.census-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)

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)

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)

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)

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"

📚 Documentation

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

📄 License

This project is under the MIT License. See LICENSE for details.

👏 Acknowledgments

This project is inspired by the Korean data.go.kr MCP servers project.

📖 Resources

• Model Context Protocol Documentation
• Data.gov Developer Resources
• Census API Documentation
• SEC EDGAR API
• openFDA API
• BLS API Documentation
• EPA AQS API