# Beacon CRM MCP by usefulapi

> Beacon CRM MCP by usefulapi is a freemium MCP server for sales and crm. Hosted MCP server to search and edit Beacon CRM supporter and donation records. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/beacon-crm/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/beacon-crm
- **MCP Registry name:** io.usefulapi/beacon-crm
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-14

## About

Charities that keep supporters, organisations and donations in Beacon can reach them through this server. The assistant first reads the record types and their fields, then filters records on field values, such as people whose email contains a given domain.

Unlike most connectors of its kind, this one writes: it can create, update and delete records, and upsert by a key field like email or external id to avoid duplicates. Deleting archives the record in Beacon, and the server cannot restore it. It can also start an export from an existing template and report back with a download link once it is ready.

The login page asks for your Beacon account id and an API key. The key acts with your account's access, so changes are real, and the Beacon API needs the Standard, Premium or Ultimate plan.

## Features

- **Filter by field values:** Query any record type with conditions on its fields.
- **Upsert by key field:** Match on email or external id so updates do not create duplicates.
- **Create, update, delete:** Change records directly; deleted ones are archived in Beacon.
- **Export from templates:** Start an export and poll it until a download link is ready.
- **Account user listing:** Read the users on the Beacon account.

## Good for

- Find supporters added in the last 30 days
- Record a new donor from a conversation
- List this month's donations
- Deduplicate by upserting on email
- Pull a supporter export without opening Beacon

## Install

### Claude Code (Terminal)

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

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

```sh
https://beacon-crm.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "beacon-crm": {
      "url": "https://beacon-crm.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "beacon-crm": {
      "serverUrl": "https://beacon-crm.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `beaconcrm_list_record_types`: List the record types of this Beacon account (people, organisations, payments, custom types, ...) with their fields (keys, types, options). Call this first: the keys are what the other tools take as `entity` and as field names. GET /entity_types.
- `beaconcrm_list_users`: List the users of the Beacon account (id, role, name, email). Use the inner user.id for 'link to a user' fields. GET /users.
- `beaconcrm_list_records`: List records of one type (for example person, organization, payment), one page at a time. Use beaconcrm_filter_records to search by field values. GET /entities/{entity}.
- `beaconcrm_get_record`: One record by type and id, with all its fields. GET /entity/{entity}/{id}.
- `beaconcrm_filter_records`: Search records of one type with Beacon filter conditions (read-only; it uses POST because the filter is a body). Each condition is {"field", "operator", "value"}. Operators by field type: text == != starts_with ends_with contains not_contains null not_null; select (value is an array) contains not_contains in not_in null not_null; number == != > < null not_null; date date_on date_after date_before 
- `beaconcrm_create_record`: WRITE: create ONE new record of the given type in the live Beacon database. Not idempotent: calling it twice creates two records (use beaconcrm_upsert_record to avoid duplicates). Beacon workflows may run as a result. Invalid field values are rejected with the rule that failed. POST /entity/{entity}.
- `beaconcrm_update_record`: WRITE: change fields of ONE existing record. Only the fields you pass are changed; a select or reference field passed as an empty array [] is CLEARED, removing its existing values. The previous values are not kept by this tool. Beacon workflows may run as a result. PATCH /entity/{entity}/{id}.
- `beaconcrm_upsert_record`: WRITE: create a record, or update the existing one whose key field matches. `primary_field_key` names the field used to find the match (for example "emails" for a person, or "external_id"); `fields` must contain a value for it. If a record matches it is UPDATED with the given fields (an empty array leaves an existing value untouched on upsert); otherwise a new record is created. Beacon workflows m
- `beaconcrm_delete_record`: WRITE, DESTRUCTIVE: delete ONE record. Beacon keeps deleted records as 'archived' (listable with archived=true), but this server has no restore tool, so treat the deletion as irreversible. Related data that depends on the record may be affected. It is sent once and never retried. DELETE /entity/{entity}/{id}.
- `beaconcrm_trigger_export`: WRITE: start an export job from an existing export template (created in Beacon). Returns the new export's id with status in_progress; then poll beaconcrm_list_exports with that id until progress is 100 and it carries a download url. Each call starts another job. POST /entity_export/trigger.
- `beaconcrm_list_exports`: List recent export jobs with status, progress (100 = complete) and, when complete, a signed download url. Pass entity_export_id to check one job started by beaconcrm_trigger_export. GET /entity_exports.

## FAQ

### What does it cost to try?

The free plan gives 50 tool calls a month. Pro is $9 a month for 10,000 calls and Pro+ is $39 a month for 100,000, and each paid plan covers only the Beacon CRM server.

### How do I sign in?

Add the server URL as a remote connector without any header. The login page then asks for your Beacon account id and API key (admins create keys under Settings, API keys).

### Which Beacon plans work?

The Beacon API needs the Standard, Premium or Ultimate plan.

### Can a deleted record be restored?

Beacon keeps it as archived, but this server cannot restore it.

### Is Beacon CRM MCP by usefulapi free?

Beacon CRM MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Beacon CRM MCP by usefulapi?

The closest alternatives to Beacon CRM MCP by usefulapi are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

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