{"id":49540117,"url":"https://github.com/thinkchainai/economic-intelligence-mcp","last_synced_at":"2026-05-02T14:55:02.407Z","repository":{"id":339430460,"uuid":"1159989286","full_name":"thinkchainai/economic-intelligence-mcp","owner":"thinkchainai","description":"MCP App Server for economic data — interest rates, jobs, inflation, housing, bank health. Interactive charts, cross-source analysis, and stateful signal tracking from FRED, BLS, Treasury \u0026 FDIC.","archived":false,"fork":false,"pushed_at":"2026-03-02T09:48:45.000Z","size":23553,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T14:54:41.905Z","etag":null,"topics":["claude-desktop","economics","finance","fred","gdp","housing","inflation","interest-rates","mcp","mcp-app","mcp-server","recession"],"latest_commit_sha":null,"homepage":"https://mcpbundles.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thinkchainai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-17T12:10:33.000Z","updated_at":"2026-04-14T19:34:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/thinkchainai/economic-intelligence-mcp","commit_stats":null,"previous_names":["thinkchainai/economic-intelligence-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thinkchainai/economic-intelligence-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkchainai%2Feconomic-intelligence-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkchainai%2Feconomic-intelligence-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkchainai%2Feconomic-intelligence-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkchainai%2Feconomic-intelligence-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thinkchainai","download_url":"https://codeload.github.com/thinkchainai/economic-intelligence-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thinkchainai%2Feconomic-intelligence-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32538268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-desktop","economics","finance","fred","gdp","housing","inflation","interest-rates","mcp","mcp-app","mcp-server","recession"],"created_at":"2026-05-02T14:55:01.527Z","updated_at":"2026-05-02T14:55:02.399Z","avatar_url":"https://github.com/thinkchainai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Economic Intelligence MCP\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAsk your AI about the economy — interest rates, jobs, inflation, housing, bank health.\u003c/strong\u003e\u003cbr/\u003e\n  Interactive app with cross-source analysis from FRED, BLS, Treasury, and FDIC data.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/thinkchainai/economic-intelligence-mcp/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/Download-.mcpb-success?style=flat\" alt=\"Download .mcpb\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/thinkchainai/economic-intelligence-mcp\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/thinkchainai/economic-intelligence-mcp?style=flat\" alt=\"GitHub Stars\"/\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue?style=flat\" alt=\"MIT License\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Quick Start\n\n### 1. Clone the repo\n\n```bash\ngit clone https://github.com/thinkchainai/economic-intelligence-mcp.git\ncd economic-intelligence-mcp\n```\n\n### 2. Double-click the `.mcpb` file\n\nOpen `economic-intelligence-mcp.mcpb` — Claude Desktop will prompt you to install it.\n\n![Install the extension](1_add_mcpb.png)\n\n### 3. Add your FRED API key\n\n**Get a free key** (30 seconds): https://fred.stlouisfed.org/docs/api/api_key.html\n\nClaude Desktop will ask for it during setup:\n\n![Add your API key](2_add_api_key.png)\n\n### 4. Configure permissions\n\nThe server has 1 interactive tool (`open_economic_app`) and 12 read-only data tools:\n\n![Configure permissions](3_config_permissions.png)\n\n### 5. Enable the connector\n\n![Enable the connector](4_enable_connector.png)\n\n### 6. Open the economics app\n\nJust type \"Open the economics app\" and Claude will launch the interactive dashboard:\n\n![Open the economics app](5_open_econonmics_app.png)\n\nThe app has tabbed navigation for rates, inflation, jobs, housing, GDP, treasury, banking, comparison, and search — all with live data and interactive charts.\n\n**Other things to try:**\n\n\u003e \"Show me interest rates over the last 5 years\"\n\u003e\n\u003e \"Compare unemployment rate with inflation\"\n\u003e\n\u003e \"Any economic alerts right now?\"\n\u003e\n\u003e \"How has the yield curve signal changed over the last 6 months?\"\n\n---\n\n## 13 Tools\n\n### Interactive App (1 tool)\n\n| Tool | What it does |\n|---|---|\n| `open_economic_app` | Opens the interactive dashboard — charts, recession gauge, signals, data explorer |\n\n### Live Data (9 tools)\n\n| Tool | What it does |\n|---|---|\n| `econ_interest_rates` | Fed funds, 10Y/30Y treasury, mortgage rates, yield curve |\n| `econ_inflation` | CPI, PCE, core inflation with YoY analysis |\n| `econ_jobs` | Unemployment, nonfarm payrolls, wage growth, job openings |\n| `econ_housing` | Housing starts, permits, home prices, affordability index |\n| `econ_bank_health` | FDIC capital ratios, problem banks, failure history |\n| `econ_gdp` | GDP growth — nominal, real, annualized |\n| `econ_treasury` | Treasury rates, yield spreads, federal debt |\n| `econ_compare` | Compare any two FRED series with correlation analysis |\n| `econ_search` | Search 800K+ FRED series by keyword |\n\n### Stateful Intelligence (3 tools)\n\nThese tools use a local SQLite database to track how signals change over time. On first run, the server backfills 12 months of signal history so they work immediately.\n\n| Tool | What it does |\n|---|---|\n| `econ_signal_history` | How yield curve, jobs/inflation, and bank stress signals have changed over months |\n| `econ_changes` | What shifted recently — compares latest signals to prior snapshots |\n| `econ_alerts` | Threshold crossings, trend reversals, recession probability shifts |\n\n---\n\n## Cross-Source Intelligence\n\nThis isn't just an API wrapper. The server combines data from multiple government sources and computes:\n\n- **Yield curve inversion** — 10Y-2Y spread analysis, historically the best recession predictor\n- **Jobs vs. inflation divergence** — overheating, stagflation, and goldilocks detection\n- **Housing affordability index** — home prices × mortgage rates × income composite\n- **Banking stress score** — FDIC problem bank count + failure trends\n- **Composite recession probability** — weighted signal from all sources\n\n### Signal History \u0026 Alerts\n\nThe server tracks its own computed signals over time in a lightweight local database (`~/.economic-mcp/data.db`). On first startup, it backfills 12 months of historical signal data by running its scoring algorithms against historical FRED data. After that, it refreshes every 6 hours.\n\nThis enables questions that no other MCP server can answer:\n\n- \"How has recession probability changed over the last 6 months?\"\n- \"Did any signals cross a critical threshold this week?\"\n- \"Is the yield curve trend reversing?\"\n\n```\nGovernment APIs → Scoring Engine → Signal Snapshots → MCP Tools → Claude Desktop\n       ↓                ↓                  ↓                ↓\n     FRED          Yield curve         Local SQLite     Interactive app\n     BLS           Jobs/inflation      12mo backfill    Charts \u0026 gauges\n     Treasury      Bank stress         6hr refresh      Alert detection\n     FDIC          Recession prob.     Change tracking\n```\n\n---\n\n## Data Sources\n\nAll free government APIs with generous rate limits:\n\n| Source | What | Auth |\n|---|---|---|\n| [FRED](https://fred.stlouisfed.org/) | 800K+ economic series — GDP, CPI, unemployment, rates, housing | Free API key |\n| [BLS](https://www.bls.gov/developers/) | Employment, wages, CPI by metro and industry | Free API key (optional) |\n| [Treasury](https://fiscaldata.treasury.gov/) | Daily rates, federal debt, bond auctions | None |\n| [FDIC](https://banks.data.fdic.gov/) | Bank health, capital ratios, failure history | None |\n\n---\n\n## Rebuild the `.mcpb`\n\nIf you modify the source or need to update env var config:\n\n```bash\n./build-mcpb.sh\n```\n\nThis runs `npx @anthropic-ai/mcpb pack` and outputs a fresh `economic-intelligence-mcp.mcpb` in the repo root. Double-click to reinstall.\n\n---\n\n## Alternative: Run from source\n\nIf you prefer not to use the `.mcpb` file:\n\n```bash\n# Install\npip install -e .\n\n# Set your API key\nexport FRED_API_KEY=your_key_here\n\n# Run the server\neconomic-intelligence-mcp\n```\n\nThen add to your Claude Desktop config (`~/.claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"economic-intelligence\": {\n      \"command\": \"economic-intelligence-mcp\",\n      \"env\": {\n        \"FRED_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Hosted Version\n\nDon't want to manage API keys or run locally?\n\n**[mcpbundles.com](https://mcpbundles.com)** — same tools, zero setup. Data is always current.\n\n---\n\n## Contributing\n\nPRs welcome — bug fixes, new scoring algorithms, new data sources, UI improvements.\n\n```bash\ngit clone https://github.com/thinkchainai/economic-intelligence-mcp.git\ncd economic-intelligence-mcp\npip install -e \".[dev]\"\n```\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nBuilt by [MCPBundles](https://mcpbundles.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinkchainai%2Feconomic-intelligence-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthinkchainai%2Feconomic-intelligence-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthinkchainai%2Feconomic-intelligence-mcp/lists"}