tilwhen date engine

com.tilwhen由 tilwhen.com 發布官方發布者v1.0.1更新於 Nov 8, 2026

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

已驗證Streamable HTTP可網頁執行效率與工作流金融

概覽

AI 產生的概覽

一個遠端日期運算伺服器,讓助理計算工作日、到期日、假日與日期間隔,並提供可稽核的憑據。

可以做什麼
將自然語言日期查詢解析為正規化操作並作答,遇到歧義日期時要求釐清而非猜測。以整日加減日期,或計算兩個日期之間帶正負號的間隔。計算兩個日期之間的工作日,或求出 N 個工作日之後的日期。計算 Net-N 帳期發票的到期日,可選擇順延跳過週末與國定假日。查詢某個追蹤事件或星期幾的下一次出現,並列出帶法定日期與狀態的已觀測國定假日。對任一操作提供人類可讀的推導步驟。
適用情境
適合需要精確且可解釋答案的情境:付款到期日、以工作日計算的截止期限、需避開假日的排程,或使用者可能追問結果如何得出的日期問題。
執行需求
遠端 streamable HTTP 端點;未宣告任何套件、帳號、API 金鑰或環境變數。
安裝前請注意
假日結果取決於司法管轄區與年份;未公布年份的僅公告假日會被省略,並附上 holiday_data_incomplete 警告。歧義日期會回傳 needsClarification 而非答案,需確認預期格式。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 tilwhen date engine,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.tilwhen%2Ftilwhen/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tilwhen-date-engine": {
      "type": "http",
      "url": "https://mcp.tilwhen.com/mcp"
    }
  }
}

README

該儲存庫沒有 README。

工具

9

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.

輸入參數q必填tzlocale

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). Omit date for today in tz. For working days use business_days; for the gap between two dates use days_between.

輸入參數tzdatedays必填

subtract_days

Subtract calendar days from a date

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.

輸入參數tzdatedays必填

days_between

Days between two dates

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 dates use business_days; to move a date by N days use add_days or subtract_days.

輸入參數to必填tzfrom必填

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. 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, not from. Optional holiday jurisdiction or custom calendar, and a selectable working week. For calendar days use add_days, subtract_days or days_between.

輸入參數totzdatedaysfromworkweekjurisdictioncustomHolidays

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.

輸入參數tznet必填rollworkweekinvoiceDatejurisdictioncustomHolidays

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.

輸入參數tzfromeventweekday

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.

輸入參數year必填jurisdiction必填

explain

Explain a calculation step by step

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.

輸入參數op必填totznetdatedaysfromrollyeareventweekdayworkweek另有 3 個

版本歷史

2
  1. v1.0.1最新Sep 18, 2026
  2. v1.0.0Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。