Developer Documentation
Everything you need to integrate with the FundraiserMax API. Build custom workflows, sync donor data, and connect AI assistants to your fundraising platform.
Available MCP Tools
The FundraiserMax MCP server exposes the following tools that AI assistants can invoke on your behalf. Each tool maps to one or more REST API endpoints.
Contacts
| Tool Name | Description | Required Parameters |
|---|---|---|
search_contacts | Search and list contacts with optional filters | None (all optional) |
get_contact | Retrieve a single contact by ID with all sub-resources | contactId |
create_contact | Create a new contact with all profile fields | firstName, lastName |
update_contact | Update any fields on an existing contact (quickNotes, prefix, suffix, birthDate, gender, tags, status, etc.) | contactId |
delete_contact | Soft-delete a contact by ID | contactId |
Contact Phones
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_phones | List all phone numbers for a contact | contactId |
add_contact_phone | Add a phone number to a contact | contactId, phoneNumber |
update_contact_phone | Update an existing phone number | phoneId |
delete_contact_phone | Remove a phone number | phoneId |
Contact Emails
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_emails | List all email addresses for a contact | contactId |
add_contact_email | Add an email address to a contact | contactId, emailAddress |
update_contact_email | Update an existing email address | emailId |
delete_contact_email | Remove an email address | emailId |
Contact Addresses
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_addresses | List all addresses for a contact | contactId |
add_contact_address | Add a mailing address to a contact | contactId, streetAddress1, city, stateProvince, postalCode |
update_contact_address | Update an existing address | addressId |
delete_contact_address | Remove an address | addressId |
Contact Notes
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_notes | List all notes for a contact | contactId |
add_contact_note | Add a note to a contact | contactId, content |
update_contact_note | Update an existing note | noteId |
delete_contact_note | Remove a note | noteId |
Contact Education
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_education | List all education records for a contact | contactId |
add_contact_education | Add an education record to a contact | contactId, institutionName |
update_contact_education | Update an existing education record | educationId |
delete_contact_education | Remove an education record | educationId |
Contact Employment
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_employment | List all employment records for a contact | contactId |
add_contact_employment | Add an employment record to a contact | contactId, companyName |
update_contact_employment | Update an existing employment record | employmentId |
delete_contact_employment | Remove an employment record | employmentId |
Contact Lists
| Tool Name | Description | Required Parameters |
|---|---|---|
list_contact_lists | List and search contact lists with filtering by type | None (all optional) |
get_contact_list | Get a single contact list with member count and rules | listId |
create_contact_list | Create a new static or smart contact list | name, type |
update_contact_list | Update properties of an existing list | listId |
delete_contact_list | Soft-delete a contact list | listId |
list_contact_list_members | Get paginated contacts in a list | listId |
add_contacts_to_list | Add contacts to a static list | listId, contactIds |
remove_contacts_from_list | Remove contacts from a list | listId, contactIds |
add_tags_to_list | Add tags to a contact list | listId, tags |
Contact Tags
| Tool Name | Description | Required Parameters |
|---|---|---|
add_tags_to_contact | Add tags to a contact (merges with existing) | contactId, tags |
remove_tags_from_contact | Remove specific tags from a contact | contactId, tags |
Campaigns, Events, Donations & Dashboard
| Tool Name | Description | Required Parameters |
|---|---|---|
list_campaigns | List all campaigns for the account | None |
get_campaign | Retrieve a single campaign by ID | campaignId |
list_events | List all events for the account | None |
get_donations | List donations with optional date range filters | None |
create_donation | Record a new donation | contactId, amount |
get_dashboard_stats | Retrieve aggregated fundraising statistics | None |
Security: All MCP tools are account-scoped. The account is determined by the API key used to establish the SSE connection. Tools can only access and modify data belonging to that account. All optional parameters match the corresponding REST API endpoint parameters (e.g.,
search, limit, offset for search_contacts).