get_company
Retrieve a specific company's details by providing its unique identifier.
Instructions
Retrieve a company by id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- humaans_mcp/server.py:255-258 (handler)The actual tool handler for 'get_company'. It accepts a company_id string and makes a GET request to /companies/{company_id} via the HumaansClient.
@mcp.tool() async def get_company(company_id: str) -> dict[str, Any]: """Retrieve a company by id.""" return await client().get(f"/companies/{company_id}") - humaans_mcp/server.py:255-258 (registration)The tool is registered using the @mcp.tool() decorator from FastMCP, which automatically registers it as an MCP tool.
@mcp.tool() async def get_company(company_id: str) -> dict[str, Any]: """Retrieve a company by id.""" return await client().get(f"/companies/{company_id}") - humaans_mcp/server.py:256-256 (schema)The input schema is defined by the function signature: company_id is a required string parameter. The return type is dict[str, Any].
async def get_company(company_id: str) -> dict[str, Any]: - humaans_mcp/client.py:34-43 (helper)The client().get() helper method that performs the actual HTTP GET request to the Humaans API, which is called by the get_company handler.
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()