find_person_by_email
Retrieve a person's details by searching for their exact email address. Returns the person object if found, or null if no match exists.
Instructions
Find one person by exact email match. Returns the person object, or null if not found.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- humaans_mcp/server.py:70-75 (handler)The handler/implementation of the find_person_by_email tool. It calls the Humaans API /people endpoint with an email filter and limit=1, then returns the first result or None.
@mcp.tool() async def find_person_by_email(email: str) -> dict[str, Any] | None: """Find one person by exact email match. Returns the person object, or null if not found.""" resp = await client().list_page("/people", filters={"email": email}, limit=1) items = _items(resp) return items[0] if items else None - humaans_mcp/server.py:70-70 (registration)The tool is registered with the @mcp.tool() decorator on line 70 (just before the function definition).
@mcp.tool() - humaans_mcp/server.py:71-71 (schema)The function signature defines input schema: email (str) is required. Return type is dict[str, Any] | None.
async def find_person_by_email(email: str) -> dict[str, Any] | None: - humaans_mcp/server.py:18-23 (helper)The _items helper function is used by find_person_by_email to extract the data list from the API response.
def _items(resp: Any) -> list[dict[str, Any]]: if isinstance(resp, dict) and "data" in resp: return resp["data"] if isinstance(resp, list): return resp return []