Skip to content

Cross-border business-day planner

$0.003 per callUSDC via x402GET /api/business-day-planner

First dates on or after a start date that are business days in every listed country or region at once (up to 6, e.g. Send GET /api/business-day-planner with the required fields regions and start and pay $0.003 per call over x402 or MPP (there is no free tier). It returns a JSON object with regions, start, count, dates and skipped.

US,GB-ENG,DE-BY,JP), for cross-border scheduling, settlements and meetings, with which region is closed on each skipped day. ?regions=US,GB-ENG,DE-BY&start=2026-12-25. Holiday data by Nager.Date.

Category: Time & schedulingTags: business-days cross-border scheduling holidays planner time

Try in playground →

Parameters

NameTypeRequiredDescription
regionsstringyescomma list of ISO 3166-1 countries or ISO 3166-2 regions, 1 to 6
startstringyesYYYY-MM-DD, first date considered
countintegernohow many common business days to return (1-10, default 1)
basisstring (one of: public, bank)nowhich holidays close business (default public)

Example request

curl -i "https://agent402.tools/api/business-day-planner?regions=US%2CGB-ENG%2CDE-BY&start=2026-12-25&count=2"

Without payment this returns HTTP 402 Payment Required with the exact price for business-day-planner; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestGET /api/business-day-planner
402$0.003 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "regions": [
    "US",
    "GB-ENG",
    "DE-BY"
  ],
  "start": "2026-12-25",
  "count": 2,
  "dates": [
    "2026-12-29",
    "2026-12-30"
  ],
  "skipped": [
    {
      "date": "2026-12-28",
      "closedIn": [
        {
          "region": "GB-ENG",
          "reason": "holiday",
          "name": "St. Stephen's Day",
          "observedFrom": "2026-12-26"
        }
      ]
    }
  ]
}
FieldTypeAlways presentIn the example
regionsarray of stringyes3 items in the example
startstringyes2026-12-25
countnumberyes2
datesarray of stringyes2 items in the example
skippedarray of objectsyes1 item in the example

From an MCP client

catalog.call {
  "slug": "business-day-planner",
  "params": {
    "regions": "US,GB-ENG,DE-BY",
    "start": "2026-12-25",
    "count": 2
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for business-day-planner; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.003" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/business-day-planner?regions=US%2CGB-ENG%2CDE-BY&start=2026-12-25&count=2");

Related tools

Business days by country

$0.002GET /api/country-business-days

Holiday-aware business days for a country or region: check whether a date is a business day, add or subtract N business.

Bank holidays

$0.001GET /api/bank-holidays

Bank holidays for a country and year (optionally one region): the days the holiday dataset tags as bank holidays.

Business days

FREE w/ computeor $0.001POST /api/business-days

Count business days (Mon–Fri) between two dates, inclusive of the start, exclusive of the end.

Long weekends

$0.001GET /api/long-weekends

Long weekends in a country's year, computed from its public holidays: every run of 3 or more consecutive days off that.

Next holidays

$0.001GET /api/next-holidays

Upcoming holidays in a country over the next 365 days, soonest first, optionally narrowed to one region and to holiday.

Public holidays

$0.001GET /api/public-holidays

Public holidays for a country and year from an open public-holiday dataset (keyless, 100+ countries): observed date.