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.
Input Schema
TableJSON 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()