# Salsa Engage MCP by usefulapi

> Salsa Engage MCP by usefulapi is an MCP server. Search supporters, donations, emails and segments; create or update supporters in Salsa Engage. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/salsa-engage/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/salsa-engage
- **MCP Registry name:** io.usefulapi/salsa-engage
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://salsa-engage.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "salsa-engage": {
      "url": "https://salsa-engage.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/salsa-engage-mcp-by-usefulapi
