Economic Data API

v1.0.0Analyticsstable

Give your AI agent accurate economic data. 330K indicators from FRED, World Bank, IMF, Eurostat & more. MCP server + web UI.

aidata-visualizationeconomic-dataeconomic-indicatorseconomics
Share:
42
Stars
0
Downloads
0
Weekly
0/5

What is Economic Data API?

Economic Data API is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to give your ai agent accurate economic data. 330k indicators from fred, world bank, imf, eurostat & more. mcp server + web ui.

Give your AI agent accurate economic data. 330K indicators from FRED, World Bank, IMF, Eurostat & more. MCP server + web UI.

This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Give your AI agent accurate economic data. 330K indicators f

Use Cases

330K economic indicators
FRED and World Bank data
Financial data analysis
hanlulong

Maintainer

LicenseNOASSERTION
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openecon-data

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Economic Data API

Openecon Data is an MCP server that gives AI agents access to over 330,000 economic indicators sourced from FRED, World Bank, IMF, Eurostat, UN Comtrade, BIS, OECD, and more — all through natural language queries. It supports multi-country comparisons, time-range specifications, conversational follow-ups, and data exports in CSV, JSON, DTA, and Python formats. Economists, analysts, and researchers use it to pull accurate, up-to-date macroeconomic and financial data into their AI workflows without writing API integrations for each data provider.

Prerequisites

  • An MCP-compatible client such as Claude Code, Claude Desktop, or Codex CLI
  • For the hosted version: no API key required — connect directly via SSE transport
  • For self-hosted: Python 3.10+, an OPENROUTER_API_KEY from openrouter.ai, and a JWT_SECRET generated with openssl
  • Optional: FRED, Comtrade, or CoinGecko API keys for enhanced provider access in self-hosted mode
1

Connect to the hosted Openecon Data MCP server (quickest start)

The easiest way to get started is to register the hosted SSE endpoint directly with Claude Code. No local install is required.

claude mcp add --transport sse openecon-data https://data.openecon.ai/mcp --scope user
2

Add to Claude Desktop config (alternative)

For Claude Desktop, add the server using the standard JSON config format pointing to the hosted SSE URL.

{
  "mcpServers": {
    "openecon-data": {
      "type": "sse",
      "url": "https://data.openecon.ai/mcp"
    }
  }
}
3

Self-host: clone and configure the server

If you prefer to run the server locally, clone the repository, configure your environment variables, and run the setup script.

git clone https://github.com/hanlulong/openecon-data.git
cd openecon-data
cp .env.example .env
# Edit .env: set OPENROUTER_API_KEY and JWT_SECRET
./scripts/setup.sh
4

Set required environment variables for self-hosted mode

OPENROUTER_API_KEY enables the LLM parsing layer. JWT_SECRET secures session tokens. Generate a strong secret with openssl.

# In your .env file:
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxx
JWT_SECRET=$(openssl rand -hex 32)
5

Start the self-hosted server and verify

Run the restart script to start the development server. Confirm it is up by running a test query against the local API endpoint.

python3 scripts/restart_dev.py

Economic Data API Examples

Client configuration

Claude Desktop config for the hosted Openecon Data SSE endpoint.

{
  "mcpServers": {
    "openecon-data": {
      "type": "sse",
      "url": "https://data.openecon.ai/mcp"
    }
  }
}

Prompts to try

Example natural-language queries covering single-country, multi-country, and financial data lookups.

- "What has US GDP growth been over the last 10 years?"
- "Compare China, India, and Brazil GDP from 2018 to 2024"
- "Show EU unemployment rates by country for 2023"
- "Get the EUR/USD exchange rate for the past 24 months"
- "Export US CPI and PCE inflation data as CSV for 2020 to 2025"

Troubleshooting Economic Data API

SSE connection times out or returns 502

Check that the hosted endpoint https://data.openecon.ai/mcp is reachable from your network. If behind a proxy, ensure your MCP client passes through SSE connections. Try self-hosting as a fallback.

Self-hosted server starts but queries return LLM parsing errors

Verify OPENROUTER_API_KEY is set correctly in your .env file and that you have credits on your OpenRouter account. The key must start with 'sk-or-'.

Data for a specific country or indicator is missing

Not all providers require extra API keys, but Comtrade (trade data) and CoinGecko (crypto) need their own keys set in .env for full access. Add COMTRADE_API_KEY or COINGECKO_API_KEY as needed.

Frequently Asked Questions about Economic Data API

What is Economic Data API?

Economic Data API is a Model Context Protocol (MCP) server that give your ai agent accurate economic data. 330k indicators from fred, world bank, imf, eurostat & more. mcp server + web ui. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Economic Data API?

Follow the installation instructions on the Economic Data API GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Economic Data API?

Economic Data API works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Economic Data API free to use?

Yes, Economic Data API is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openecon-data": { "command": "npx", "args": ["-y", "openecon-data"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Economic Data API?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides