list_job_roles
Retrieve historical and current job assignments with optional filtering by person ID to view specific employee's job roles.
Instructions
List job roles (historical and current job assignments). Optionally filter by personId.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| person_id | No | ||
| limit | No | ||
| skip | No |
Implementation Reference
- humaans_mcp/server.py:261-266 (handler)The handler function that executes the list_job_roles tool. It calls client().list_page() on the '/job-roles' endpoint, with optional filtering by personId, limit, and skip parameters.
@mcp.tool() async def list_job_roles(person_id: str | None = None, limit: int = 100, skip: int = 0) -> Any: """List job roles (historical and current job assignments). Optionally filter by personId.""" return await client().list_page( "/job-roles", filters={"personId": person_id}, limit=limit, skip=skip ) - humaans_mcp/server.py:261-261 (registration)The tool is registered via the @mcp.tool() decorator on line 261, which registers list_job_roles as a tool in the FastMCP server.
@mcp.tool() - humaans_mcp/client.py:45-55 (helper)The list_page helper method on HumaansClient that performs the actual HTTP GET request with pagination parameters ($limit, $skip) and filter query params.
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)