io.github.cyanheads

fred-mcp-server

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

communityknowledge

Package Details

Transportstdio
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:stdio

Environment Variables

FRED_API_KEY(str)
Required

FRED API key from stlouisfed.org. Required to make any API calls.

FRED_BASE_URL(str)
Default:https://api.stlouisfed.org/fred

Override the FRED API base URL.

FRED_DATASET_TTL_SECONDS(str)
Default:86400

Sliding TTL for DataCanvas-registered observation tables (seconds).

FRED_DATAFRAME_DROP_ENABLED(str)
Default:false

Set to 'true' to expose the fred_dataframe_drop tool.

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

TransportStreamable HTTP
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:http

Environment Variables

FRED_API_KEY(str)
Required

FRED API key from stlouisfed.org. Required to make any API calls.

FRED_BASE_URL(str)
Default:https://api.stlouisfed.org/fred

Override the FRED API base URL.

FRED_DATASET_TTL_SECONDS(str)
Default:86400

Sliding TTL for DataCanvas-registered observation tables (seconds).

FRED_DATAFRAME_DROP_ENABLED(str)
Default:false

Set to 'true' to expose the fred_dataframe_drop tool.

MCP_HTTP_HOST(str)
Default:127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORT(str)
Default:3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH(str)
Default:/mcp

The endpoint path for the MCP server.

MCP_AUTH_MODE(str)
Default:none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').