Koskamo

Faceabot Public holidays MCP

Provides public holidays for about 200 countries, including national and regional holidays, next holidays, and checking if a specific date is a holiday. It is a free, remote MCP server with no API key required, operated directly by Faceabot.

Visit Faceabot

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Faceabot Public holidays MCP logo, by FaceabotVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Faceabot
MCP endpoint (Streamable HTTP)
https://faceabot.com/tools-mcp/holidays
Vendor documentation

What you can do with it

  • Check if a specific date is a public holiday
  • Get next upcoming holidays for a country
  • Retrieve national and regional holidays for any year

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: com.faceabot/public-holidays@1.0.0Project website

Protocol and capabilities

Server
faceabot-public-holidays 1.0.0
MCP protocol
2025-06-18
Tools
3 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Faceabot Public Holidays: official public holidays of about 200 countries, free, no key. public_holidays {"country":"DE","year":2027} · next_public_holidays {"country":"JP"} · is_public_holiday {"country":"BE","date":"2026-11-11"}. Data: Nager.Date (open source); for legal or payroll decisions, check the government's calendar. Part of Faceabot (https://faceabot.com): any other tool: solve_need at https://faceabot.com/api/mcp.

Tools

3 advertised

public_holidays — Public holidays of a country for a year
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Lists the official public holidays of a country for a year (about 200 countries): date, English and local name, nationwide or only some regions. Bank-only holidays are left out unless asked. Use when: "public holidays in Germany 2027", "jours fériés en Belgique", planning deliveries or meetings. Example: {"country":"DE","year":2027}

public_holidays input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2075,
      "minimum": 1975,
      "description": "Year (default: this year)"
    },
    "country": {
      "type": "string",
      "examples": [
        "DE"
      ],
      "description": "Country: 2-letter code (DE, JP, BR…) or name in English, French, German, Spanish, Italian, Dutch or Portuguese"
    },
    "include_bank_holidays": {
      "type": "boolean",
      "default": false,
      "description": "Also list bank-only and optional holidays"
    }
  },
  "additionalProperties": false
}
public_holidays annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
next_public_holidays — Next public holidays of a country
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

The next public holidays of a country from today, with how many days away. Use when: "when is the next holiday in Japan?", "next long weekend in France". Example: {"country":"Japan","limit":3}

next_public_holidays input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1
    },
    "country": {
      "type": "string",
      "examples": [
        "JP"
      ],
      "description": "Country code or name"
    }
  },
  "additionalProperties": false
}
next_public_holidays annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
is_public_holiday — Is this date a public holiday?
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Says whether a date is a public holiday in a country (and whether nationwide or regional), with the holiday's name. Use when: deciding if offices, banks or schools are closed on a given day. Example: {"country":"BE","date":"2026-11-11"}

is_public_holiday input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date YYYY-MM-DD (default: today, UTC)"
    },
    "country": {
      "type": "string",
      "examples": [
        "BE"
      ],
      "description": "Country code or name"
    }
  },
  "additionalProperties": false
}
is_public_holiday annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
264 ms
95th percentile latency
264 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 264 ms · metadata changed · 3 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http faceabot-public-holidays-mcp https://faceabot.com/tools-mcp/holidays

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add faceabot-public-holidays-mcp --url https://faceabot.com/tools-mcp/holidays

Cursor

Merge this server into .cursor/mcp.json in your project, then enable faceabot-public-holidays-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "faceabot-public-holidays-mcp": {
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "faceabot-public-holidays-mcp": {
      "type": "streamableHttp",
      "url": "https://faceabot.com/tools-mcp/holidays",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start faceabot-public-holidays-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "faceabot-public-holidays-mcp": {
      "type": "http",
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http faceabot-public-holidays-mcp https://faceabot.com/tools-mcp/holidays

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "faceabot-public-holidays-mcp": {
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "faceabot-public-holidays-mcp": {
      "serverUrl": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

Let your agent find its tools

Find servers like Faceabot Public holidays MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,448

Do you run Faceabot Public holidays MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing