.env.example

# U.S. Government Open Data MCP Server — Environment Variables
#
# Copy this file to .env and fill in your API keys.
# All keys are free. Tools for APIs without a configured key will show
# a warning at startup but won't prevent other tools from working.

# ─── Shared Data.gov key ──────────────────────────────────────────────
# One free key works for 8 APIs: Congress, FEC, FBI, GovInfo,
# College Scorecard, NREL, Regulations.gov, and USDA FoodData Central.
# Get key: https://api.data.gov/signup/
DATA_GOV_API_KEY=

# ─── Individual API keys ─────────────────────────────────────────────

# FRED — Federal Reserve economic data (800K+ time series)
# Get key: https://fredaccount.stlouisfed.org/apikeys
FRED_API_KEY=

# Census Bureau — Population, demographics, income, housing
# Get key: https://api.census.gov/data/key_signup.html
CENSUS_API_KEY=

# BLS — Employment, wages, CPI components (optional — works without key at lower rate limits)
# Get key: https://www.bls.gov/developers/home.htm
BLS_API_KEY=

# BEA — State GDP, GDP by industry, personal income
# Get key: https://apps.bea.gov/API/signup/
BEA_API_KEY=

# EIA — Petroleum, electricity, natural gas prices; state energy profiles
# Get key: https://www.eia.gov/opendata/register.php
EIA_API_KEY=

# NOAA — Weather observations, temperature, precipitation from U.S. stations
# Get key: https://www.ncei.noaa.gov/cdo-web/token
NOAA_API_KEY=

# USDA NASS — Crop production, livestock, farm prices, Census of Agriculture
# Get key: https://quickstats.nass.usda.gov/api
USDA_NASS_API_KEY=

# HUD — Fair Market Rents, Income Limits for housing programs
# Get token: https://www.huduser.gov/hudapi/public/register
HUD_USER_TOKEN=

# DOL — OSHA inspections/violations/accidents, WHD wage enforcement, UI claims
# Get key: https://data.dol.gov/registration (uses LOGIN.GOV)
DOL_API_KEY=

# SEC EDGAR — Contact email for User-Agent header (required by SEC fair access policy)
# No API key needed, just a valid contact email
# See: https://www.sec.gov/about/developer-resources
SEC_CONTACT_EMAIL=your_email@example.com

# USPTO Open Data Portal — Patent applications, PTAB trials, petition decisions
# Get key: https://data.uspto.gov/apis/getting-started
USPTO_API_KEY=

# EPA Air Quality System (AQS) -- ambient air sample data from thousands of monitors
# Signup: https://aqs.epa.gov/data/api/signup?email=YOUR_EMAIL
# Most EPA tools (ECHO, TRI, GHG, SDWIS, UV) work without a key.
# AQS tools (epa_air_quality, epa_aqs_daily, epa_aqs_monitors) require both:
AQS_API_KEY=
AQS_EMAIL=

# ─── No key needed ───────────────────────────────────────────────────
# These APIs work without any configuration:
#   Treasury Fiscal Data        — fiscaldata.treasury.gov
#   USAspending                 — api.usaspending.gov
#   Federal Register            — federalregister.gov
#   World Bank                  — api.worldbank.org
#   CDC Health Data             — data.cdc.gov
#   FDA (OpenFDA)               — api.fda.gov
#   EPA (ECHO/TRI/GHG/SDWIS/UV) -- data.epa.gov, echodata.epa.gov (AQS tools need key above)
#   NAEP (Nation's Report Card) — nationsreportcard.gov
#   Senate Lobbying             — lda.senate.gov
#   FEMA                        — fema.gov/api/open
#   NHTSA                       — api.nhtsa.gov
#   CMS Provider Data           — data.cms.gov
#   CFPB Consumer Complaints    — consumerfinance.gov
#   FDIC BankFind               — banks.data.fdic.gov