mcpField
A
AU Agent Utilities

AU Agent Utilities

Remote
github.com/creatorhub121Productivity1Updated 6w ago
Repository

About AU Agent Utilities

AU Agent Utilities provides deterministic Australian business-day and deadline calculations for AI agents. Its first module handles weekends, public holidays, and substitute holidays across states and territories.

Key features

  1. 01Check business days and adjacent dates
  2. 02Add or subtract business days
  3. 03Count business and non-business days
  4. 04Calculate and roll deadlines
  5. 05Support all Australian states and territories

Use cases

  1. 01Check whether a date is a business day
  2. 02Calculate a deadline across public holidays
  3. 03Count business days within a date range

MCP support

Exposes four date-calculation tools through a public MCP server using Streamable HTTP. The remote endpoint requires no authentication.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://au-business-day.auagentutilities.workers.dev/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

4
ParameterTypeRequiredDescription
datestringYesDate in YYYY-MM-DD format
stateenumYesAustralian state or territoryACT | NSW | NT | QLD | SA | TAS | VIC | WA

Details

From the project README

AU Agent Utilities

Reliable Australian utility tools for AI agents.

The first module is the Australian Business Day Engine — deterministic business-day, public-holiday and deadline calculations across all Australian states and territories.

Instead of asking an AI model to guess whether a date is a business day, the agent can call a tool and get a structured answer.

Connect to the live MCP

Transport: Streamable HTTP
Authentication: None required
Live endpoint:

https://au-business-day.auagentutilities.workers.dev/mcp

No local installation or API key is required.

Try it now

The server is publicly available through Glama, where you can inspect the available tools and test the MCP.

Glama: Try AU Agent Utilities on Glama

Connect with Cursor

Add the following to your Cursor mcp.json:

{
  "mcpServers": {
    "au-agent-utilities": {
      "url": "https://au-business-day.auagentutilities.workers.dev/mcp"
    }
  }
}

Cursor supports remote MCP servers over Streamable HTTP.

Connect with VS Code

Add the server to your MCP configuration:

{
  "servers": {
    "au-agent-utilities": {
      "type": "http",
      "url": "https://au-business-day.auagentutilities.workers.dev/mcp"
    }
  }
}

Other MCP clients

Any MCP client that supports remote Streamable HTTP servers can connect to:

https://au-business-day.auagentutilities.workers.dev/mcp

Try these prompts

Once connected, try asking your agent:

Is 27 December 2021 a business day in NSW? If not, give me the previous and next business day.

What is 5 Victorian business days after 24 December 2026?

Count the business days between 1 December and 31 December 2026 in Queensland.

Calculate a NSW deadline 7 calendar days after 20 December 2021 and roll it to the next business day if necessary.

Available tools

ToolWhat it does
check_australian_business_dayChecks whether a date is an Australian business day and returns the previous and next business day
calculate_australian_business_dateAdds or subtracts business days
count_australian_business_daysCounts business days between two dates with explicit boundary rules
calculate_australian_deadlineCalculates calendar or business-day deadlines and optionally rolls non-business dates

Australian jurisdictions

Supports:

ACT · NSW · NT · QLD · SA · TAS · VIC · WA

Handles weekends, state and territory public holidays, and applicable substitute holidays represented in the underlying holiday dataset.

Local, regional and industry-specific holidays are not guaranteed unless they are represented in the relevant jurisdiction dataset.

Available Tools

check_australian_business_day

Checks whether a date is a business day in an Australian state or territory.

Returns:

  • whether the date is a business day
  • weekend or public-holiday reason
  • holiday name where applicable
  • previous business day
  • next business day

Example:

Date: 2021-12-27
State: NSW

Result:

Business day: false
Reason: public_holiday
Holiday: Christmas Day (substitute day)
Next business day: 2021-12-29

calculate_australian_business_date

Adds or subtracts Australian business days from a starting date.

Positive numbers move forward and negative numbers move backward.

The start date is excluded by default.

Example:

Start date: 2021-12-24
State: NSW
Business days: 1

Result:

2021-12-29

The calculation skips weekends and applicable public holidays, including substitute public holidays.


count_australian_business_days

Counts business days between two Australian calendar dates.

Boundary inclusion is explicit so agents do not have to guess whether the start or end date should be counted.

The result can include:

  • business days
  • non-business days
  • weekend days
  • public-holiday weekdays
  • holidays encountered

Example:

Start date: 2021-12-24
End date: 2021-12-29
State: NSW
Include start: false
Include end: true

Result:

Business days: 1

calculate_australian_deadline

Calculates an Australian deadline using either calendar days or business days.

Supports explicit rules for:

  • whether the start date is counted
  • rolling a non-business deadline forward
  • rolling a non-business deadline backward
  • leaving the calculated date unchanged

Example:

Start date: 2021-12-20
State: NSW
Days: 7
Day type: calendar
Include start: false
Roll: next

The unadjusted deadline is:

2021-12-27

Because that date is a substitute public holiday, the final deadline becomes:

2021-12-29

Supported Jurisdictions

  • ACT
  • NSW
  • NT
  • QLD
  • SA
  • TAS
  • VIC
  • WA

Holiday Handling

The engine accounts for:

  • Saturdays
  • Sundays
  • state and territory public holidays
  • substitute public holidays where represented in the installed holiday dataset

Public-holiday information is provided using the date-holidays dataset.

Local, regional or industry-specific holidays are not guaranteed unless represented in the relevant jurisdiction dataset.

HTTP Endpoints

The Worker can also be used directly over HTTP.

Check a business day
/check?date=2021-12-27&state=NSW
Add or subtract business days
/calculate?date=2021-12-24&state=NSW&days=1
Count business days
/count?start_date=2021-12-24&end_date=2021-12-29&state=NSW&include_start=false&include_end=true
Calculate a deadline
/deadline?start_date=2021-12-20&state=NSW&days=7&day_type=calendar&include_start=false&roll=next

Why AU Agent Utilities?

AI agents are good at reasoning, but deterministic local rules should not depend on guessing.

AU Agent Utilities is being built as a reliable Australian utility layer for agents, with the Business Day Engine as the first module.

Future utilities will expand beyond dates into other Australian data, verification and workflow functions.

Deployment

The MCP server is deployed on Cloudflare Workers and is available remotely through the live MCP endpoint above.

It is also published through Smithery as:

creatorhub121/au-agent-utilities

Version

1.2.0

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.