list_companies
Retrieve all companies in your Humaans account.
Instructions
List all companies in the Humaans account.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- humaans_mcp/server.py:249-252 (handler)The tool handler for 'list_companies' — an async function decorated with @mcp.tool() that calls the Humaans API to list all companies (limit=250).
@mcp.tool() async def list_companies() -> Any: """List all companies in the Humaans account.""" return await client().list_page("/companies", limit=250) - humaans_mcp/server.py:249-250 (registration)The tool is registered via the @mcp.tool() decorator on the FastMCP instance 'mcp'.
@mcp.tool() async def list_companies() -> Any: - humaans_mcp/client.py:45-55 (helper)The HumaansClient.list_page() helper method that builds the HTTP GET request with pagination params ($limit, $skip) and calls the API.
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() singleton factory that provides the HumaansClient instance used by list_companies.
def client() -> HumaansClient: global _client if _client is None: _client = HumaansClient() return _client