How does the tool handle different weekend structures?

The tool automatically applies regional rules based on the `countryCode`. For example, it uses a Saturday-Sunday pattern for the US and a Friday-Saturday pattern for many Middle Eastern countries.

Can I add my own holidays to the calculation?

Yes, you can provide a JSON array of ISO date strings in the `customHolidaysJson` parameter to treat specific dates as non-working days.

What happens if I provide an invalid country code?

If the `countryCode` is unrecognized, the tool will return an error message describing the failure.

Business Day Calculator MCP Connector for Claude

A+

Calculate workdays, holidays, and business day ranges across 50+ countries.

5 tools Official Updated Oct 1, 2026 Official Vinkius Partner

More Details Connect to Claude

The Business Day Calculator MCP connects AI agents to a high-precision utility for global workforce planning. It allows you to perform complex date arithmetic by skipping weekends and public holidays across 50+ countries. Use add_business_days to project deadlines, subtract_business_days to calculate past work periods, or count_business_days to determine the exact number of working days between two dates. The tool supports diverse weekend structures like the Middle East's Friday-Saturday pattern and allows for custom holiday overrides via JSON input.

date-calculationbusiness-daysholidaysglobal-calendarworkday-planner

Connect to Claude

Subscribe on Vinkius, then add this connector to Claude.ai or Claude Code.

① Claude.ai (web app)

Go to Settings → Connectors → Add custom connector
Paste the MCP endpoint URL below

https://edge.vinkius.com/vk_preview_FK0N2YSyXRAHUmFmMKKcPOwzacRT18rbYpSFwJdm/mcp

② Claude Code (terminal)

claude mcp add --transport http business-day-calculator https://edge.vinkius.com/vk_preview_FK0N2YSyXRAHUmFmMKKcPOwzacRT18rbYpSFwJdm/mcp

③ Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "business-day-calculator": {
      "url": "https://edge.vinkius.com/vk_preview_FK0N2YSyXRAHUmFmMKKcPOwzacRT18rbYpSFwJdm/mcp"
    }
  }
}

Get full access on Vinkius

The preview token above works for testing. Powered by Vinkius.

Details

Tools: 5
Grade: A+
Score: 100/100
Updated: Oct 1, 2026

Related Connectors

US Filing Deadline Calculator MCP

3 tools Official

Calculate US federal court filing deadlines with automatic weekend and holiday adjustments.

A+ View details →

Deterministic Datetime Engine MCP

3 tools Official

Equip your AI with exact temporal math. Deterministically calculate date differences, leap years, and add business days (skipping weekends) 100% locally.

A+ View details →

Time Difference Calculator MCP

3 tools Official

Calculate exact duration between two clock times, handling midnight transitions.

A+ View details →

Timezone Offset Engine MCP

1 tools Official

Calculate the exact offset between two timezones at any moment, with full DST awareness. Powered by Luxon.

A+ View details →