DatoQA — Official Public Holidays

Government and OpenHolidays calendars: regional scope, multilingual names, dated sources and gaps.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
82%
Naming quality
96%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,143Tokens (tool definitions)
~6.4 KBTypical response size
Significant attention impact (2.46% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "official-public-holidays": {
      "url": "https://datoqa.bhazarstudio.workers.dev/mcp/holidays"
    }
  }
}

Remote endpoints

https://datoqa.bhazarstudio.workers.dev/mcp/holidaysstreamable-http

What it can do

Tool inventory

Tools (5)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢catalog(report_countries, report_indicators, report_from, report_to, language)

Inspect this connection’s scope, tools and access policy. With no arguments returns the usual catalog. On the general or economy connection, optionally supply report_countries (1–10 World Bank codes) for a FREE live preview of the optional paid country comparison: population/GDP/inflation by default, or up to six selected historical indicators over ten years, aligned JSON and CSV, definitions and source evidence. Preview reports price, missing cells, availability and the exact HTTP purchase path; it never signs or pays. Existing data tools remain free. Buying requires an authorized x402 HTTP client, not just MCP. Source/schema checks are not independent factual verification.

Input Schema

{
  "type": "object",
  "properties": {
    "report_countries": {
      "description": "Optional free preview for these distinct World Bank country codes, e.g. FRA, DEU, ESP. General/economy connections only.",
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{3}$"
      }
    },
    "report_indicators": {
      "description": "Custom historical comparison: select up to six of the 22 WDI indicators. Supply report_from and report_to together, up to ten years. Missing cells block payment.",
      "minItems": 1,
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "population",
          "gdp",
          "gdp_per_capita",
          "gdp_real",
          "gdp_growth",
          "inflation",
          "life_expectancy",
          "fertility",
          "urban_population",
          "internet_users",
          "electricity_access",
          "unemployment",
          "renewable_energy",
          "forest_area",
          "agricultural_land",
          "trade",
          "exports",
          "imports",
          "infant_mortality",
          "basic_drinking_water",
          "basic_sanitation",
          "primary_completion"
        ]
      }
    },
    "report_from": {
      "type": "integer",
      "minimum": 1960,
      "maximum": 9007199254740991
    },
    "report_to": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 2025
    },
    "language": {
      "default": "en",
      "type": "string",
      "enum": [
        "en",
        "fr"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "const": "DatoQA"
    },
    "version": {
      "type": "string"
    },
    "available_records": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "title": {
      "type": "string"
    },
    "profile": {
      "type": "string"
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "independently_verified": {
      "type": "boolean",
      "const": false,
      "description": "Official-source checks are not independent factual corroboration."
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {},
  "description": "General availability catalog or a scoped thematic directory; theme metadata is not a live availability guarantee."
}
🟢list_holiday_regions

Discover available public-holiday calendars and exact region ids, published years, source kind and freshness. Includes FR/UK/HK government feeds and international OpenHolidays curated entries. Use when country/region/year coverage is unknown; otherwise call get_public_holidays directly. Configured calendars are not proof of available data. International coverage is incomplete.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string"
    },
    "regions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "country_code": {
            "type": "string"
          },
          "years": {
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          },
          "source_event_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "retrieved_at": {
            "type": "string"
          },
          "expires_at": {
            "type": "string"
          },
          "source_kind": {
            "type": "string"
          },
          "date_confirmation": {
            "type": "string"
          }
        },
        "required": [
          "region",
          "name",
          "country_code",
          "years",
          "source_event_count",
          "retrieved_at",
          "expires_at"
        ],
        "additionalProperties": false
      }
    },
    "configured_regions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "region",
          "name"
        ],
        "additionalProperties": false
      }
    },
    "region_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "source_event_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "count_meaning": {
      "type": "string"
    },
    "refresh_interval_seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "max_collection_age_seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "notice": {
      "type": "string"
    },
    "independently_verified": {
      "type": "boolean",
      "const": false,
      "description": "Official-source checks are not independent factual corroboration."
    }
  },
  "required": [
    "endpoint",
    "regions",
    "configured_regions",
    "region_count",
    "source_event_count",
    "count_meaning",
    "refresh_interval_seconds",
    "max_collection_age_seconds",
    "notice",
    "independently_verified"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_public_holidays(region, nationwide_only, year, date)

Get published public-holiday entries for one calendar and year or exact inclusive local date. Use a known region id directly (fr-metropole, gb-england-and-wales, hk-general, oh-de); consult list_holiday_regions only if scope is unknown. OpenHolidays entries retain multilingual names, subdivisions and half-day scope; set nationwide_only=true to exclude regional entries. Government feeds and third-party curated calendars are explicitly distinguished. Empty results do not establish working days; future dates can change, and aggregator dates are not individually government-confirmed.

Input Schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "enum": [
        "fr-metropole",
        "fr-alsace-moselle",
        "fr-guadeloupe",
        "fr-guyane",
        "fr-la-reunion",
        "fr-martinique",
        "fr-mayotte",
        "fr-nouvelle-caledonie",
        "fr-polynesie-francaise",
        "fr-saint-barthelemy",
        "fr-saint-martin",
        "fr-saint-pierre-et-miquelon",
        "fr-wallis-et-futuna",
        "gb-england-and-wales",
        "gb-scotland",
        "gb-northern-ireland",
        "hk-general",
        "oh-ad",
        "oh-al",
        "oh-at",
        "oh-be",
        "oh-bg",
        "oh-br",
        "oh-by",
        "oh-ch",
        "oh-cz",
        "oh-de",
        "oh-ee",
        "oh-es",
        "oh-fr",
        "oh-hr",
        "oh-hu",
        "oh-ie",
        "oh-it",
        "oh-li",
        "oh-lt",
        "oh-lu",
        "oh-lv",
        "oh-mc",
        "oh-md",
        "oh-mt",
        "oh-mx",
        "oh-nl",
        "oh-pl",
        "oh-pt",
        "oh-ro",
        "oh-rs",
        "oh-se",
        "oh-si",
        "oh-sk",
        "oh-sm",
        "oh-va",
        "oh-za"
      ],
      "description": "Calendar identifier from list_holiday_regions, for example gb-england-and-wales."
    },
    "nationwide_only": {
      "description": "For OpenHolidays country calendars, keep only entries marked nationwide by the source. Default false includes regional entries with their scopes. Government calendars retain their named territory scope.",
      "type": "boolean"
    },
    "year": {
      "description": "Calendar year; defaults to the current year. Only published years are available. Omit when date is supplied.",
      "type": "integer",
      "minimum": 2000,
      "maximum": 2032
    },
    "date": {
      "description": "Exact local calendar date YYYY-MM-DD, for example 2026-12-28; cannot be combined with year.",
      "type": "string"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "source_unavailable_or_stale",
        "year_not_covered",
        "holidays_listed",
        "no_holiday_listed_for_date"
      ],
      "description": "Read this before using values; a successful transport does not establish data availability."
    },
    "returned": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Domain-specific result count, not necessarily the number of stored records in items."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {},
            "description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
          },
          "freshness": {
            "type": "object",
            "properties": {
              "observed_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "age_seconds": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "meaning": {
                "type": "string"
              }
            },
            "required": [
              "observed_at",
              "expires_at",
              "age_seconds",
              "meaning"
            ],
            "additionalProperties": false
          },
          "citation": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "publisher": {
                "type": "string"
              },
              "retrieved_at": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "publisher",
              "retrieved_at"
            ],
            "additionalProperties": false
          },
          "provenance": {
            "type": "object",
            "properties": {
              "source_id": {
                "type": "string"
              },
              "source_name": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              },
              "license": {
                "type": "string"
              },
              "retrieved_at": {
                "type": "string"
              },
              "verified_at": {
                "type": "string"
              },
              "valid_until": {
                "type": "string"
              },
              "verification_method": {
                "type": "string"
              },
              "content_sha256": {
                "type": "string"
              },
              "verification_level": {
                "type": "string",
                "enum": [
                  "official_source_and_schema_checked",
                  "public_aggregator_and_schema_checked",
                  "method_specific"
                ]
              },
              "independently_verified": {
                "type": "boolean",
                "const": false,
                "description": "Official-source checks are not independent factual corroboration."
              },
              "verification_scope": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "source_id",
              "source_name",
              "source_url",
              "license",
              "retrieved_at",
              "verified_at",
              "valid_until",
              "verification_method",
              "content_sha256",
              "verification_level",
              "independently_verified",
              "verification_scope"
            ],
            "additionalProperties": false
          },
          "display_label": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "domain",
          "data",
          "freshness",
          "citation",
          "provenance"
        ],
        "additionalProperties": {}
      }
    },
    "independently_verified": {
      "type": "boolean",
      "const": false,
      "description": "Official-source checks are not independent factual corroboration."
    },
    "notice": {
      "type": "string"
    },
    "directory": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "year": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "requested_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "available_years": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    }
  },
  "required": [
    "status",
    "returned",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_record(id)

Get an unexpired record with provenance and its explicit verification level. Source/schema validation is not independent factual verification.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "Opaque record id returned by a DatoQA data response. Reuse it exactly; do not invent an id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Source-specific payload; inspect units, observation dates, nulls and source notes."
    },
    "freshness": {
      "type": "object",
      "properties": {
        "observed_at": {
          "type": "string"
        },
        "expires_at": {
          "type": "string"
        },
        "age_seconds": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "meaning": {
          "type": "string"
        }
      },
      "required": [
        "observed_at",
        "expires_at",
        "age_seconds",
        "meaning"
      ],
      "additionalProperties": false
    },
    "citation": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "publisher": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        }
      },
      "required": [
        "url",
        "publisher",
        "retrieved_at"
      ],
      "additionalProperties": false
    },
    "provenance": {
      "type": "object",
      "properties": {
        "source_id": {
          "type": "string"
        },
        "source_name": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        },
        "verified_at": {
          "type": "string"
        },
        "valid_until": {
          "type": "string"
        },
        "verification_method": {
          "type": "string"
        },
        "content_sha256": {
          "type": "string"
        },
        "verification_level": {
          "type": "string",
          "enum": [
            "official_source_and_schema_checked",
            "public_aggregator_and_schema_checked",
            "method_specific"
          ]
        },
        "independently_verified": {
          "type": "boolean",
          "const": false,
          "description": "Official-source checks are not independent factual corroboration."
        },
        "verification_scope": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "source_id",
        "source_name",
        "source_url",
        "license",
        "retrieved_at",
        "verified_at",
        "valid_until",
        "verification_method",
        "content_sha256",
        "verification_level",
        "independently_verified",
        "verification_scope"
      ],
      "additionalProperties": false
    },
    "display_label": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "domain",
    "data",
    "freshness",
    "citation",
    "provenance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}
🟢get_evidence(id)

Retrieve the source JSON snapshot and SHA-256 digest for a currently available record. The digest proves snapshot integrity, not factual truth.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "Record id returned by a DatoQA data response; returns the retained source snapshot for that record."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string"
    },
    "sha256": {
      "type": "string"
    },
    "hash_scope": {
      "type": "string",
      "const": "utf8_source_payload_json"
    },
    "source_payload_json": {
      "type": "string"
    },
    "first_observed_at": {
      "type": "string"
    },
    "source_url": {
      "type": "string"
    },
    "notice": {
      "type": "string"
    }
  },
  "required": [
    "record_id",
    "sha256",
    "hash_scope",
    "source_payload_json",
    "first_observed_at",
    "source_url",
    "notice"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools