Skip to content
appsgit

Fred MCP Server

Fred MCP Server is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Federal Reserve Economic Data (FRED) MCP Server - Access all 800,000+ economic time series. It has 124 GitHub stars, is released under the AGPL-3.0 license and runs locally with npx -y fred-mcp-server.

github.com/stefanoamorelli/fred-mcp-server (opens in a new tab)

  • Needs API key
  • Finance
  • AGPL-3.0
  • Actively maintained

Install Fred MCP Server

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "fred-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fred-mcp-server"
      ],
      "env": {
        "FRED_API_KEY": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env FRED_API_KEY=your-value --transport stdio fred-mcp-server -- npx -y fred-mcp-server

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "fred-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fred-mcp-server"
      ],
      "env": {
        "FRED_API_KEY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "fred_api_key",
      "description": "FRED_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "fred-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fred-mcp-server"
      ],
      "env": {
        "FRED_API_KEY": "${input:fred_api_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
FRED_API_KEYsecretYesYour FRED API key to access the API

Tools (22)

Parsed from the Tools section of the README; check the repository for the current list.

  • fred_browse
  • browse_type

    Type of browsing - "categories", "releases", "sources", "categoryseries", "releaseseries"

  • category_id

    Category ID for browsing subcategories or series within a category

  • release_id

    Release ID for browsing series within a release

  • limit

    Maximum number of results (default: 50)

  • offset

    Number of results to skip for pagination

  • order_by

    Field to order results by

  • sort_order

    "asc" or "desc"

  • fred_search
  • search_text

    Text to search for in series titles and descriptions

  • search_type

    "fulltext" or "seriesid"

  • tag_names

    Comma-separated list of tag names to filter by

  • exclude_tag_names

    Comma-separated list of tag names to exclude

  • filter_variable

    Filter by "frequency", "units", or "seasonal_adjustment"

  • filter_value

    Value to filter the variable by

  • fred_get_series
  • series_id

    The FRED series ID (e.g., "GDP", "UNRATE", "CPIAUCSL")

  • observation_start

    Start date in YYYY-MM-DD format

  • observation_end

    End date in YYYY-MM-DD format

  • units

    Data transformation:

  • frequency

    Frequency aggregation ("d", "w", "m", "q", "a")

  • aggregation_method

    "avg" (average), "sum", or "eop" (end of period)

About Fred MCP Server

A Model Context Protocol (MCP) server providing universal access to all 800,000+ Federal Reserve Economic Data (FRED®) time series through three powerful tools.

  • finance
  • genai
  • llm
  • mcp-server
  • data
  • data-analysis-project
  • financial-analysis
  • mcp
  • model-context-protocol
  • model-context-protocol-server

FAQ

Fred MCP Server FAQ

Still curious? Email info@appsgit.com.

What is Fred MCP Server?

Fred MCP Server is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Federal Reserve Economic Data (FRED) MCP Server - Access all 800,000+ economic time series. It has 124 GitHub stars, is released under the AGPL-3.0 license and runs locally with npx -y fred-mcp-server. The source code is at github.com/stefanoamorelli/fred-mcp-server.

How do I install the Fred MCP Server MCP server?

Add the command npx -y fred-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Fred MCP Server free?

The server is open source under the AGPL-3.0 license, so running it is free. It needs credentials (FRED_API_KEY) for the service it connects to, which may require a paid account.

Is Fred MCP Server actively maintained?

The most recent commit was on Aug 22, 2026. The latest release is v1.2.0, published Aug 20, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.