OpenEcon Data Give your AI agent accurate economic data. 330K indicators from FRED, World Bank, IMF, Eurostat, and 6 more sources — one MCP command away. Website · Live App · Docs · Contributing That's it. The script auto-detects Claude Code and Codex, configures everything. Then just ask: No special syntax. No "use querydata". Just ask naturally — your agent handles the rest.
Add this skill
npx mdskills install hanlulong/openecon-dataProvides verified economic data from 10+ official sources via natural language MCP queries
OpenEcon Data
Give your AI agent accurate economic data.
330K indicators from FRED, World Bank, IMF, Eurostat, and 6 more sources — one MCP command away.
Website · Live App · Docs · Contributing
curl -fsSL https://raw.githubusercontent.com/hanlulong/openecon-data/main/scripts/install.sh | bash
That's it. The script auto-detects Claude Code and Codex, configures everything. Then just ask:
You: "What's the US GDP growth rate?" → your agent fetches real data from FRED
You: "Compare inflation across G7 countries" → World Bank data for 7 countries
You: "Bitcoin price last 30 days" → CoinGecko live data
No special syntax. No "use query_data". Just ask naturally — your agent handles the rest.
Manual install (if you prefer)
Claude Code:
claude mcp add --transport sse openecon-data https://data.openecon.ai/mcp --scope user
Codex:
codex mcp add openecon-data --url https://data.openecon.ai/mcp
Any MCP agent: Endpoint https://data.openecon.ai/mcp (SSE transport)
See skills/README.md for slash commands and auto-trigger options.
AI agents hallucinate economic data. When you ask an LLM "What is US GDP?", you get a plausible-sounding number that may be outdated or wrong. OpenEcon solves this:
| Without OpenEcon | With OpenEcon | |
|---|---|---|
| Data source | LLM's training data (stale) | Official APIs (FRED, World Bank, IMF) |
| Accuracy | Approximate, often wrong | Verified, with source attribution |
| Coverage | Whatever the LLM remembers | 330K+ indicators, 200+ countries |
| Recency | Months or years behind | Up to real-time (FRED, ExchangeRate) |
| Verifiable | No source link | Every result includes source URL |
| Feature | OpenEcon | fredapi | pandas-datareader | fred-mcp-server |
|---|---|---|---|---|
| Natural language queries | Yes | No | No | No |
| Data sources | 10+ | 1 (FRED) | 5 | 1 (FRED) |
| MCP server for AI agents | Yes | No | No | Yes |
| Web UI with charts | Yes | No | No | No |
| Conversational follow-ups | Yes | No | No | No |
| Smart indicator discovery | 330K indexed | Manual codes | Manual codes | Manual codes |
| Self-hostable | Yes | N/A | N/A | Yes |
| No code required | Yes | No | No | No |
"US GDP growth last 10 years" → FRED, quarterly chart
"Compare China, India, Brazil GDP 2018-2024" → World Bank, multi-country comparison
"Inflation rate BRICS countries 2019-2023" → World Bank, 5 countries auto-expanded
"EUR/USD exchange rate last 24 months" → ExchangeRate-API, currency pair chart
"US unemployment and CPI together since 2010" → FRED, dual-axis overlay
"China exports to the US 2020-2024" → UN Comtrade, bilateral trade flow
"Credit to GDP ratio US, UK, Japan from BIS" → BIS, financial stability data
"Bitcoin price last year" → CoinGecko, crypto chart
"What inflation indicators does FRED have?" → Indicator discovery, text response
Conversational follow-ups work naturally:
You: "US GDP last 5 years" → chart with US GDP
You: "add Germany and Japan" → updates to 3 countries
You: "what about per capita?" → switches to GDP per capita
You: "show only 2020-2023" → narrows time range
data.openecon.ai/chat — no signup, no install.
git clone https://github.com/hanlulong/openecon-data.git
cd openecon-data
cp .env.example .env # Add your OPENROUTER_API_KEY
pip install -r requirements.txt
npm install
python3 scripts/restart_dev.py
# Backend: http://localhost:3001 | Frontend: http://localhost:5173
Requirements
See Getting Started Guide for full setup instructions.
"Compare US and ┌──────────────┐ ┌────────────────┐
Japan inflation" ───▶ │ LLM Parser │ ───▶ │ Smart Router │
│ (intent, │ │ (67 curated │
│ countries, │ │ concepts + │
│ dates) │ │ 330K index) │
└──────────────┘ └───────┬────────┘
│
┌────────────┐ ┌───────▼────────┐
│ Chart + │ ◀────── │ Fetch from │
│ CSV/JSON/ │ │ best provider │
│ DTA/Python │ │ (FRED, WB, │
└────────────┘ │ IMF, ...) │
└────────────────┘
MCP Server — First-class Model Context Protocol support. Give Claude Code, Codex, or any MCP-compatible agent access to verified economic data.
Natural Language — No API docs, no country codes, no series IDs. Just describe what you want.
330K Indicator Discovery — Full-text search across FRED, World Bank, IMF, Eurostat, BIS, and more. Ask "What trade data does Comtrade have?" and get a browsable list.
Conversational — Follow up naturally: add countries, change time ranges, switch indicators. The system remembers context.
Multi-Country Comparisons — Say "G7", "BRICS", "EU", "ASEAN", "Nordic" or list specific countries. Auto-expands to all members.
67 Curated Concepts — Hand-verified mappings ensure "US jobless claims" routes to FRED/ICSA, not a generic unemployment rate.
Cross-Encoder Reranking — FlashRank reranks search results so "GDP growth rate" matches the growth series, not raw GDP levels. Retrieve broadly, rerank precisely.
Multi-Format Export — CSV, JSON, DTA (Stata), and Python code. Every export includes source attribution.
Streaming — Real-time progress via Server-Sent Events.
Self-Hostable — AGPL-3.0 licensed. Add new providers by implementing a single base class.
| Provider | Coverage | Indicators | API Key |
|---|---|---|---|
| FRED | US macroeconomic data | 90,000+ series | Free |
| World Bank | Global development | 16,000+ indicators | None |
| IMF | International financial statistics | Extensive | None |
| Eurostat | EU member states | Extensive | None |
| UN Comtrade | International trade flows | All HS codes | Free |
| BIS | Central bank & financial stability | Curated | None |
| Statistics Canada | Canadian economic data | 40,000+ tables | None |
| OECD | OECD member countries | Extensive | None |
| ExchangeRate-API | 160+ currencies | Live & historical | Free |
| CoinGecko | Cryptocurrencies | 10,000+ coins | Free |
| Role | How they use it |
|---|---|
| AI Agent Builders | Add economic data capabilities to any MCP-compatible agent — verified data, not hallucinations |
| Economists & Researchers | Quick data pulls for papers without writing API code |
| Policy Analysts | Cross-country comparisons (G7, BRICS, EU) with one query |
| Students | Learn by exploring — ask questions, see data, export for assignments |
| Journalists | Fact-check economic claims against official sources in seconds |
┌─────────────────┐ ┌──────────────────┐ ┌──────────────────────────┐
│ User / Agent │────▶│ FastAPI Backend │────▶│ Data Providers │
│ │ │ │ │ │
│ "US inflation" │ │ LLM Parser │ │ FRED · World Bank · IMF │
│ │◀────│ Query Router │◀────│ Eurostat · BIS · ... │
│ Chart + Data │ │ Normalizer │ │ │
└─────────────────┘ └──────────────────┘ └──────────────────────────┘
│ │
React Frontend MCP Endpoint
(Vite + Recharts) (SSE Transport)
Stack: Python · FastAPI · React · TypeScript · Vite · Recharts · FAISS · OpenRouter
Contributions welcome! See the Developer & Contributor Guide.
If you find this useful, a star helps others discover the project.
AGPL-3.0 — Free to use, modify, and self-host. If you run a modified version as a service, you must share your changes. For commercial licensing, contact us.
Install via CLI
npx mdskills install hanlulong/openecon-dataOpenEcon Data is a free, open-source AI agent skill. OpenEcon Data Give your AI agent accurate economic data. 330K indicators from FRED, World Bank, IMF, Eurostat, and 6 more sources — one MCP command away. Website · Live App · Docs · Contributing That's it. The script auto-detects Claude Code and Codex, configures everything. Then just ask: No special syntax. No "use querydata". Just ask naturally — your agent handles the rest.
Install OpenEcon Data with a single command:
npx mdskills install hanlulong/openecon-dataThis downloads the skill files into your project and your AI agent picks them up automatically.
OpenEcon Data works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.