Connectors · CRM & sales
Bloomerang MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Bloomerang and the rest of your systems. It gives your agent 112 Bloomerang actions (61 reads, 36 writes and 15 that wait for a confirmation) and holds the Bloomerang credential itself, so the agent never does. It paces Bloomerang's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "bloomerang.constituents.list", intent: "check which Bloomerang account is connected"}# Gets a list of constituents · read · 1 upstream call- 112actionsin one signed file
- 61readlook, never change
- 36writecreate and update
- 15wait for a yesdestructive, confirmed first
Set up
Connect Bloomerang in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect Bloomerang.
API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
api_keyBloomerang private API key: log in as an Administrator User, click the user icon (top right) > Edit My User, and…
account { op: "connections.requirements", service: "bloomerang" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "bloomerang.constituents.list" }# gets a list of constituents · read · 1 upstream callcheck { action: "bloomerang.constituents.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Bloomerang at a glance
- Sign-in
- API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
api_key- Limits we pace to
- 100 calls per 10 seconds, per connection
- API covered
- Bloomerang REST API v2 (OpenAPI 3.0.0, document version 2.0.0)
api.bloomerang.co - Built from
- Bloomerang's documentation, read 22 October 2026bloomerang-api-documentation.s3.us-west-2.amazonaws.combloomerang.com
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 60 of 61 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 6, so ask can line Bloomerang up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Bloomerang.
112 actions in 33 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 61readlook, never change
- 36writecreate and update
- 15destructivewait for a confirmation
Constituents
105 read · 4 write · 1 destructive
Gets a list of constituents · Creates a constituent · Gets a constituent by ID · Updates a constituent
Households
62 read · 3 write · 1 destructive
Creates a Household · Gets a list of households · Gets a household by ID · Updates a household
Tasks
62 read · 3 write · 1 destructive
Gets a list of tasks · Creates a task · Gets a task by ID · Updates a task
Addresses
52 read · 2 write · 1 destructive
Creates an address · Gets a list of addresses · Gets an address by ID · Updates an address
Campaigns
53 read · 2 write · 0 destructive
Creates a campaign · Gets a list of campaigns · Refreshes campaign goals · Gets a campaign by ID
Emails
52 read · 2 write · 1 destructive
Creates an email address · Gets a list of email addresses · Gets an email address by ID · Updates an email address
Interactions
52 read · 2 write · 1 destructive
Gets a list of interactions · Creates an interaction · Gets an interaction by ID · Updates an interaction
Notes
52 read · 2 write · 1 destructive
Gets a list of notes · Creates a note · Gets a note by ID · Updates a note
25 more areas · 65 actions
- Phones 5
- Refunds 5
- Soft credits 5
- Transactions 5
- Tributes 5
- Appeals 4
- Funds 4
- Relationships 4
- Wallet items 4
- Users 3
- Custom values 2
- Designations 2
- Email interests 2
- Pledge installments 2
- Processors 2
- Relationship roles 2
- Constituent relationships 1
- Constituent timeline 1
- Custom field categories 1
- Custom fields 1
- Groups 1
- Organization 1
- Pledge payment failures 1
- Pledge payments 1
- Pledges 1
Top actions
The Bloomerang API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 35 of Bloomerang's 35 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
bloomerang.constituents.listGets a list of constituents | Gets a list of constituents. | read | crm.contact.list177 connectors |
bloomerang.users.listGets a list of users | Gets a list of users. | read | identity.user.list474 connectors |
bloomerang.notes.listGets a list of notes | Gets a list of notes. | read | crm.contact_note.list29 connectors |
bloomerang.constituents.createCreates a constituent | Creates a constituent. | write | crm.contact.create161 connectors |
bloomerang.interactions.listGets a list of interactions | Gets a list of interactions. | read | crm.activity.list21 connectors |
bloomerang.transactions.listGets a list of Transactions | Gets a list of Transactions. | read | finance.payment.list75 connectors |
bloomerang.tasks.listGets a list of tasks | Gets a list of tasks. | read | work.task.list122 connectors |
bloomerang.constituents.deleteDeletes a constituent | Deletes a constituent. | destructive | crm.contact.delete147 connectors |
bloomerang.notes.createCreates a note | Creates a note. | write | crm.contact_note.create28 connectors |
bloomerang.interactions.createCreates an interaction | Creates an interaction. | write | crm.activity.create20 connectors |
bloomerang.transactions.createCreates a transaction | Creates a transaction. | write | finance.payment.create67 connectors |
bloomerang.tasks.createCreates a task | Creates a task. | write | work.task.create127 connectors |
Try it
Prompts to paste into Claude.
Each one names the Bloomerang actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Which Bloomerang tasks are overdue, and who owns each one?
calls
bloomerang.tasks.list - Writewrite
Creates a constituent in Bloomerang. Show me exactly what you will send before you save it.
calls
bloomerang.constituents.create - Across systemsread
Which contacts are in both Bloomerang and HaloPSA, and how many are in only one of them?
calls
bloomerang.constituents.listhalopsa.users.list
Across your systems
Bloomerang, joined to the rest of your business.
One ask fetches from Bloomerang and another system, joins the rows on the same customer on our side, and hands your agent the answer, not every row.
Which contacts are in both Bloomerang and HaloPSA, and how many are in only one of them?
bloomerang.constituents.list+halopsa.users.list, oncrm.contact· HaloPSAWhich contacts are in both Bloomerang and NetSuite, and how many are in only one of them?
bloomerang.constituents.list+netsuite.views.contacts, oncrm.contact· NetSuite
identity.user 517crm.contact 192work.task 105finance.payment 53crm.activity 10crm.contact_note 9ask { intent: "which contacts are in both Bloomerang and HaloPSA, and how many are in only one of them", steps: [ { action: "bloomerang.constituents.list", as: "people", input: {}, limit: 100, max_pages: 5 }, { action: "halopsa.users.list", as: "people2", input: {}, limit: 100, max_pages: 5 }, { join: { left: "people", right: "people2", on: "crm.contact", group_by: "people.email", select: ["people.email", "count(people2.id) as in_halopsa"] } } ]}Governance for Bloomerang
Destructive actions wait for a yes.
15 Bloomerang actions are destructive. These are all of them:
- Deletes a constituent
bloomerang.constituents.delete - Deletes a note
bloomerang.notes.delete - Deletes an interaction
bloomerang.interactions.delete - Deletes a transaction
bloomerang.transactions.delete - Deletes a task
bloomerang.tasks.delete - Deletes a refund
bloomerang.refunds.delete - Deletes a household
bloomerang.households.delete - Deletes an email address
bloomerang.emails.delete - Deletes a phone
bloomerang.phones.delete - Creates a refund
bloomerang.refunds.create - Deletes an address
bloomerang.addresses.delete - Writes off a pledge
bloomerang.pledges.write_off - Deletes a soft credit
bloomerang.soft_credits.delete - Deletes a wallet item
bloomerang.wallet_items.delete - Deletes a Relationship
bloomerang.relationships.delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Deletes a constituent?
intent: the user asked me to deletes a constituent
account { op: "keys.create", name: "bloomerang-agent", allowed_actions: ["bloomerang.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "bloomerang.constituents.delete", approver: "[email protected]" }, { match: "bloomerang.notes.delete", approver: "[email protected]" }, { match: "bloomerang.interactions.delete", approver: "[email protected]" } ]}Cost
What Bloomerang costs on actionlake.
Every Bloomerang action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Bloomerang refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 112 Bloomerang actions
- 112actions pageeach page of a long list is one call
- 60reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Bloomerang action.
112 actions by area: the id your agent calls, what it does, and its effect.
Constituents10
bloomerang.constituents.createCreates a constituentwritebloomerang.constituents.deleteDeletes a constituentdestructivebloomerang.constituents.find_duplicatesSearches for possible duplicate constituentsreadbloomerang.constituents.getGets a constituent by IDreadbloomerang.constituents.listGets a list of constituentsreadbloomerang.constituents.mergeCreates a new constituent or merges data with an existing constituentwritebloomerang.constituents.searchSearches for constituents and householdsreadbloomerang.constituents.search_duplicatesSearches for possible duplicate constituentsreadbloomerang.constituents.updateUpdates a constituentwritebloomerang.constituents.update_communication_settingsUpdates the communication settings for a constituentwrite
Households6
bloomerang.households.createCreates a Householdwritebloomerang.households.deleteDeletes a householddestructivebloomerang.households.getGets a household by IDreadbloomerang.households.listGets a list of householdsreadbloomerang.households.updateUpdates a householdwritebloomerang.households.update_communication_settingsUpdates the communication settings for a household and all its memberswrite
Tasks6
bloomerang.tasks.completeCompletes a taskwritebloomerang.tasks.createCreates a taskwritebloomerang.tasks.deleteDeletes a taskdestructivebloomerang.tasks.getGets a task by IDreadbloomerang.tasks.listGets a list of tasksreadbloomerang.tasks.updateUpdates a taskwrite
Addresses5
bloomerang.addresses.createCreates an addresswritebloomerang.addresses.deleteDeletes an addressdestructivebloomerang.addresses.getGets an address by IDreadbloomerang.addresses.listGets a list of addressesreadbloomerang.addresses.updateUpdates an addresswrite
Campaigns5
bloomerang.campaigns.createCreates a campaignwritebloomerang.campaigns.getGets a campaign by IDreadbloomerang.campaigns.listGets a list of campaignsreadbloomerang.campaigns.refresh_summariesRefreshes campaign goalsreadbloomerang.campaigns.updateUpdates a campaignwrite
Emails5
bloomerang.emails.createCreates an email addresswritebloomerang.emails.deleteDeletes an email addressdestructivebloomerang.emails.getGets an email address by IDreadbloomerang.emails.listGets a list of email addressesreadbloomerang.emails.updateUpdates an email addresswrite
Interactions5
bloomerang.interactions.createCreates an interactionwritebloomerang.interactions.deleteDeletes an interactiondestructivebloomerang.interactions.getGets an interaction by IDreadbloomerang.interactions.listGets a list of interactionsreadbloomerang.interactions.updateUpdates an interactionwrite
Notes5
bloomerang.notes.createCreates a notewritebloomerang.notes.deleteDeletes a notedestructivebloomerang.notes.getGets a note by IDreadbloomerang.notes.listGets a list of notesreadbloomerang.notes.updateUpdates a notewrite
Phones5
bloomerang.phones.createCreates a phonewritebloomerang.phones.deleteDeletes a phonedestructivebloomerang.phones.getGets a phone by IDreadbloomerang.phones.listGets a list of phonesreadbloomerang.phones.updateUpdates a phonewrite
Refunds5
bloomerang.refunds.createCreates a refunddestructivebloomerang.refunds.deleteDeletes a refunddestructivebloomerang.refunds.getGets a refund by IDreadbloomerang.refunds.listGets a list of refundsreadbloomerang.refunds.updateUpdates a refundwrite
Soft credits5
bloomerang.soft_credits.createCreates a soft creditwritebloomerang.soft_credits.deleteDeletes a soft creditdestructivebloomerang.soft_credits.getGets a soft credit by IDreadbloomerang.soft_credits.listGets a list of soft creditsreadbloomerang.soft_credits.updateUpdates a soft creditwrite
Transactions5
bloomerang.transactions.createCreates a transactionwritebloomerang.transactions.deleteDeletes a transactiondestructivebloomerang.transactions.getGets a transaction by IDreadbloomerang.transactions.listGets a list of Transactionsreadbloomerang.transactions.updateUpdates a transactionwrite
Tributes5
bloomerang.tributes.createCreates a tributewritebloomerang.tributes.getGets a tribute by IDreadbloomerang.tributes.listGets a list of tributesreadbloomerang.tributes.searchSearches for active tributesreadbloomerang.tributes.updateEdits a tributewrite
Appeals4
bloomerang.appeals.createCreates an appealwritebloomerang.appeals.getGets an appeal by IDreadbloomerang.appeals.listGets a list of appealsreadbloomerang.appeals.updateUpdates an appealwrite
Funds4
bloomerang.funds.createCreates a fundwritebloomerang.funds.getGets a fund by IDreadbloomerang.funds.listGets a list of fundsreadbloomerang.funds.updateUpdates a fundwrite
Relationships4
bloomerang.relationships.createCreates a Relationship between two non-household Constituentswritebloomerang.relationships.deleteDeletes a Relationshipdestructivebloomerang.relationships.getGets a relationshipreadbloomerang.relationships.updateUpdates a relationshipwrite
Wallet items4
bloomerang.wallet_items.createCreates a wallet itemwritebloomerang.wallet_items.deleteDeletes a wallet itemdestructivebloomerang.wallet_items.getGets a wallet item by IDreadbloomerang.wallet_items.listGets a list of wallet items for an accountread
Users3
bloomerang.users.listGets a list of usersreadbloomerang.users.meGets the user corresponding to the private API key usedreadbloomerang.users.searchSearches for usersread
Custom values2
bloomerang.custom_values.listGets a list of custom values for all pick fields of the given object typereadbloomerang.custom_values.list_for_fieldGets a list of custom values for the given fieldread
Designations2
bloomerang.designations.getGets a designation by IDreadbloomerang.designations.listGets a list of designationsread
Email interests2
bloomerang.email_interests.getGets an email interest by IDreadbloomerang.email_interests.listGets a list of email interestsread
Pledge installments2
bloomerang.pledge_installments.generateReturns a list of pledge installments for a given set of criteria. Note that this will not persist to the database, but these can be used as the PledgeInstallments property when creating or modifying a Pledgereadbloomerang.pledge_installments.listReturns a list of pledge installments for a given pledgeread
Processors2
bloomerang.processors.getGets a processor by IDreadbloomerang.processors.listGets a list of processorsread
Relationship roles2
bloomerang.relationship_roles.getGets a relationship role by IDreadbloomerang.relationship_roles.listGets a list of relationship rolesread
Constituent relationships1
bloomerang.constituent_relationships.listGets all Relationships for the specified constituentread
Constituent timeline1
bloomerang.constituent_timeline.listRetrieves TimelineEntrySummary for the Constituent or all members of a Household (if Household ID is passed in). Excludes transactions the user didn’t create if the user only has access to view transactions they createread
Custom field categories1
bloomerang.custom_field_categories.listGets a list of custom field categoriesread
Custom fields1
bloomerang.custom_fields.listGets a list of custom fieldsread
Groups1
bloomerang.groups.listGets a list of groupsread
Organization1
bloomerang.organization.getGets general organization informationread
Pledge payment failures1
bloomerang.pledge_payment_failures.listReturns a list of payment failures for the specified pledgeread
Pledge payments1
bloomerang.pledge_payments.listReturns a list of successful payments for the specified pledgeread
Pledges1
bloomerang.pledges.write_offWrites off a pledgedestructive
Questions
The Bloomerang MCP server, answered.
Is there a Bloomerang MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 112 Bloomerang actions across constituents, households, tasks and addresses, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Bloomerang.
What do I need to connect Bloomerang?
Bloomerang private API key: log in as an Administrator User, click the user icon (top right) > Edit My User, and…. The free call account { op: "connections.requirements", service: "bloomerang" } lists exactly what to paste.
Can an AI agent delete or change things in Bloomerang?
Only if its key allows it, and only with an explicit confirmation. 15 Bloomerang actions are destructive, including deletes a constituent, deletes a note and deletes an interaction. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my Bloomerang API limit?
actionlake paces every call to the limits in the Bloomerang service file: 100 calls per 10 seconds per connection. Repeated reads are answered from cache (60 Bloomerang actions can be), which never reaches Bloomerang.
What does a Bloomerang action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (112 Bloomerang actions page). Cache hits, searches, dry runs and calls Bloomerang refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which Bloomerang API does it cover?
The Bloomerang REST API v2 (OpenAPI 3.0.0, document version 2.0.0) at api.bloomerang.co. It is built from Bloomerang's documentation as read on 22 October 2026. 112 actions in 33 areas, each one in the signed service file (version 1.0.0).
Can I combine Bloomerang with my other systems?
Yes. ask joins Bloomerang to HaloPSA or NetSuite on the same customer and returns the answer rather than every row. Bloomerang maps crm.contact, which 192 other connectors also map.
Does actionlake keep my Bloomerang data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Bloomerang credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent Bloomerang today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.