Search contacts
contacts_searchFinds contacts by exact email, status or tag, newest first. Free and read only. Status "subscribed" means active; "unsubscribed" covers suppressed addresses. Returns at most limit rows (default 50, max 200). Requires API key scope: read.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "contacts_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only contacts that carry this tag. | |
| No | Exact email address to look up. | ||
| limit | No | How many rows to return (1 to 200, default 50). | |
| status | No | Filter by status. subscribed = active, unsubscribed = suppressed. |