List customers
Customers matching a name, email address or phone number.
MCP tool freescout_read → list_customers
read
Searches the customers of your FreeScout, one page at a time. A customer can have several email addresses, and all of them are returned. FreeScout keeps one customer table for all mailboxes, so a customer may appear with conversations from several of them.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Name, email address or phone number. |
| page integer | integer | Page number, starting at 1. Follow it while has_more is true. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "freescout_read",
"arguments": {
"operation": "list_customers",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"customers": [
{
"customer_id": 311,
"name": "Lena Ortiz",
"emails": [
"lena@example.com"
],
"phone": "+1 555 0142"
}
],
"page": 1,
"has_more": false
},
"isError": false
}