bloomerang_get_current_user
Get the current user
Fetch the Bloomerang user the API key belongs to — name, email and permission level. A cheap way to confirm the key works and see what it may do. Bloomerang: GET /user/current.
Takes no parameters.
io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026
Search Bloomerang constituents and donations; log interactions, notes and tasks.
The publisher's own server: Ably MCP by usefulapi
Hosted Bloomerang connector that lets an assistant search donors and donations and log interactions, notes and tasks in a nonprofit CRM.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fbloomerang/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"bloomerang-by-usefulapi": {
"type": "http",
"url": "https://bloomerang.usefulapi.io/mcp"
}
}
}Use Bloomerang from Claude, Cursor, or any MCP client — search constituents, households, transactions, funds, campaigns and appeals, and create constituents, interactions, notes and tasks. Hosted, no local install: connect with your own Bloomerang credentials.
Live endpoint: https://bloomerang.usefulapi.io/mcp · Homepage: https://usefulapi.io/bloomerang
https://bloomerang.usefulapi.io/mcp.claude mcp add --transport http bloomerang https://bloomerang.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Bloomerang credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bloomerang/
On first connect you'll provide your Bloomerang private API key (an Administrator user generates it under Edit My User). They're validated, stored per-user, and scoped to you — no keys in config files.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Each paid plan covers this server only. Ask your AI to run bloomerang_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with bloomerang_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with bloomerang_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Bloomerang.
Source: servers/bloomerang/README.md at commit 3c1b3df
Get the current user
Fetch the Bloomerang user the API key belongs to — name, email and permission level. A cheap way to confirm the key works and see what it may do. Bloomerang: GET /user/current.
Takes no parameters.
Search constituents
Full-text search across constituents (individuals and organizations) and households by name, email, etc. Start here to find a donor's Id. Bloomerang: GET /constituents/search.
skiptaketypesearchrequiredList constituents
List constituents with filters — by Id, type, favorites, last-modified date, or a custom field value — and sorting. Good for syncing recent changes. Bloomerang: GET /constituents.
idsskiptaketypeorder_byis_favoritelast_modifiedcustom_field_idorder_directioncustom_field_valueGet one constituent
Fetch one constituent's full profile — names, primary and secondary contact details, household, communication preferences, engagement score and custom values. Bloomerang: GET /constituent/{id}.
constituent_idrequiredGet a constituent's timeline
The activity timeline for a constituent — gifts, interactions, notes, tasks and more, newest first. Pass a household Id to get the timeline of every member. Bloomerang: GET /constituent/{id}/timeline.
skiptakeconstituent_idrequiredList a constituent's relationships
Relationships between this constituent and others (spouse, employer, board member ...), with the role on each side. Bloomerang: GET /constituent/{id}/relationships.
skiptakelast_modifiedconstituent_idrequiredGet one household
Fetch a household — its names, head of household (HeadId) and member constituent Ids. A constituent's HouseholdId points here. Bloomerang: GET /household/{id}.
household_idrequiredList transactions (gifts)
List transactions — donations, pledges, pledge payments, recurring donations and their payments — with their designations (fund, campaign, appeal). Filter by constituent, amount range, type or last-modified date. Read only. Bloomerang: GET /transactions.
idsskiptaketypesorder_bymax_amountmin_amountlast_modifiedconstituent_idsorder_directiontransaction_numbersGet one transaction
Fetch one transaction with its payment method, amounts, refund status and every designation (fund, campaign, appeal, tribute, acknowledgement status). Bloomerang: GET /transaction/{id}.
transaction_idrequiredList funds
List the funds gifts can be designated to (e.g. General Operating, Scholarship). Bloomerang: GET /funds.
idsskiptakesearchis_activeis_defaultList campaigns
List fundraising campaigns with their goals and dates. Bloomerang: GET /campaigns.
idsskiptakesearchhas_goalis_activelast_modifiedList appeals
List appeals — the specific asks (a year-end letter, a gala invitation) that gifts are attributed to. Bloomerang: GET /appeals.
idsskiptakesearchis_activelast_modifiedList interactions
List logged interactions (calls, emails, meetings, letters ...) — filter by constituent, channel or purpose. Bloomerang: GET /interactions.
idsskiptakechannelsorder_bypurposesconstituent_idsorder_directionList notes
List notes, optionally for specific constituents. Bloomerang: GET /notes.
idsskiptakeorder_byconstituent_idsorder_directionList tasks
List tasks (follow-ups) — filter by status, due-date range, assignee user, constituent, channel or purpose. Bloomerang: GET /tasks.
idsskiptakechannelsorder_bypurposesstatusesmax_due_datemin_due_dateconstituent_idsorder_directionassignee_user_idsCreate a constituent
WRITE: create a new individual or organization constituent. For an individual give first_name/last_name; for an organization give full_name. Search first (bloomerang_search_constituents) to avoid creating a duplicate donor. Bloomerang: POST /constituent.
typerequiredgenderprefixstatussuffixwebsiteemployerbirthdatefull_namejob_titlelast_namefirst_name+8 moreUpdate a constituent
WRITE: update fields on an existing constituent's profile (names, job, status, primary address/email/phone). Only the fields you supply are sent. Bloomerang: PUT /constituent/{id}.
genderprefixstatussuffixwebsiteemployerbirthdatefull_namejob_titlelast_namefirst_nameformal_name+8 moreLog an interaction
WRITE: log an interaction with a constituent — a call, email, meeting, letter, etc. — on their timeline. Bloomerang: POST /interaction.
daterequirednotechannelrequiredpurposerequiredsubjectrequiredis_inboundconstituent_idrequiredAdd a note
WRITE: add a note to a constituent's record. Bloomerang: POST /note.
daterequirednoterequiredconstituent_idrequiredCreate a task
WRITE: create a follow-up task, optionally tied to a constituent and assigned to a user (find user Ids via bloomerang_get_current_user or existing tasks). Bloomerang: POST /task.
notechannelpurposesubjectrequireddue_daterequiredconstituent_idassignee_user_idsend_notifications100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.
io.usefulapiOfficial publisher
Read-only access to ROLLER venue data: search bookings, check product availability, and look up guests, waivers, gift cards and daily reports.
io.usefulapiOfficial publisher
Hosted Planerio connector that lets an assistant read shifts, staffing requirements, staff, employees, absences and vacation days.
io.usefulapiOfficial publisher
Read-only access to Marmin UAE e-invoicing data: invoices, credit notes, UBL XML, Peppol status and business profiles.
io.usefulapiOfficial publisher
Remote MCP server for Oyster that lets an assistant read team, time off, expense, contract and invoice data and approve or decline requests.
{ "mcpServers": { "bloomerang": { "url": "https://bloomerang.usefulapi.io/mcp" } }}