# Public Holidays & Business Days (200+ countries)

> Public Holidays & Business Days (200+ countries) is a paid MCP server for productivity. Work out deadlines in business days using public holidays for 200+ countries, per call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://business-days-production.up.railway.app
- **Repository:** https://github.com/pcp183/business-days
- **MCP Registry name:** io.github.pcp183/business-days
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-15

## About

One tool, business_days, handles payment, delivery and legal deadlines that depend on local holidays. It lists a year's public holidays for a country and its regions, checks whether a date is a business day, adds or subtracts N business days, or counts business days between two dates, with configurable weekend days.

Holiday rules come from the date-holidays library (ISC code, CC BY 3.0 data) covering 207 countries. The service warns that rules are compiled from public sources and can change by decree, so critical legal deadlines should be verified with the authority.

Each call costs $0.002, settled in USDC on Base through x402. A REST endpoint such as /v1/calendar/business-days takes country, date and add parameters.

## Features

- **Add business days:** Adds or subtracts N business days from a date.
- **Date check:** Tells whether a date is a business day.
- **Range count:** Counts business days between two dates.
- **Holiday lists:** Lists a year's public holidays by country and region.
- **Custom weekends:** Weekend days are configurable.

## Good for

- Compute a payment due date excluding local holidays
- Set a notice period end date
- Count working days between two dates
- List holidays for a country and year

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http business-days https://business-days-production.up.railway.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://business-days-production.up.railway.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "business-days": {
      "url": "https://business-days-production.up.railway.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "business-days": {
      "type": "http",
      "url": "https://business-days-production.up.railway.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "business-days": {
      "serverUrl": "https://business-days-production.up.railway.app/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://business-days-production.up.railway.app/mcp
```

Enter a Name (for example "Public Holidays & Business Days (200+ countries)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "business-days": {
      "type": "http",
      "url": "https://business-days-production.up.railway.app/mcp"
    }
  }
}
```

## Tools

- `business_days`: Computes and checks business days for a country.

## FAQ

### What does it cost?

$0.002 per call, paid in USDC on Base via x402.

### Where do holidays come from?

The date-holidays rule set.

### Can I rely on it for legal deadlines?

The service says rules can change by decree and recommends verifying critical deadlines.

### Is Public Holidays & Business Days (200+ countries) free?

No. Public Holidays & Business Days (200+ countries) is a paid product.

### How do I add Public Holidays & Business Days (200+ countries) to Claude Code?

Run this command in your terminal: claude mcp add --transport http business-days https://business-days-production.up.railway.app/mcp

### What are the best alternatives to Public Holidays & Business Days (200+ countries)?

The closest alternatives to Public Holidays & Business Days (200+ countries) are WorkdayAPI, Business Day Calculator, World Business Calendar, Date Math and Holiday Calendar.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [WorkdayAPI](https://ai-powered.com/mcp/workdayapi): WorkdayAPI is a freemium MCP server for developer tools.
- [Business Day Calculator](https://ai-powered.com/mcp/business-day-calculator): Business Day Calculator is a freemium MCP server for time utilities.
- [World Business Calendar](https://ai-powered.com/mcp/world-business-calendar): World Business Calendar is an open-source MCP server for productivity.
- [Date Math](https://ai-powered.com/mcp/date-math): Date Math is a freemium MCP server for developer tools.
- [Holiday Calendar](https://ai-powered.com/mcp/holiday-calendar): Holiday Calendar is an open-source MCP server for productivity.
- [World Public Holidays](https://ai-powered.com/mcp/world-public-holidays): World Public Holidays is a free MCP server for productivity.
- [Trading Calendar & Public Holidays (x402)](https://ai-powered.com/mcp/trading-calendar-and-public-holidays-x402): Trading Calendar & Public Holidays (x402) is a paid MCP server for finance and payments.
- [SA Business Calendar](https://ai-powered.com/mcp/sa-business-calendar): SA Business Calendar is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/public-holidays-and-business-days-200-countries
