Determines if a given date falls on Saturday or Sunday. Available via MCP in Cursor and other AI coding tools, or REST API at `/v1/datetime/is-weekend`. Pass any date format and get a boolean result — useful for business logic, scheduling algorithms, or filtering datasets by weekdays vs weekends.
curl "https://tinyfn.io/v1/datetime/is-weekend" \
-H "X-API-Key: YOUR_API_KEY"
const response = await fetch('https://tinyfn.io/v1/datetime/is-weekend', {
headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests
response = requests.get('https://tinyfn.io/v1/datetime/is-weekend',
headers={'X-API-Key': 'YOUR_API_KEY'})
data = response.json()
print(data)
Connect your AI agent (Claude, Cursor, Windsurf, etc.) to TinyFn's date/time tools:
{
"mcpServers": {
"tinyfn-datetime": {
"url": "https://tinyfn.io/mcp/datetime",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
Accepts ISO 8601 dates (2024-03-15), timestamps, and most common date strings. Returns true for Saturday/Sunday, false otherwise.
Call the is-weekend tool with your date parameter. Works in Cursor, Claude Code, Windsurf, and other MCP clients for instant weekend validation.
Evaluates the calendar date only, not timezone-specific weekend timing. Saturday and Sunday always return true regardless of time zone.
No, the endpoint processes one date per request. For batch operations, make multiple API calls or use it iteratively in your AI agent workflow.
Returns a JSON boolean: `{"is_weekend": true}` for Saturday/Sunday, `{"is_weekend": false}` for Monday-Friday.