US Federal Holidays and Business Days

io.github.theluckystrike由 GitHub 帳號 theluckystrike 發布v1.0.0更新於 Oct 30, 2026

Exact U.S. federal holidays and business days 1971-2100, OPM and Federal Reserve observance.

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

概覽

AI 產生的概覽

精確計算 1971–2100 年美國聯邦與聯準會假日及工作日，讓助理可靠回答截止日與到期日問題。

可以做什麼
  • 列出某年的假日，含法定日期、OPM 實際放假日期與聯準會休市日期，並標註總統就職日
  • 判斷某日期在 federal 或 fed_banking 行事曆上是否為工作日，並給出前後工作日
  • 在日期上加減 N 個工作日，並列出跳過的假日
  • 計算兩個日期之間的工作日數，規則類似 Excel NETWORKDAYS
  • 依開票日與帳期計算發票到期日，支援 following、preceding、modified_following 順延
適用情境
當截止日、結算日、SLA、薪資或發票到期日取決於週末與美國假日時適用，也適合需要區分 OPM 放假與聯準會銀行營業日差異的情境。
執行需求
遠端 streamable HTTP 端點；不需權杖、登入、API 金鑰或環境變數。README 另提到可供 stdio 用戶端使用的本機 npx 套件。
安裝前請注意
僅做唯讀日期計算，不索取任何憑證。結果只涵蓋美國聯邦與聯準會銀行行事曆：行政命令臨時停班、州假日、股市假日及其他國家假日不在範圍內，需透過 extra_closed_dates 傳入。README 另推廣一個獨立的付費後台工具包。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 US Federal Holidays and Business Days，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "us-federal-holidays-and-business-days": {
      "type": "http",
      "url": "https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

README

US Federal Holidays and Business Days MCP

Exact U.S. federal holidays and business-day math for any date from 1971 to 2100, as an MCP server for Claude, ChatGPT, Cursor and VS Code.

Models often get calendar arithmetic wrong. They forget that New Year's Day 2022 was observed on Friday, December 31, 2021, or that the Federal Reserve stays open on a Friday the government takes off. This server computes those dates exactly, with no network calls.

Hosted endpoint, no token needed:

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

Tools

ToolWhat it does
list_federal_holidaysAll holidays for a year 1971-2100. Legal date, OPM observed date, Federal Reserve closure date, and Inauguration Day flagged as DC-area only.
is_business_daySays if a date is a business day on the federal (OPM) or fed_banking (Federal Reserve) calendar. Names the holiday and gives the previous and next business day.
add_business_daysAdds or subtracts N business days. Lists every holiday it skipped.
count_business_daysCounts business days between two dates. Start and end are included by default, like Excel NETWORKDAYS.
invoice_due_dateDue date from an issue date and net terms (Net 30 = 30 calendar days). Rolls a weekend or holiday due date with following, preceding or modified_following.

Every result has structured JSON, a one-paragraph summary, as_of, source (OPM or Federal Reserve) and more.

What it knows that your model does not

  • The observance rule. A Saturday holiday is observed on Friday by federal employees (5 U.S.C. 6103(b)). A Sunday holiday is observed on Monday (E.O. 11582). The Friday can fall in the previous year.
  • The Federal Reserve rule is different. When a holiday falls on Saturday, Reserve Banks are open on Friday (K.8). So 2026-07-03 is a federal holiday but a banking day. Use calendar: "fed_banking" for ACH, wire and settlement dates.
  • The rule history. Juneteenth from 2021. MLK Day from 1986. Veterans Day was the fourth Monday in October from 1971 to 1977.
  • Inauguration Day. It applies only to DC-area federal employees, every four years. It moves to Monday when January 20 is a Sunday and has no substitute day when it is a Saturday (2029).
  • All 212 holiday rows in OPM's published tables for 2011-2030 match this server's output. A test checks this.

Install

Claude.ai custom connector and ChatGPT developer mode

Paste the hosted URL. No token or sign-in is needed.

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http us-federal-holidays https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

Or run it locally over stdio:

claude mcp add us-federal-holidays -- npx -y us-federal-holidays-business-days-mcp

Claude Desktop

Add this to claude_desktop_config.json:

json
{  "mcpServers": {    "us-federal-holidays": {      "command": "npx",      "args": ["-y", "us-federal-holidays-business-days-mcp"]    }  }}

Cursor

Add this to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "us-federal-holidays": {      "url": "https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp"    }  }}

