List contacts
Contacts and members with their level, status and renewal date; filter by name, email or status.
MCP tool wild_apricot_read → list_contacts
read
Returns contacts the way the Contacts list shows them, a page at a time; pass next_cursor back as cursor for the next page. membership_status is one of Active, Lapsed, Pending - New, Pending - Renewal, Pending - Level change or Suspended. A contact who is not a member has no level and no status. member_since and renewal_due come from the Membership tab. Archived contacts are left out.
Parameters
| Name | Type | Description |
|---|---|---|
| search string | string | Part of a name or an email address. |
| membership_status enum | enum | Active, Lapsed, Pending - New, Pending - Renewal, Pending - Level change or Suspended. |
| membership_level string | string | Level name from list_membership_levels. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "wild_apricot_read",
"arguments": {
"operation": "list_contacts",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contacts": [
{
"contact_id": 48213,
"name": "Nora Elwood",
"email": "nora@example.com",
"membership_level": "Individual",
"membership_status": "Pending - New",
"member_since": null,
"renewal_due": null
},
{
"contact_id": 47990,
"name": "Sam Okafor",
"email": "sam@example.com",
"membership_level": "Student",
"membership_status": "Active",
"member_since": "2025-09-04",
"renewal_due": "2026-09-04"
}
],
"next_cursor": "2"
},
"isError": false
}