Skip to content
MCP server

Salsa Engage MCP by usefulapi

Search supporters, donations, emails and segments; create or update supporters in Salsa…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Salsa Engage MCP by usefulapi

Salsa Engage MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Search supporters, donations, emails and segments; create or update supporters in Salsa Engage.

Install

Run in a terminal

claude mcp add --transport http salsa-engage https://salsa-engage.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://salsa-engage.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "salsa-engage": {
      "url": "https://salsa-engage.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "salsa-engage": {
      "type": "http",
      "url": "https://salsa-engage.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "salsa-engage": {
      "serverUrl": "https://salsa-engage.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "salsa-engage": {
      "type": "http",
      "url": "https://salsa-engage.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (11)

Read directly from the server.

salsa_get_call_metrics
Show the calls left in the current one-minute window for this token, the batch limit, and the call counters. Good first call to check the token works. Engage API: GET /integration/ext/v1/metrics.
salsa_search_supporters
Find supporters by Salsa Engage supporter ID, by text (first name, last name, email or cell phone), or by the time their census data changed. Returns each supporter with address, contacts and per-record errors and warnings. Engage API: POST /integration/ext/v1/supporters/search.
salsa_get_supporter_groups
List the groups that each of the given supporters belongs to. Engage API: POST /integration/ext/v1/supporters/groups.
salsa_search_transactions
Find donation transactions by transaction ID or supporter ID, or by a transaction date range. Pass identifiers with identifierType, or transactionFrom (with transactionTo). Engage API: POST /integration/ext/v1/transactionDetails/search.
salsa_search_activities
Find supporter activity (signups, donations, petitions, letters, event registrations and similar) by activity ID, by form, by supporter, or by modified time. Pass modifiedFrom or activityIds. Engage API: POST /integration/ext/v1/activities/search.
salsa_search_email_blasts
Find sent email blasts by blast ID, content ID, or publish date. Use the returned cursor to read more. Engage API: POST /integration/ext/v1/emails/search.
salsa_get_email_blast_results
Read the per-supporter results of one email blast (who received, opened or clicked it, as Engage reports them). Engage API: POST /integration/ext/v1/emails/individualResults.
salsa_search_segments
Get the definition of segments (supporter groups used for email targeting and export) by segment ID. Engage API: POST /integration/ext/v1/segments/search.
salsa_search_segment_members
List the supporters in one segment, optionally only some supporter IDs or those who joined since a time. Engage API: POST /integration/ext/v1/segments/members/search.
salsa_list_custom_fields
List the supporter and activity custom fields in this Engage organization, with their names and types. Use it before you write custom data. Engage API: GET /integration/ext/v1/customFields.
salsa_upsert_supporters
Create or update up to 20 supporters in one call. Give supporterId to update a known supporter. For a supporter without it, Engage decides the match, so check each result, errors and warnings in the reply. Engage API: PUT /integration/ext/v1/supporters.

Salsa Engage MCP by usefulapi FAQ

How do I add Salsa Engage MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http salsa-engage https://salsa-engage.usefulapi.io/mcp