MCP integration documentation

DatoQA — Historical Exchange Rates

ECB recent and historical EUR reference exchange rates since 1999. Exact source dates, original decimals, citations and explicit gaps. Not live or executable prices.

7 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/fx

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/fx

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/fx"
    }
  }
}

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/fx"
    }
  }
}

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.

{
  "currency": "USD",
  "date": "2008-09-15"
}

Practical tasks — free pilot

convert_currency_batch converts dated decimal-string amounts to a target_currency chosen from 30 supported currencies, including EUR (default), USD, JPY, CNY, GBP, CHF, INR and KRW using exact-date ECB references. Supported target codes: EUR, USD, JPY, CZK, DKK, GBP, HUF, PLN, RON, SEK, CHF, ISK, NOK, TRY, AUD, BRL, CAD, CNY, HKD, IDR, ILS, INR, KRW, MXN, MYR, NZD, PHP, SGD, THB, ZAR. JPY, KRW and ISK use zero decimal places; other supported targets use two (ISO 4217 minor units, not cash rounding). Availability depends on source dates; use list_exchange_rate_history to inspect coverage. Cross conversions retain both rates and their evidence; no intermediate rounding. Read amount_target and total_target; legacy euro fields are null for non-EUR targets. No transfers or date substitution. A missing or stale rate blocks the complete export and total.

{
  "rows": [
    {
      "id": "example-1",
      "date": "2025-09-26",
      "currency": "USD",
      "amount": "125.50"
    }
  ],
  "target_currency": "GBP",
  "output_format": "both"
}

Demandez : « Convertis ces montants en livres sterling aux dates indiquées, conserve les montants d’origine et explique les lignes impossibles à convertir. »

Maximum 500 rows and 48,000 UTF-8 argument bytes; 20 columns for tables or eight currency/year snapshots for conversions. Start small. JSON by default; output_format=both adds CSV to the same free result. Inspect status and issues. Customer content stays in memory; DatoQA retains only aggregate tool/status/count telemetry. No wallet or payment required. Original ECB data is free; references are indicative, not executable or accounting/tax certification.

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.

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

ECB reference rates quote currency units per one EUR. Historical coverage starts in 1999 and varies by currency and year. Rates are indicative, not live or executable. No weekend carry-forward or invented rate. format=csv on /v1/fx/history or get_exchange_rate_history returns selected observations as a table with provenance and null flags.

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.