GnistAI GnistAI
Log in

Working Days Calculator

Business day calculator — count working days, add/subtract business days, check weekday status.

Overview   |   MCP   |   REST API   |   OpenAPI   |   CLI   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 5 tools tools 5 5 type: calculator type type calculator calculator lifecycle: maintained lifecycle lifecycle maintained maintained Utilities

Data source: Algorithmic

MCP Endpoint (Streamable HTTP) https://context.gnist.ai/mcp/working-days/
Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (5)

count_working_days

Count business days between two dates (Monday–Friday only).

The range is [start, end) — start is inclusive, end is exclusive.
Returns a negative count if end is before start.

Args:
start: Start date in ISO 8601 format (YYYY-MM-DD).
end: End date in ISO 8601 format (YYYY-MM-DD), exclusive.

Returns:
Dictionary with count of working days and calendar days in the range.

ParameterTypeRequiredDescription
startstringrequired
endstringrequired
JSON-RPC Request
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "count_working_days",
    "arguments": {
      "start": "example",
      "end": "example"
    }
  }
}
add_working_days

Add N business days to a date and return the resulting date.

Skips weekends (Saturday and Sunday). Supports negative values to subtract days.

Args:
date: Starting date in ISO 8601 format (YYYY-MM-DD).
days: Number of business days to add (negative to subtract).

Returns:
Dictionary with the starting date, days added, and resulting date.

ParameterTypeRequiredDescription
datestringrequired
daysintegerrequired
JSON-RPC Request
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "add_working_days",
    "arguments": {
      "date": "example",
      "days": 1
    }
  }
}
is_working_day

Check whether a given date is a business day (Monday–Friday).

Args:
date: Date to check in ISO 8601 format (YYYY-MM-DD).

Returns:
Dictionary with is_working_day boolean and day_of_week name.

ParameterTypeRequiredDescription
datestringrequired
JSON-RPC Request
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "is_working_day",
    "arguments": {
      "date": "example"
    }
  }
}
get_working_days_in_month

List all working days (Monday–Friday) in a given year and month.

Args:
year: The year (e.g. 2026).
month: The month (1–12).

Returns:
Dictionary with count of working days and list of dates.

ParameterTypeRequiredDescription
yearintegerrequired
monthintegerrequired
JSON-RPC Request
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_working_days_in_month",
    "arguments": {
      "year": 1,
      "month": 1
    }
  }
}
report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")
JSON-RPC Request
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "report_feedback",
    "arguments": {
      "feedback": "example"
    }
  }
}

Quick Start

Shell
curl -X POST "https://context.gnist.ai/mcp/working-days/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "count_working_days", "arguments": {"start": "example", "end": "example"}}}'
Python
import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/working-days/",
    headers={"Gnist-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "count_working_days",
    "arguments": {
      "start": "example",
      "end": "example"
    }
  }
},
)
print(resp.json())

Related Toolkits (Utilities)

Resources