Locale brief
"Can I reach this counterparty this week?" — country facts, this year's public holidays, working days remaining this week, and what time it is there right now, in one call.
When to use this pack
An agent scheduling outreach, deliveries, or meetings across borders needs the practical local picture: currency and languages, whether a public holiday lands this week, how many business days are left, and the current local time.
Tools in this pack
- Country info $0.002 GET /api/country-info Country facts by name or ISO code: official name, capital, region, currencies, languages, timezones, dialing code, TLD, and more. Committed open dataset (world-countries, ODbL, plus the IANA timezone country map) — offline and deterministic. ?name=Japan or ?code=JP
- Public holidays $0.002 GET /api/public-holidays Public holidays for a country and year via Nager.Date (keyless, 100+ countries): date, local name, English name, nationwide flag, and holiday types. Pairs with /api/business-days and /api/country-info. ?country=US&year=2026
- Business days $0.001 POST /api/business-days Count business days (Mon–Fri) between two dates, inclusive of the start, exclusive of the end. Optional list of holiday dates to skip.
- Timezone convert $0.001 GET /api/timezone-convert Convert a datetime from one IANA timezone to another. Accepts ISO 8601, Unix timestamps (seconds or milliseconds), or natural date strings. Returns the converted time in both timezones with UTC offset. ?datetime=2026-06-23T14:00:00&from=America/New_York&to=Asia/Tokyo.
Workflow
- Get the country facts from country-info — capital, currency, languages, calling code, and timezones.
- Pull this year's public holidays with public-holidays (keyed off the country code from step 1) and check which land in the next 7 days.
- Count the working days in the coming week with business-days.
- Convert the current UTC time into the country's primary timezone with timezone-convert — is it business hours there right now?
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Tell me whether I can realistically reach a counterparty in Japan this week, using Agent402's locale-brief skill pack. (1) Get the country facts (currency, languages, timezone), (2) pull this year's public holidays and flag any in the next 7 days, (3) count the business days remaining this week, (4) convert the current time to the local timezone. Answer: local time now, holidays in the window, working days available, and the best contact window in my timezone.