# tilwhen date engine MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/com-tilwhen-tilwhen
- Repository: https://github.com/abmwine/tilwhen
- Website: https://tilwhen.com/mcp

## Install
- Endpoint: https://mcp.tilwhen.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.tilwhen.com/mcp

## Tools
- parse_date_query (Parse a natural-language date question) - 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. Endpoint: https://mcp.tilwhen.com/mcp
- add_days (Add calendar days to a date) - The date N whole calendar days after a date (exclusive counting: the start date is day 0). Endpoint: https://mcp.tilwhen.com/mcp
- subtract_days (Subtract calendar days from a date) - The date N whole calendar days before a date. Endpoint: https://mcp.tilwhen.com/mcp
- days_between (Days between two dates) - Signed whole calendar days from one date to another, midnight to midnight, endpoints exclusive (the gap). Endpoint: https://mcp.tilwhen.com/mcp
- business_days (Business-day calculations) - 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. Optional holiday jurisdiction or custom calendar, and a selectable working week. Endpoint: https://mcp.tilwhen.com/mcp
- invoice_due (Invoice due date from net terms) - 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. Endpoint: https://mcp.tilwhen.com/mcp
- next_occurrence (Next occurrence of an event or weekday) - 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. Endpoint: https://mcp.tilwhen.com/mcp
- holidays (Public holidays for a jurisdiction and year) - 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. Endpoint: https://mcp.tilwhen.com/mcp
- explain (Explain a calculation step by step) - Runs any operation and returns the receipt plus human-readable derivation steps. Accepts the same fields as the other tools, discriminated by op. Endpoint: https://mcp.tilwhen.com/mcp

## Resources
- tilwhen://methodology - How tilwhen counts Counting convention, business-day semantics, and citation guidance MIME type: text/plain
- tilwhen://jurisdictions - Supported holiday jurisdictions Jurisdiction ids, labels, sources, and declared-data coverage MIME type: application/json
- tilwhen://limitations - Known limitations What this server deliberately does not do MIME type: text/plain

## Prompts
Not captured

## Metadata
- Owner: com.tilwhen
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 26, 2026
- Source: https://registry.modelcontextprotocol.io