MCP integration documentation

DatoQA — Official Public Holidays

FR/UK/HK government calendars plus international OpenHolidays curated public holidays. Published dates and multilingual names, regional and half-day scope, explicit source kind and gaps. International coverage is incomplete; future dates can change.

5 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/holidays

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

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

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

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.

{
  "region": "gb-england-and-wales",
  "date": "2026-12-28"
}

International calendars

Use list_holiday_regions to inspect actual country/year coverage. Examples: oh-de (Germany), oh-es (Spain), oh-za (South Africa), hk-general (Hong Kong government). International coverage is incomplete. OpenHolidays dates are curated source entries, not individual government confirmations.

Germany 2027: nationwide entries · Download calendar (.ics) · Live coverage

The JSON retains source-language names, inclusive date ranges, regional flags and half-day scope. Optional and bank-only entries from OpenHolidays are excluded. Calendar downloads label regional and half-day entries and do not invent working hours.

Demandez : « Donne les jours fériés nationaux publiés pour l’Allemagne en 2027, leur source et le niveau de confirmation des dates. »

Consulta los festivos publicados para España en 2026, indicando cuáles son nacionales o regionales y citando la fuente.

请查询香港2027年公布的公众假期，注明官方来源和数据获取日期。

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

FR/UK/HK government calendars plus international OpenHolidays curated public holidays. Published dates and multilingual names, regional and half-day scope, explicit source kind and gaps. International coverage is incomplete; future dates can change. Consult /v1/holidays/regions for actual coverage. OpenHolidays-derived data is ODbL 1.0 and freely downloadable at /v1/holidays/openholidays-export. These are not school calendars. No listed holiday does not establish a working day, paid leave or opening hours.

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.