list_equipment
Retrieve equipment assigned to employees. Optionally filter by person ID to see equipment for a specific individual.
Instructions
List equipment assigned to people. Optionally filter by personId.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| person_id | No |
Implementation Reference
- humaans_mcp/server.py:400-403 (handler)The tool handler function that lists equipment from the Humaans API, optionally filtered by personId. It calls list_page on the /equipment endpoint.
@mcp.tool() async def list_equipment(person_id: str | None = None) -> Any: """List equipment assigned to people. Optionally filter by personId.""" return await client().list_page("/equipment", filters={"personId": person_id}, limit=250) - humaans_mcp/server.py:400-400 (registration)The @mcp.tool() decorator registers list_equipment as an MCP tool.
@mcp.tool() - humaans_mcp/client.py:45-55 (helper)The list_page helper method on HumaansClient that performs the actual API call with pagination 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) - humaans_mcp/server.py:11-15 (helper)The client() helper that provides a singleton HumaansClient instance used by list_equipment.
def client() -> HumaansClient: global _client if _client is None: _client = HumaansClient() return _client