Search contacts
Contacts of your directory found by name, number or company.
MCP tool ringover_read → search_contacts
read
Searches the Ringover contact directory by name, phone number or company and returns each match with its numbers. An empty list means no contact matches, which is normal for a first-time caller. Use the number as to_number in send_sms.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | A name, a phone number or a company. |
| limit integer | integer | How many contacts to return. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ringover_read",
"arguments": {
"operation": "search_contacts",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contacts": [
{
"contact_id": "ct_5528",
"name": "Dana Whitfield",
"company": "Northline Dental",
"numbers": [
"+15550100142"
]
}
]
},
"isError": false
}