Search customers
Find customers by name, email or phone.
MCP tool simpro_read → search_customers
read
Returns matching company and individual customers with ID, name and the sites on record, best match first. Pages through the result. A customer is found only if it exists in your Simpro build. Your Simpro permissions decide which customers appear.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Name, email address or phone number. |
| page integer | integer | Page number, starting at 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "simpro_read",
"arguments": {
"operation": "search_customers",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"results": [
{
"customer_id": 3318,
"type": "company",
"name": "Harbour Dental",
"sites": [
{
"site_id": 5107,
"name": "12 Pier Rd"
}
]
}
],
"page": 1,
"has_more": false
},
"isError": false
}