Getting Started

Features

• 300+ tools across 40+ government APIs — economic, health, legislative, financial, environmental, and more
• Cross-referencing — built-in instructions guide the LLM to combine data from multiple agencies
• Code mode — WASM-sandboxed JavaScript execution reduces context usage by 98-100% for large responses
• Selective loading — load only the modules you need: --modules fred,treasury,congress
• Dual transport — stdio for desktop clients, HTTP Stream for web/remote
• TypeScript SDK — every API is importable as a standalone typed client, no MCP required
• Disk-backed caching — responses cached to disk, survives restarts
• Rate limiting + retry — token-bucket rate limiter with exponential backoff

MCP Server

Quick Start

npx us-gov-open-data-mcp

That's it — the server starts on stdio and works with any MCP client.

VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "us-gov-open-data": {
      "command": "npx",
      "args": ["-y", "us-gov-open-data-mcp"],
      "env": {
        "FRED_API_KEY": "your_key_here",
        "DATA_GOV_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "us-gov-open-data": {
      "command": "npx",
      "args": ["-y", "us-gov-open-data-mcp"],
      "env": {
        "FRED_API_KEY": "your_key_here"
      }
    }
  }
}

HTTP Stream

For web apps or remote access:

node dist/server.js --transport httpStream --port 8080

Endpoint: http://localhost:8080/mcp

Selective Module Loading

Load only the modules you need for faster startup:

# CLI flag
node dist/server.js --modules fred,treasury,congress

# Environment variable
MODULES=fred,bls,treasury node dist/server.js

# Combine with HTTP
node dist/server.js --modules fred,treasury --transport httpStream --port 8080

See all 40+ module names in the Data Sources page.

---

TypeScript SDK

Use the APIs directly in your code — no MCP server required.

Install

npm install us-gov-open-data-mcp

Usage

// Import individual modules
import { getObservations } from "us-gov-open-data-mcp/sdk/fred";
import { searchBills } from "us-gov-open-data-mcp/sdk/congress";
import { getLeadingCausesOfDeath } from "us-gov-open-data-mcp/sdk/cdc";

// Or import everything
import * as sdk from "us-gov-open-data-mcp/sdk";
const gdp = await sdk.fred.getObservations("GDP", { sort: "desc", limit: 5 });

All functions include disk-backed caching, retry with exponential backoff, and rate limiting — no extra setup.

See the SDK Usage Examples for more, or browse the API Reference for every function and type.

---

Next Steps

• API Keys — Which APIs need keys and where to get them
• Data Sources — All 40+ APIs at a glance
• Examples — Code examples, MCP prompts, and analysis showcases