VS Code

Add this to .vscode/mcp.json:

json
{  "servers": {    "us-federal-holidays": {      "type": "http",      "url": "https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp"    }  }}

Example prompts

  • "Which federal holidays in 2027 are observed on a different day than the legal date?"
  • "Is July 3, 2026 a banking day? Is it a federal holiday?"
  • "What date is 10 business days after December 20, 2027 for a federal agency?"
  • "How many business days are there in November 2026?"
  • "An invoice was issued on June 3, 2026 on Net 30. When is it due if we roll weekends and bank holidays forward?"

Try it with curl

curl -s https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp \  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"is_business_day","arguments":{"date":"2026-07-03","calendar":"fed_banking"}}}'

Data sources

All fetched on 2026-10-30. Details are in DATA_SOURCES.md.

Limitations

  • One-off closures by executive order are not built in. Examples are Christmas Eve closures and national days of mourning such as 2025-01-09. Pass them in extra_closed_dates.
  • The federal calendar is for employees with a Monday to Friday workweek. Other schedules have different in-lieu-of days.
  • The fed_banking calendar applies the K.8 rule to every year. The Fed publishes tables only for recent years. Before 2022 the Juneteenth rule never changed a banking day, because June 19, 2021 was a Saturday.
  • State holidays, stock market holidays and other countries are not covered.
  • Dates are plain calendar days. There are no time zones or cut-off times.

Zovo MCP back-office bundle

Due dates feed the invoice and dunning servers in the paid Zovo MCP back-office bundle. Those servers handle invoices, payment terms and reminders: https://mcp.zovo.one/?utm_source=github&utm_medium=us-federal-holidays-business-days-mcp

Part of the Zovo MCP collection: https://mcp.zovo.one

Development

npm installnpm run buildnpm testnpx wrangler deploy

src/core.ts holds the pure calendar logic. src/stdio.ts is the local entry and src/worker.ts is the Cloudflare Worker entry. Both use the same tool registry in src/tools.ts.

License

MIT

More data servers from the same author

Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.

