MCP integration documentation

DatoQA — Economic Indicators

World Bank annual country indicators and history since 1960; scoped Eurostat, BLS, Bank of Canada, ECB, Fed and Bank of England policy-rate series. Units, source dates, missing values and citations. Availability varies by series; not real-time.

13 read-only tools · Streamable HTTP · No account, API key or wallet · Free factual tools during the pilot

Connect your agent

Remote MCP endpoint:

https://datoqa.bhazarstudio.workers.dev/mcp/economy

Connect one scope. Adding both the general server and every theme duplicates tools. Review and merge configuration with existing servers; do not overwrite another connection named datoqa.

Claude Code

claude mcp add --transport http datoqa https://datoqa.bhazarstudio.workers.dev/mcp/economy

Use /mcp to check the connection. Download project .mcp.json content.

VS Code / GitHub Copilot

Merge into .vscode/mcp.json, then use MCP: List Servers and enable the tools in agent chat.

{
  "servers": {
    "datoqa": {
      "type": "http",
      "url": "https://datoqa.bhazarstudio.workers.dev/mcp/economy"
    }
  }
}

Download VS Code configuration

Cursor

Merge into the project’s .cursor/mcp.json, then review the server in MCP settings.

{
  "mcpServers": {
    "datoqa": {
      "url": "https://datoqa.bhazarstudio.workers.dev/mcp/economy"
    }
  }
}

Download Cursor configuration

Get your first sourced answer

If you know the supported identifiers, call the data tool directly. A separate catalog or evidence call is optional. The data response already includes citations and freshness.

{
  "country": "USA",
  "indicator": "gdp_per_capita",
  "from": 2000,
  "to": 2020
}

Optional country comparison

Need a ready-to-use table for several countries? The existing country report defaults to population, current-USD GDP and annual CPI inflation for 1–10 economies over five completed years. Custom dossiers can select up to six of 22 historical WDI indicators over up to ten years: trade, energy, land use, water, health or education. Supply report_indicators, report_from and report_to together in catalog, or indicators/from/to in HTTP. Missing observations block purchase. One payment of 0.002 USDC on Base includes aligned JSON, an embedded CSV export, definitions, original producers, notes and source snapshots. Original data and factual tools remain free; this pays for preparation and delivery, not exclusive data or independent factual verification.

First ask the existing catalog tool for a free preview:

{"report_countries":["FRA","DEU","ESP","ITA","NLD"],"language":"fr"}

Open the free HTTP preview. Inspect purchasable, missing cells, source dates and price. The preview never pays. A missing numeric value or stale/incomplete source blocks the purchase.

To buy, use the returned purchase_path with an x402-enabled HTTP client and an authorized budget. Ordinary MCP connectivity does not enable payment. The snapshot digest must match the preview; changes return 409 before payment. Save the JSON response and its csv.content without making a second purchase. Do not blindly authorize a new payment after a lost response; automatic recovery/refunds are not offered.

Datasets, sources and access

These descriptions explain the supported collections. Live directories and response status determine current availability. DatoQA structures source snapshots; source and schema checks do not independently establish factual truth.

BLS monthly indicators are also supported by the interface, but availability is not assumed here. Check the live BLS directory before requesting CPI, unemployment or payroll data.

Read a response correctly

• Read status and returned, then the observation period and unit. HTTP 200 can contain an unavailable or empty result.
• source_unavailable_or_stale means there is no currently publishable snapshot; retry later or consult the publisher. It does not establish a zero value.
• no_numeric_data_in_period, no_data_in_period, year_not_covered or no_holiday_listed_for_date describe different gaps. Never replace a missing value with zero or infer a working day.
• Preserve citation, freshness and provenance. A SHA-256 evidence hash checks the stored source snapshot, not independent factual truth.

World Bank economy codes use three characters, such as USA and FRA. Eurostat uses its own two-character codes, with EL for Greece. Holiday region identifiers such as gb-england-and-wales and oh-de are a separate system.

Coverage and interpretation

World Bank annual series start in 1960, with country/year gaps. Eurostat covers scoped EU/EFTA monthly and quarterly series since 2020. Canadian policy rates begin in 2010. UK Bank Rate uses provider=boe and series=bank_rate, daily source dates since 1975 with historical regime notes. format=csv on historical indicators and policy rates exports selected observations with units, null flags and provenance. provider=fed exposes eight US target/implementation series with distinct starts since 1982; pre-1994 target is a documented reconstruction. Use provider=ecb for ECB dates of changes since 1999; fixed and historical minimum-bid refinancing remain distinct. BLS is a supported interface but may be unavailable: inspect its directory. Never mix current USD, constant USD and PPP.

Read status, returned, observation dates, units, nulls, freshness, citation and provenance. Collection time is not the observation period. Historical values can be revised. independently_verified remains false: official-source and schema checks are not independent factual corroboration. Missing information stays unavailable.