EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

Integrate

MCP Server

https://docs.economicsapi.com/mcp

The EconomicsAPI MCP server connects any Model Context Protocol client — ChatGPT, Claude, Cursor, VS Code, Windsurf, and more — to the API. Ten focused tools resolve names and fetch compact results without unnecessary catalog calls.

Get started in 30 seconds

It is a hosted server — one URL. Authenticate with the same API key you use for REST, sent as a Bearer header; calls are metered and rate-limited identically.

Hosted endpoint
https://mcp.economicsapi.com/mcp

Install in your client

Setup for ChatGPT, Claude.ai, Cursor, VS Code, and Windsurf.

Authentication

OAuth or a dashboard API key, with the same metering as REST.

Tools

34 focused tools designed to minimize model round trips.

API reference

The complete REST API remains available separately.

Install in your client

ChatGPT and custom connectors use OAuth. Header-capable clients can instead replace sk_live_… with a dashboard key.

https://chatgpt.com/plugins/plugin_asdk_app_6abf68847b708191a30eec042d9893d0
  • ChatGPT: Opens our published ChatGPT app; add it as a connector and ChatGPT handles authentication.
  • Cursor: ~/.cursor/mcp.json (or .cursor/mcp.json in the project)
  • VS Code: .vscode/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json

Authentication

The server supports standard MCP OAuth for ChatGPT and Claude custom connectors, plus direct Authorization: Bearer sk_live_… headers. It forwards the underlying API key to the gateway on every tool call. Listing tools is free; a call without a valid key returns the gateway's 401. Keys are created in the dashboard.

Review tool calls

Tools execute real, metered API calls. Keep your client's “approve before running” setting on.

Tools

  • getEconomicsAvailableAvailable economics
  • listCountriesCountries
  • listIndicatorsIndicators
  • resolveDataData availability
  • getLatestLatest indicators
  • getHistoryIndicator history
  • searchSearch indicators
  • getUpdatesData updates
  • getNewsEconomic news
  • getForecastIndicator forecasts
  • getTradeAvailableAvailable trade
  • getTradeTrade flows
  • getTradeSummaryTrade summary
  • getTradeMonthlyMonthly trade
  • getCoverageTrade coverage
  • searchProductsTrade products
  • getProductProduct details
  • getProductHistoryProduct history
  • getProductMarketsProduct trading partners
  • searchTradeCountriesTrade countries
  • getTradeCountryCountry details
  • getCountryImportsCountry imports
  • getCountryExportsCountry exports
  • getCountryPartnersCountry partners
  • getCountryProductsCountry products
  • getFxAvailableAvailable fx rates
  • getFxHistoryFX rates history
  • getFxLatest FX rate
  • getCommoditiesAvailableAvailable commodity prices
  • getCommodityHistoryCommodity prices history
  • getCommodityLatest commodity price
  • getYieldsAvailableAvailable bond yields
  • getYieldHistoryBond yields history
  • getYieldLatest bond yield

Agent Skills

Prefer writing code over calling live MCP tools? EconomicsAPI also ships an open-source Agent Skills library — one skill per common workflow (get GDP for a country, compare trade partners, get inflation history…), each mapped to a real endpoint above. Works with Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, or any agent that reads a SKILL.md.

Install (no package to publish — copies files straight from the repo)
# install one skill
npx degit jeanhdev/economicsapi/skills/get-latest-indicator .claude/skills/get-latest-indicator

# install all of them
npx degit jeanhdev/economicsapi/skills economicsapi-skills && \
  mkdir -p .claude/skills && cp -r economicsapi-skills/*/ .claude/skills/ && rm -rf economicsapi-skills
  • get-latest-indicator — Get the latest value of an indicator for one or more countries
  • get-indicator-history — Get a historical time series, with YoY/MoM/3mma transforms
  • compare-countries — Compare one indicator across several countries or a group (g20, emu)
  • discover-data — Resolve a free-text query, or list every covered country/indicator
  • track-data-updates — Poll for series that changed since a timestamp
  • get-trade-summary — Aggregated bilateral trade: value, growth, top partners, HHI concentration
  • get-trade-monthly — Monthly bilateral trade flows for a product/country pair
  • compare-trade-partners — Rank a country's trading partners by import/export value
  • get-country-trade-profile — A country's import/export series and product mix
  • lookup-trade-product — Search HS6 products, then pull one product's trade history and top markets

Source: github.com/jeanhdev/economicsapi/tree/main/skills