Fred Economic Mcp
by danishashkocommunityv1.0.3
MCP server for querying U.S. and global economic data from FRED, including series search, observations, metadata, category browsing, releases, and an economic snapshot. It applies FRED-side transforms and frequency aggregation, and returns results as markdown or JSON.
From the registry: FRED economic data: GDP, inflation, unemployment, rates, and 800k+ Federal Reserve time series.
Install & configure
Prerequisites
- required
- requiredInstall Python 3.10+Required because the npx wrapper creates an isolated Python environment and installs dependencies on first launch.https://www.python.org/downloads/
- requiredGet a FRED API keyCreate a free FRED account and request an API key, then provide it via the FRED_API_KEY environment variable.https://fredaccount.stlouisfed.org/apikeys
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `fred-economic-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 16+** — Required to run the recommended npx-based server launch. (https://nodejs.org/)
- **Install Python 3.10+** — Required because the npx wrapper creates an isolated Python environment and installs dependencies on first launch. (https://www.python.org/downloads/)
- **Get a FRED API key** — Create a free FRED account and request an API key, then provide it via the FRED_API_KEY environment variable. (https://fredaccount.stlouisfed.org/apikeys)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","fred-economic-mcp"]
- required environment variables:
- `FRED_API_KEY`: Free API key for the FRED API. (example: `<your-fred-api-key>`)
Note: Preferred install path is the npm package via npx. The server communicates locally over stdin/stdout using JSON-RPC. On first run, the npx wrapper creates an isolated Python environment and installs dependencies automatically. A global npm install and a direct Python script launch are also documented, but npx is the simplest portable option.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred install path is the npm package via npx. The server communicates locally over stdin/stdout using JSON-RPC. On first run, the npx wrapper creates an isolated Python environment and installs dependencies automatically. A global npm install and a direct Python script launch are also documented, but npx is the simplest portable option.
Tools (6)
search_series
Searches FRED economic series by keyword and returns matching series ranked by popularity
get_series_observations
Returns time series data values with optional transforms and frequency aggregation
get_series_info
Returns metadata for a FRED series such as units, frequency, seasonal adjustment, coverage, and notes
get_economic_snapshot
Returns a dashboard of key current U.S. economic indicators
browse_category
Returns child categories and popular series within a FRED category
get_releases
Returns economic data releases tracked by FRED
Environment variables
FRED_API_KEYrequiredFree FRED API key used to authenticate requests to the FRED APIPrerequisites
- • Python 3.10+
- • Node.js 16+
- • python3
Packages
fred-economic-mcp
npmv1.0.3transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Jun 14, 2026
- Last commit
- Aug 6, 2026
- Registry name
- io.github.danishashko/fred-economic-mcp
Categories
Related Servers
Labelhead Artist Momentum
Trending hip-hop artist momentum scores across four cultural dimensions.
78.5k
PostHog MCP Server
Official PostHog MCP Server for product analytics, feature flags, experiments, and more.
37.7k
Openmetadata Mcp
Official OpenMetadata MCP: governed context and business semantics for AI assistants and agents.
14.9k