MCP server
Federal Reserve MCP Server
Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP.
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.4.0
- Listing updated
- 4 days ago
About Federal Reserve MCP Server
Federal Reserve MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add federal-reserve-mcp-server --env FRED_API_KEY='<FRED_API_KEY>' -- npx -y @cyanheads/federal-reserve-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"federal-reserve-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/federal-reserve-mcp-server"
],
"env": {
"FRED_API_KEY": "<FRED_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"federal-reserve-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/federal-reserve-mcp-server"
],
"env": {
"FRED_API_KEY": "<FRED_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"federal-reserve-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/federal-reserve-mcp-server"
],
"env": {
"FRED_API_KEY": "<FRED_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"federal-reserve-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/federal-reserve-mcp-server"
],
"env": {
"FRED_API_KEY": "<FRED_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"federal-reserve-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/federal-reserve-mcp-server"
],
"env": {
"FRED_API_KEY": "<FRED_API_KEY>"
}
}
}
}Configuration
FRED_API_KEYFRED API key from stlouisfed.org. Required to make any API calls.RequiredFRED_BASE_URLOverride the FRED API base URL.FRED_DATASET_TTL_SECONDSLifetime of a registered dataframe from creation, in seconds.FRED_DATAFRAME_DROP_ENABLEDSet to 'true' to enable fedreserve_dataframe_drop; otherwise it remains registered as disabled.FRED_CLAMP_LIMITSAccept 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_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.FRED_API_KEYFRED API key from stlouisfed.org. Required to make any API calls.RequiredFRED_BASE_URLOverride the FRED API base URL.FRED_DATASET_TTL_SECONDSLifetime of a registered dataframe from creation, in seconds.FRED_DATAFRAME_DROP_ENABLEDSet to 'true' to enable fedreserve_dataframe_drop; otherwise it remains registered as disabled.FRED_CLAMP_LIMITSAccept 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_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Federal Reserve MCP Server FAQ
Is Federal Reserve MCP Server free?
Yes. Federal Reserve MCP Server is open source, so you can use and self-host it for free.
How do I add Federal Reserve MCP Server to Claude Code?
Run this command in your terminal: claude mcp add federal-reserve-mcp-server --env FRED_API_KEY='<FRED_API_KEY>' -- npx -y @cyanheads/federal-reserve-mcp-server