servertoolshosted URL
cups-to-grams-mcpconvert_ingredient, search_ingredients, scale_recipe, convert_oven_temperaturehttps://cups-to-grams-mcp.lipmichal.workers.dev/mcp
dscr-loan-calculator-mcpcalculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summaryhttps://dscr-loan-calculator-mcp.lipmichal.workers.dev/mcp
gold-price-per-gram-mcpget_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_unitshttps://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp
lake-level-mcpsearch_lakes, get_lake_level, get_lake_history, compare_lakeshttps://lake-level-mcp.lipmichal.workers.dev/mcp
minimum-wage-mcpget_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wagehttps://minimum-wage-mcp.lipmichal.workers.dev/mcp
no-tax-on-overtime-mcpcalculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibilityhttps://no-tax-on-overtime-mcp.lipmichal.workers.dev/mcp
paycheck-calculator-mcpcalculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_bracketshttps://paycheck-calculator-mcp.lipmichal.workers.dev/mcp
uk-income-tax-salary-mcpcalculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_incomehttps://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp
ab-test-sample-size-calculator-mcpcalculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_riskhttps://ab-test-sample-size-calculator-mcp.lipmichal.workers.dev/mcp
aca-premium-tax-credit-calculator-mcpget_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_caphttps://aca-premium-tax-credit-calculator-mcp.lipmichal.workers.dev/mcp
ap-score-distributions-mcpget_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_compositehttps://ap-score-distributions-mcp.lipmichal.workers.dev/mcp
car-loan-interest-deduction-calculator-mcpcalculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credithttps://car-loan-interest-deduction-calculator-mcp.lipmichal.workers.dev/mcp
estate-gift-tax-exemption-calculator-mcpget_exemption_amounts, calculate_estate_tax, check_gift, compare_yearshttps://estate-gift-tax-exemption-calculator-mcp.lipmichal.workers.dev/mcp
recipe-nutrition-calculator-mcplookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutritionhttps://recipe-nutrition-calculator-mcp.lipmichal.workers.dev/mcp
retirement-contribution-limits-2027-mcpget_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_yearshttps://retirement-contribution-limits-2027-mcp.lipmichal.workers.dev/mcp
section-179-deduction-calculator-mcpcalculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_paymenthttps://section-179-deduction-calculator-mcp.lipmichal.workers.dev/mcp
student-loan-repayment-assistance-plan-calculator-mcpcalculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dateshttps://student-loan-repayment-assistance-plan-calculator-mcp.lipmichal.workers.dev/mcp
subdomain-finder-mcpfind_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surfacehttps://subdomain-finder-mcp.lipmichal.workers.dev/mcp
uk-statutory-sick-pay-maternity-pay-calculator-mcpcalculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibilityhttps://uk-statutory-sick-pay-maternity-pay-calculator-mcp.lipmichal.workers.dev/mcp

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one

來源：README.md，提交 6c30a63

工具

5

list_federal_holidays

List U.S. federal holidays for a year

Exact U.S. federal holidays for any year 1971-2100 under 5 U.S.C. 6103: legal date, OPM observed date (Saturday -> Friday, Sunday -> Monday, so New Year's Day 2022 is observed Friday 2021-12-31) and the Federal Reserve closure date (Fed Banks stay OPEN the Friday before a Saturday holiday). Applies the rule history a model tends to get wrong: Juneteenth from 2021, MLK Day from 1986, Veterans Day on the 4th Monday of October 1971-1977, and Inauguration Day (DC area only, flagged optional). No network calls.

輸入參數year必填

is_business_day

Check if a date is a U.S. business day

Says whether a date (1971-2100) is a business day on the U.S. federal (OPM) calendar or the Federal Reserve banking calendar, names the holiday if any, and returns the previous and next business day. The two calendars differ when a holiday falls on Saturday: 2026-07-03 is a federal holiday but a Fed banking day.

輸入參數date必填calendarextra_closed_datesinclude_inauguration_day

add_business_days

Add or subtract U.S. business days

Adds (or with a negative number subtracts) N business days to a date, skipping weekends and observed U.S. federal or Federal Reserve holidays exactly. The start date is not counted. With 0, returns the start date if it is a business day, otherwise the next one. Lists every holiday skipped.

輸入參數calendarstart_date必填business_days必填extra_closed_datesinclude_inauguration_day

count_business_days

Count U.S. business days between two dates

Counts business days between two dates (1971-2100) on the U.S. federal or Federal Reserve calendar, excluding weekends and observed holidays. include_start and include_end default to true, like Excel NETWORKDAYS. If end is before start the count is negative. Lists the weekday holidays that were excluded.

輸入參數calendarend_date必填start_date必填include_endinclude_startextra_closed_datesinclude_inauguration_day

invoice_due_date

Invoice due date from net terms

Computes an invoice due date from an issue date and net terms in calendar days (Net 30 = 30), then optionally rolls a weekend or U.S. holiday due date: following (next business day), preceding, or modified_following (next business day unless it crosses into the next month). Uses exact observed federal or Federal Reserve holidays.

輸入參數rollcalendarnet_days必填issue_date必填extra_closed_dates

版本歷史

1
  1. v1.0.0最新Oct 30, 2026

評分

已滿足適用檢查項的 100%

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

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