NestDaddy

Federal Reserve Mcp Server

io.github.cyanheads/federal-reserve-mcp-server · v0.4.0

Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP.

Connect Runs on your machine

Terminal
claude mcp add federal-reserve-mcp-server -e FRED_API_KEY=<FRED_API_KEY> -e FRED_BASE_URL=<FRED_BASE_URL> -e FRED_DATASET_TTL_SECONDS=<FRED_DATASET_TTL_SECONDS> -e FRED_DATAFRAME_DROP_ENABLED=<FRED_DATAFRAME_DROP_ENABLED> -e FRED_CLAMP_LIMITS=<FRED_CLAMP_LIMITS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "federal-reserve-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "FRED_API_KEY": "<FRED_API_KEY>",
        "FRED_BASE_URL": "<FRED_BASE_URL>",
        "FRED_DATASET_TTL_SECONDS": "<FRED_DATASET_TTL_SECONDS>",
        "FRED_DATAFRAME_DROP_ENABLED": "<FRED_DATAFRAME_DROP_ENABLED>",
        "FRED_CLAMP_LIMITS": "<FRED_CLAMP_LIMITS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "federal-reserve-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "FRED_API_KEY": "<FRED_API_KEY>",
        "FRED_BASE_URL": "<FRED_BASE_URL>",
        "FRED_DATASET_TTL_SECONDS": "<FRED_DATASET_TTL_SECONDS>",
        "FRED_DATAFRAME_DROP_ENABLED": "<FRED_DATAFRAME_DROP_ENABLED>",
        "FRED_CLAMP_LIMITS": "<FRED_CLAMP_LIMITS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "federal-reserve-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "FRED_API_KEY": "<FRED_API_KEY>",
        "FRED_BASE_URL": "<FRED_BASE_URL>",
        "FRED_DATASET_TTL_SECONDS": "<FRED_DATASET_TTL_SECONDS>",
        "FRED_DATAFRAME_DROP_ENABLED": "<FRED_DATAFRAME_DROP_ENABLED>",
        "FRED_CLAMP_LIMITS": "<FRED_CLAMP_LIMITS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
FRED_API_KEY
Required
FRED API key from stlouisfed.org. Required to make any API calls.
FRED_BASE_URL
Optional
Override the FRED API base URL.
FRED_DATASET_TTL_SECONDS
Optional
Lifetime of a registered dataframe from creation, in seconds.
FRED_DATAFRAME_DROP_ENABLED
Optional
Set to 'true' to enable fedreserve_dataframe_drop; otherwise it remains registered as disabled.
FRED_CLAMP_LIMITS
Optional
Accept up to 100 series IDs and return IDs beyond the 10-observation or 50-metadata processing limit in deferred_ids; false restores strict limits.
MCP_LOG_LEVEL
Optional
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Details

Package@cyanheads/[email protected] (NPM, stdio)
Package@cyanheads/[email protected] (NPM, streamable-http)
First published11 Nov 2026
Last updated11 Nov 2026
Registry nameio.github.cyanheads/federal-reserve-mcp-server

More search and web servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.