@leviai/publicfinance-mcp

Public Finance MCP Server — SEC EDGAR filings, US Treasury rates, BLS labor statistics, and economic indicators in one MCP server. Zero API keys required.

Why This Exists

Existing SEC EDGAR MCP servers only cover filings. Existing FRED servers require API keys. No MCP server combines SEC EDGAR + US Treasury rates + BLS labor stats into one unified interface with zero configuration.

PublicFinance MCP gives AI agents access to the entire US public financial data landscape — company filings, yield curves, unemployment data, CPI, and more — all from free government APIs.

Tools (6)

Tool	Description
company_filings	Search SEC EDGAR for company filings (10-K, 10-Q, 8-K, S-1, etc.) by ticker or CIK
company_facts	Get XBRL financial data — Revenue, NetIncome, Assets, and 1000+ standardized concepts
treasury_rates	US Treasury yield curve, bill rates, long-term rates, real yields
labor_statistics	BLS data: unemployment rate, CPI, nonfarm payrolls, participation rate, PPI, and custom series
ticker_lookup	Resolve ticker symbols ↔ company names ↔ CIK numbers
economic_overview	One-call snapshot of key US economic indicators (yield curve + unemployment + CPI + payrolls)

Quick Start

Install

npm install -g @leviai/publicfinance-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "publicfinance": {
      "command": "npx",
      "args": ["-y", "@leviai/publicfinance-mcp"]
    }
  }
}

Cursor / Windsurf / VS Code

Add to your MCP settings:

{
  "publicfinance": {
    "command": "npx",
    "args": ["-y", "@leviai/publicfinance-mcp"]
  }
}

Usage Examples

"Show me Apple's recent 10-K filings"

→ company_filings(company: "AAPL", form_type: "10-K")

"What's Apple's revenue over the past 5 years?"

→ company_facts(company: "AAPL", concept: "RevenueFromContractWithCustomerExcludingAssessedTax")

"Get the current Treasury yield curve"

→ treasury_rates(rate_type: "yield_curve")

"What's the unemployment rate?"

→ labor_statistics(preset: "unemployment")

"Give me an economic overview"

→ economic_overview()

"Look up Tesla's CIK number"

→ ticker_lookup(query: "TSLA")

Data Sources

All data comes from free, public US government APIs with no authentication required:

Source	Data	API
SEC EDGAR	Company filings, XBRL financials	data.sec.gov
US Treasury	Yield curves, bill rates, long-term rates	home.treasury.gov
Bureau of Labor Statistics	Unemployment, CPI, payrolls, PPI	api.bls.gov (v1, no key)

BLS Preset Series

Preset	Description	Series ID
unemployment	Unemployment Rate (SA)	LNS14000000
cpi	CPI All Urban Consumers	CUUR0000SA0
nonfarm_payrolls	Total Nonfarm Employment	CES0000000001
participation	Labor Force Participation Rate	LNS11300000
core_cpi	CPI Less Food & Energy	CUUR0000SA0L1E
avg_hourly_earnings	Average Hourly Earnings (Private)	CES0500000003
manufacturing	Manufacturing Employment	CES3000000001
ppi	Producer Price Index	PCU327320327320

You can also pass any custom BLS series ID via series_id.

Requirements

• Node.js >= 18.0.0
• No API keys needed
• Internet access to US government APIs

Rate Limits

• SEC EDGAR: Max 10 requests/second. The server uses a compliant User-Agent header.
• BLS API v1: 25 series per query, 25 queries per day (no registration). For higher limits, register at bls.gov.
• US Treasury: No documented rate limits.

License

MIT — Built by Levi Labs