Search constituents
Find constituents by name or account number, with the dashboard filters.
MCP tool bloomerang_read → search_constituents
read
Returns 25 constituents per page with the dashboard columns: name, account number, primary email and phone, status, latest transaction amount and date. Lifecycle stage and donor type are the ones Bloomerang computes: Lapsed means the latest transaction is older than 13 months. Follow next_cursor to the end of a list.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Name, account number, head of household or primary contact. |
| type string | string | Individual, Organization or Household. |
| status string | string | Active, Inactive or Deceased. |
| lifecycle_stage string | string | Prospective, Current or Lapsed. |
| donor_type string | string | New, Retained, Recaptured or Recurring. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bloomerang_read",
"arguments": {
"operation": "search_constituents",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"constituents": [
{
"id": 48211,
"account_number": 48211,
"name": "Lena Ortiz",
"type": "Individual",
"email": "lena@example.org",
"phone": "555-0142",
"status": "Active",
"latest_transaction_amount": 75,
"latest_transaction_date": "2025-06-14"
}
],
"next_cursor": "eyJwIjoyfQ"
},
"isError": false
}