# UK Business Calendar

> UK working days, bank holidays, invoice due dates, payroll days and HMRC / Companies House deadlines — for your AI agent.

Remote MCP server (Streamable HTTP): https://uk-business-calendar-mcp.donniertf.workers.dev/mcp
Free tier: `next_bank_holidays` — no key, no sign-up, 30 calls/day per IP.
Pro: £9/month, cancel anytime — all tools, unlimited.

## Tools
- next_bank_holidays (free): FREE. Next 3 UK bank holidays for a nation, plus whether today is a working day.
- working_days (Pro): PRO. Count UK working days between two dates (excludes weekends + bank holidays for the nation).
- due_date (Pro): PRO. Invoice/contract due date: add N working days or N calendar days (rolled to next working day) to a date. Includes Late Payment Act 30-day default.
- tax_deadlines (Pro): PRO. Upcoming HMRC and Companies House deadlines for the next N months; add company_year_end for Corporation Tax, CT600 and accounts dates.
- month_planner (Pro): PRO. For a month: working days count, bank holidays, payday suggestions (last working day / 25th rolled back) and deadlines.

## Buying (agents)
1. POST https://uk-business-calendar-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://uk-business-calendar-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://uk-business-calendar-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://uk-business-calendar-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.02 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://uk-business-calendar-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://uk-business-calendar-mcp.donniertf.workers.dev/pricing.json · Server card: https://uk-business-calendar-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- GOV.UK bank holidays API (England & Wales, Scotland, Northern Ireland) — OGL v3.0
- HMRC / Companies House published filing and payment deadlines (rules encoded)

## Notes
Deadlines are standard rules; your own dates can differ (e.g. VAT stagger, first accounts, extensions). Check GOV.UK/HMRC. Not tax advice.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet