openecon-data
Give your AI agent accurate economic data. 330K indicators from FRED, World Bank, IMF, Eurostat & more. MCP server + web UI.
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
Install (One Line, Then Just Talk)
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.
Why Your Agent Needs This
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 |
How It Compares
| 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 |
What You Can Ask
"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
Quick Start
Use the web app (no setup)
data.openecon.ai/chat — no signup, no install.
Self-host
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
- Python 3.10+
- Node.js 18+
- An OpenRouter API key (required for LLM parsing)
- Optional: FRED API key, Comtrade API key, CoinGecko API key
- Optional: Supabase credentials (for auth + persistent history)
See Getting Started Guide for full setup instructions.
How It Works
"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, ...) │
└────────────────┘
- Parse — An LLM extracts intent, countries, indicators, and date range from plain English
- Route — 67 curated economic concepts + 330K indicator index picks the best provider
- Fetch — Data retrieved from official APIs, normalized and aligned
- Return — Interactive chart, or structured data via MCP for your agent
Features
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.
Data Sources
| 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 |
Who Is This For?
| 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 |
Architecture
┌─────────────────┐ ┌──────────────────┐ ┌──────────────────────────┐
│ 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
Contributing
Contributions welcome! See the Developer & Contributor Guide.
- Open issues — bug reports and feature requests
- Documentation — full docs index
- Security policy — responsible disclosure
If you find this useful, a star helps others discover the project.
License
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.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found