MCP server

tilwhen date engine Official

com.tilwhen/tilwhen

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Deterministic date arithmetic with auditable receipts: business days, due dates, holidays.

Website

At a glance

Type

MCP server

Publisher

tilwhen.com (verified by the MCP Registry)

Status

Working at last check

Tools

9

Token cost

About 3,100 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http tilwhen https://mcp.tilwhen.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.tilwhen]
url = "https://mcp.tilwhen.com/mcp"

Gemini CLI

{"mcpServers":{"tilwhen":{"httpUrl":"https://mcp.tilwhen.com/mcp"}}}

Cursor

{"mcpServers":{"tilwhen":{"url":"https://mcp.tilwhen.com/mcp"}}}

VS Code

{"servers":{"tilwhen":{"type":"http","url":"https://mcp.tilwhen.com/mcp"}}}

Antigravity

agy mcp add tilwhen https://mcp.tilwhen.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"tilwhen","server_url":"https://mcp.tilwhen.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"tilwhen","server_url":"https://mcp.tilwhen.com/mcp"}

Tools

• add_days ~233 tokens
  The date N whole calendar days after a date (exclusive counting: the start date is day 0). Omit date for today in tz. For working days use business_days; for the gap between two dates use days_between.
• business_days ~518 tokens
  Span mode (from+to): business days between two dates, exclusive of the start day, inclusive of the end day. Add mode (days, optional date): the date N business days away. Passing from or to selects span mode and needs both; days and date are then ignored, so add mode takes its start date in date, no
• days_between ~282 tokens
  Signed whole calendar days from the from date to the to date, midnight to midnight in tz: positive when to is later, negative when it is earlier. Endpoints are exclusive, so this is the gap and consecutive dates are 1 apart. Either date may be "today", resolved in tz. For working days between two da
• explain ~735 tokens
  Runs any operation and returns the receipt plus human-readable derivation steps. Set op, then pass the fields that operation's own tool takes. Use it when the user asks how an answer was reached.
• holidays ~196 tokens
  Observed public holidays with the nominal (legal) date and status: rule (statutory) or declared (officially declared for that year). Declared-only holidays are omitted for undeclared years, with a holiday_data_incomplete warning.
• invoice_due ~404 tokens
  Due date for Net-N payment terms (calendar days, invoice date = day 0). Optional roll-forward past weekends and, with a jurisdiction or custom calendar, public holidays.
• next_occurrence ~255 tokens
  The next occurrence strictly after the base date (default today) of either a tracked event slug (e.g. "christmas") or a weekday (0 = Sunday .. 6 = Saturday). Provide exactly one of event/weekday.
• parse_date_query ~241 tokens
  Parses queries like "90 business days from today in uganda" into a normalized operation, answers it, and returns the auditable receipt. Ambiguous dates (03/04/2027) return needsClarification instead of a guess.
• subtract_days ~236 tokens
  The date N whole calendar days before a date (exclusive counting: the start date is day 0). Omit date for today in tz. For working days use business_days; for the gap between two dates use days_between.

Browse

• Calendars
• Payments
• Invoicing and accounting
• Legal research

Related MCP servers

• BuddyLists
  Agent-only social network and labor market: presence, buddy lists, jobs with escrowed settlement.
• Mart402 Extract
  Web extraction, OCR (Japanese-strong), invoice and company data for AI agents. x402, no API key.
• Coolant
  Instruments for what a model cannot know on its own: time, randomness, DNS, hashes, receipts.
• Agentstack
  Deterministic reasoning stack for AI agents: simulate, decide & compute, plus cross-domain tools.
• Japan Business Day
  Japan business days & holidays (official Cabinet Office data). Free tool + x402 USDC paid tools.
• Magist
  Deterministic, cited regulatory research for product launches; legal information, not legal advice.
• Precisioncalc
  High-precision finance & business calculations for AI agents — exact decimals, never floats.
• ccpcrate — Canadian CCPC corporate tax
  Deterministic Canadian CCPC rate stack: small business deduction and grinds, Part IV, RDTOH.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.tilwhen/tilwhen.svg)](https://aptlynx.net/servers/com.tilwhen/tilwhen)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents