FRED mCP Connector for Claude Desktop

An MCP Server for the FRED (Federal Reserve Economic Data) database, designed to be used by Claude Desktop. This server provides a comprehensive set of tools to interact with all endpoints of the FRED API.

Installation and Configuration with Claude Desktop

To use this server with Claude Desktop, you need to configure Claude to launch it.

1. Open Claude Desktop Settings: Go to the Claude menu in your system's menu bar and select "Settings..."

2. Access Developer Settings: Navigate to the "Developer" tab and click the "Edit Config" button. This will open your claude_desktop_config.json file.

3. Add the Server Configuration: Add the following JSON snippet to the mcpServers section of the file.

   {
     "mcpServers": {
       "fred": {
         "command": "npx",
         "args": [
           "-y",
           "fred-mcp-claude"
         ],
         "env": {
           "FRED_API_KEY": "your_api_key_here"
         }
       }
     }
   }

4. Replace Your API Key: In the snippet above, replace "your_api_key_here" with your actual FRED API key. You can obtain a free API key from the FRED website.

5. Restart Claude Desktop: Completely quit and restart Claude Desktop for the changes to take effect.

Once restarted, you should see the FRED tools available in the Claude Desktop interface.

Available Tools

The following is a complete list of the tools available in this server, organized by API category.

Series

• getSeries(seriesId)
• getSeriesCategories(seriesId)
• getSeriesObservations(seriesId, options = {})
• getSeriesRelease(seriesId)
• searchSeries(searchText, options = {})
• getSeriesSearchTags(searchText, options = {})
• getSeriesSearchRelatedTags(searchText, tagNames, options = {})
• getSeriesTags(seriesId)
• getSeriesUpdates(options = {})
• getSeriesVintageDates(seriesId)

Categories

• getCategory(categoryId)
• getCategoryChildren(categoryId)
• getRelatedCategory(categoryId)
• getCategorySeries(categoryId, options = {})
• getCategoryTags(categoryId)
• getCategoryRelatedTags(categoryId, tagNames, options = {})

Releases

• getReleases(options = {})
• getReleasesDates(options = {})
• getRelease(releaseId)
• getReleaseDates(releaseId, options = {})
• getReleaseSeries(releaseId, options = {})
• getReleaseSources(releaseId)
• getReleaseTags(releaseId)
• getReleaseRelatedTags(releaseId, tagNames, options = {})
• getReleaseTables(releaseId, options = {})

Sources

• getSources()
• getSource(sourceId)
• getSourceReleases(sourceId, options = {})

Tags

• getTags()
• getRelatedTags(tagNames)
• getTagsSeries(tagNames, options = {})