List contacts
Read the contacts saved in one of your lists, or in all of them.
MCP tool findymail_read → list_contacts
read
Returns each contact with its ID, name, email, LinkedIn URL, company and job title, with totals for the list. The tool reads contacts only; it does not add them to a list. Reading contacts is free.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id integer | integer | List ID from list_contact_lists. Omit or pass 0 for all contacts. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "findymail_read",
"arguments": {
"operation": "list_contacts",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"recordsTotal": 2,
"data": [
{
"id": 88120,
"name": "Dana Whitfield",
"email": "dana@northwind.com",
"linkedin_url": "https://www.linkedin.com/in/example-dana",
"company": "Northwind Logistics",
"job_title": "Head of Growth"
},
{
"id": 88121,
"name": "Luis Ortega",
"email": "luis@globex.co",
"linkedin_url": "https://www.linkedin.com/in/example-luis",
"company": "Globex",
"job_title": "VP Marketing"
}
]
},
"isError": false
}