list_public_holiday_calendars
Retrieve all public holiday calendars configured in Humaans. Use this to view available holiday schedules for planning.
Instructions
List all configured public holiday calendars.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_public_holiday_calendars"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- humaans_mcp/server.py:378-381 (handler)Handler function that defines the 'list_public_holiday_calendars' MCP tool. It calls the Humaans API at '/public-holiday-calendars' with a limit of 250, returning a paginated list of public holiday calendars.
@mcp.tool() async def list_public_holiday_calendars() -> Any: """List all configured public holiday calendars.""" return await client().list_page("/public-holiday-calendars", limit=250) - humaans_mcp/server.py:378-378 (registration)The tool is registered via the @mcp.tool() decorator from FastMCP, which binds the async function to the MCP server.
@mcp.tool() - humaans_mcp/client.py:45-55 (helper)Helper method 'list_page' on HumaansClient that constructs query parameters with $limit and $skip and calls the GET endpoint. Used by the handler to fetch the paginated list.
async def list_page( self, path: str, filters: dict[str, Any] | None = None, limit: int = 100, skip: int = 0, ) -> Any: params = dict(filters or {}) params["$limit"] = limit params["$skip"] = skip return await self.get(path, params) - humaans_mcp/client.py:34-43 (helper)Underlying 'get' method on HumaansClient that performs the actual HTTP GET request to the Humaans API with authorization headers.
async def get(self, path: str, params: dict[str, Any] | None = None) -> Any: clean = {k: v for k, v in (params or {}).items() if v is not None} resp = await self._client.get(path, params=clean) if resp.status_code >= 400: try: body = resp.json() except Exception: body = resp.text raise HumaansError(resp.status_code, path, body) return resp.json()