Bizdays

io.github.qinisolabsPublished by GitHub account qinisolabsv0.2.0Updated Oct 24, 2026

Verified business-day math for AI agents: holidays + per-country weekends, not guesses.

VerifiedSTDIODesktop onlyProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Gives an assistant deterministic business-day answers: add or count working days, check if a date is a working day, and look up per-country weekend rules.

What you can do
Provides six tools for calendar math: add_business_days, count_business_days, is_business_day, next_business_day, previous_business_day, and country_rule. Answers come from public-holiday calendars for 206 countries and per-country weekend rules, and each result reports the weekday, the weekend rule and its source, which named holidays were skipped, and a confidence flag. It counts weekends and public holidays only, not regional or optional observances.
When to use it
Useful when an assistant must reason about working days rather than guess: scheduling deadlines, counting working days in a month, or checking whether a given date is a working day in a specific country. Worth adding when answers must account for countries whose weekend is not Saturday and Sunday, or for real public holidays.
Requirements
Runs as a local process over stdio, for example via npx with the npm package @qinisolabs/bizdays. No account, API key, environment variable, or header is declared. Reference data is bundled and the library makes no network calls; a hosted remote endpoint is also described.
Before you install
The README states that a Tier-1 set of about 65 countries is verified while others are flagged unverified, and that where no holiday calendar exists the weekend rule still applies with holidaysApplied false. It counts public holidays only, so company shutdowns or regional days must be supplied by the caller. The README says it collects no data and makes no network calls.

Installation

In SourceWeft

  1. Open Bizdays in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Qiniso]

bizdays

Verified business-day math for AI agents — holidays + per-country weekends, not guesses.

Verified, trustworthy data tools for AI agents. "Qiniso" means "truth" in Zulu.

Website · npm · MCP endpoint · MCP Registry

LLMs answer "what date is 5 business days after Dec 22nd in the UK?", "how many working days are in this month?", and "is Friday a working day in Saudi Arabia?" confidently and often wrongly — they miscount, forget public holidays, and assume every country's weekend is Saturday/Sunday. bizdays gives an agent the deterministic answer from real public-holiday calendars and per-country weekend rules, showing the weekend rule and the exact holidays it skipped.

Two things break naive business-day math, and bizdays fixes both: weekends aren't Sat/Sun everywhere (Fri/Sat in Saudi Arabia, Egypt & Israel; Fri in Iran; Sun in India; Sat/Sun in the UAE since 2022), and "holiday" must mean a real day off — off-the-shelf data counts observances like Valentine's Day and Christmas Eve, which are not days off.

Counting the working days in a month, a frontier LLM with no tools is wrong 63% of the time, cold — and 23% across business-day questions overall. bizdays: 0%.

Add it to Claude

Settings → Connectors → Add custom connector, and paste — no login, no key:

https://bizdays.qinisolabs.workers.dev/mcp

Stateless, reads no user data, requires no secrets. Prefer to run it locally over stdio? Add { "command": "npx", "args": ["-y", "@qinisolabs/bizdays"] } under mcpServers in your client config.

Use it as a library

Every tool is also a typed function — no MCP required:

bash
npm i @qinisolabs/bizdays
ts
import { addBusinessDays, countBusinessDays, isBusinessDay } from "@qinisolabs/bizdays";
addBusinessDays("2025-12-22", 5, "GB").result;       // "2025-12-31" (skips Christmas + Boxing Day)countBusinessDays("2025-12-01", "2025-12-31", "US"); // { businessDays: 22, ... }isBusinessDay("2025-06-13", "SA").isBusinessDay;      // false — Friday is weekend in Saudi ArabiaisBusinessDay("2025-02-14", "US").isBusinessDay;      // true  — Valentine's Day is not a public holiday

Every function returns a rich result: the answer, the weekday, exactly which weekends and named holidays were skipped, the weekend rule and its source, and a confidence flag.

What it does — 6 tools

ToolWhat it answers
add_business_daysWhat date is N working days from a start date? (N may be negative)
count_business_daysHow many working days between two dates? (endpoints inclusive by default)
is_business_dayIs this date a working day? If not, why (weekend / public holiday with its name)?
next_business_dayFirst working day strictly after a date
previous_business_dayLast working day strictly before a date
country_ruleThe weekend rule + its source, whether holidays apply, and a confidence flag

Public holidays for 206 countries (and subdivisions) come from date-holidays, filtered to type: "public". Weekends come from Unicode CLDR via the runtime Intl API, plus a curated data/weekend-overrides.json correction layer (e.g. Bangladesh Fri/Sat, Nepal Sat-only) — the maintained data is the moat.

What it is not

  • Not all-holidays. It counts weekends and public holidays only — not regional or optional observances. Pass company shutdowns or regional days via extraHolidays.
  • Not uniformly verified. A Tier-1 set of ~65 countries is verified; others work but are flagged unverified. Where no holiday calendar exists (e.g. Qatar, Kuwait, Oman), the correct weekend still applies and the response says so (holidaysApplied: false).
  • Not a live service dependency. The library makes no network calls; dates are YYYY-MM-DD in UTC.

Architecture

A single TypeScript package exposing one MCP server over two transports — stdio (local / npx) and a Cloudflare Worker (the hosted edge endpoint) — both driven by the same core.ts tool definitions, which also power the importable library.

bash
npm installnpm run buildnpm test

Privacy

This tool runs locally on your machine and is built not to collect, store, or transmit your data — no analytics, no telemetry, no account. All reference data is bundled — no network calls, and nothing leaves your device. Full policy: https://qinisolabs.github.io/privacy.html.

License

Apache-2.0. Bundled holiday data is from date-holidays (ISC AND CC-BY-3.0); see NOTICE.

Source: README.md at commit 7712d8a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts