list_custom_values
List custom field values for employees. Optionally filter results by person ID to get specific entries.
Instructions
List custom field values. Optionally filter by personId.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| person_id | No |
Implementation Reference
- humaans_mcp/server.py:418-421 (handler)The MCP tool handler for 'list_custom_values'. It calls the Humaans API /custom-values endpoint with an optional personId filter, paginating with a limit of 250.
@mcp.tool() async def list_custom_values(person_id: str | None = None) -> Any: """List custom field values. Optionally filter by personId.""" return await client().list_page("/custom-values", filters={"personId": person_id}, limit=250) - humaans_mcp/server.py:418-421 (registration)The tool is registered with FastMCP via the @mcp.tool() decorator on line 418, making it available as an MCP tool named 'list_custom_values'.
@mcp.tool() async def list_custom_values(person_id: str | None = None) -> Any: """List custom field values. Optionally filter by personId.""" return await client().list_page("/custom-values", filters={"personId": person_id}, limit=250) - humaans_mcp/client.py:45-55 (helper)Helper method list_page on HumaansClient that constructs pagination parameters and delegates to the GET helper. Called by list_custom_values to make the API request.
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)