# Sarbacane MCP by usefulapi

> Sarbacane MCP by usefulapi is an MCP server. Read Sarbacane campaigns, stats, lists and blacklists; manage contacts and draft email campaigns. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read Sarbacane campaigns, stats, lists and blacklists; manage contacts and draft email campaigns.

## Install

### Claude Code (Terminal)

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

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

```sh
https://sarbacane.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "sarbacane": {
      "url": "https://sarbacane.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "sarbacane": {
      "serverUrl": "https://sarbacane.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `sarbacane_get_credits`: The account's remaining credits per type (email campaigns, SMS, eye tracking, Sendkit emails) with expiry date and subscription type. GET /v1/credits.
- `sarbacane_list_users`: Users and pending invitations of the Sarbacane account (name, email, role, team). GET /v1/users.
- `sarbacane_list_lists`: All contact lists of the account, with their ids. Use the ids for contacts, fields and campaigns. GET /v1/lists.
- `sarbacane_list_list_fields`: The custom fields (columns) of a contact list: id, caption and type (STRING, BOOL, INT, DATE). Field ids are the keys used when writing contacts. GET /v1/lists/{listId}/fields.
- `sarbacane_list_contacts`: Contacts of one list (personal data: email, phone, custom fields). Filter by email, phone, a text search across fields, or the modification date. GET /v1/lists/{listId}/contacts.
- `sarbacane_create_contact`: WRITE: add a contact to a contact list. Give an email, a phone number or both, and optional custom field values. Adds a new record; use sarbacane_upsert_contact to update an existing contact. POST /v1/lists/{listId}/contacts.
- `sarbacane_upsert_contact`: WRITE: add a contact to a list, or update it when the same email/phone pair already exists (custom field values are overwritten). POST /v1/lists/{listId}/contacts/upsert.
- `sarbacane_list_blacklists`: All blacklists (suppression lists) of the account, with their ids. GET /v1/blacklists.
- `sarbacane_list_blacklist_entries`: Entries of a blacklist by kind: bounces (invalid addresses), unsubscribers or complaints (personal data: email, phone). Filter by email, phone or modification date. GET /v1/blacklists/{blacklistId}/{bounces|unsubscribers|complaints}.
- `sarbacane_add_unsubscriber`: WRITE: record an email and/or phone as unsubscribed in a blacklist, so campaigns using that blacklist skip it. Cannot be undone with these tools. POST /v1/blacklists/{blacklistId}/unsubscribers.
- `sarbacane_list_campaigns`: Campaigns of the account (id, name, kind, created/edited, recipient count). Filter by state or a text in the name or subject. GET /v1/campaigns.
- `sarbacane_get_campaign`: One campaign: state, kind, blacklists, send ids, sent date. The send id is needed to see content. GET /v1/campaigns/{campaignId}.
- `sarbacane_get_campaign_report`: Statistics of a campaign per send: delivered count, opens, openers, clicks, clickers, unsubscribers, devices and operating systems. GET /v1/reports/{campaignId}.
- `sarbacane_list_campaign_recipients`: Recipients attached to a campaign (personal data: email, phone). GET /v1/campaigns/{campaignId}/recipients.
- `sarbacane_list_webhooks`: Webhook subscriptions of the account: url, display name and subscribed event kinds. GET /v1/webhooks.
- `sarbacane_create_email_campaign`: WRITE: create a new email campaign as a DRAFT. It is never sent by these tools: add content (sarbacane_set_campaign_content or sarbacane_import_campaign_template) and a contact list (sarbacane_set_campaign_list), then send it from Sarbacane. POST /v1/campaigns/email.
- `sarbacane_set_campaign_content`: WRITE: set the HTML (and optional plain-text) content of an email campaign's send, replacing what was there. Without send_id the campaign's only send is used (an A/B test campaign has several: pass one). POST /v1/campaigns/{campaignId}/send/{sendId}/content.
- `sarbacane_import_campaign_template`: WRITE: load a saved template's content into an email campaign, replacing its content. POST /v1/campaigns/{campaignId}/content.
- `sarbacane_set_campaign_list`: WRITE: import a contact list's contacts as the recipients of a campaign. It does not send the campaign. POST /v1/campaigns/{campaignId}/list.

## FAQ

### How do I add Sarbacane MCP by usefulapi to Claude Code?

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

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