# io.usefulapi/magicbell (remote · magicbell.usefulapi.io)

Read MagicBell broadcasts, users, events, workflows and channels; create and update user records.

- Trust score: 18/100 (low)
- Change this week: −52
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `magicbell.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell.md), [page](https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell)

## Channel facts

- Endpoint: `https://magicbell.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint returned HTTP 429.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-magicbell https://magicbell.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-magicbell]
url = "https://magicbell.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-magicbell": {
      "type": "remote",
      "url": "https://magicbell.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-magicbell --url https://magicbell.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-magicbell:
    url: "https://magicbell.usefulapi.io/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 18, −55)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.23 → unverified
- [security regression] Transport: pass → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 73, +55)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.23

### 2026-08-01 (score 18, −54)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.17 → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-31 (score 72, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 70, +43)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 27)

First indexed and scored.

## MCP tools (13)

### `magicbell_list_broadcasts` (~86 tokens)

List broadcasts

List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_get_broadcast` (~39 tokens)

Get a broadcast

Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.

Input parameters:

- `broadcast_id` (string, required): Broadcast id.

### `magicbell_list_users` (~77 tokens)

List users

List users (notification recipients) with cursor pagination. Project API: GET /users.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_get_user` (~48 tokens)

Get a user

Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.

Input parameters:

- `user_id` (string, required): MagicBell user id or external id.

### `magicbell_list_events` (~80 tokens)

List events

List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_get_event` (~38 tokens)

Get an event

Fetch a single delivery event by id. Project API: GET /events/{event_id}.

Input parameters:

- `event_id` (string, required): Event id.

### `magicbell_list_workflows` (~76 tokens)

List workflows

List notification workflows with cursor pagination. Project API: GET /workflows.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_list_workflow_runs` (~83 tokens)

List workflow runs

List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_get_workflow_run` (~44 tokens)

Get a workflow run

Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.

Input parameters:

- `run_id` (string, required): Workflow run id.

### `magicbell_list_channels` (~86 tokens)

List channels

List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.

Input parameters:

- `ending_before` (string): Cursor: return items before this id (previous page).
- `limit` (integer): Max items per page (cursor pagination).
- `starting_after` (string): Cursor: return items after this id (next page).

### `magicbell_list_integrations` (~36 tokens)

List integrations

List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.

### `magicbell_create_user` (~147 tokens)

Create a user

Creates a user (notification recipient) record in MagicBell. Additive — sends no notification. Provide at least one identifier (external_id or email). Project API: POST /users.

Input parameters:

- `custom_attributes` (object): Arbitrary key/value metadata for the user.
- `email` (string): User email address.
- `external_id` (string): Your own stable id for this user (recommended identifier).
- `first_name` (string): User first name.
- `last_name` (string): User last name.
- `phone_numbers` (array): Array of phone numbers (E.164).
- `timezone` (string): IANA timezone, e.g. America/New_York.

### `magicbell_update_user` (~149 tokens)

Update a user

Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.

Input parameters:

- `custom_attributes` (object): Arbitrary key/value metadata for the user.
- `email` (string): User email address.
- `external_id` (string): Your own stable id for this user (recommended identifier).
- `first_name` (string): User first name.
- `last_name` (string): User last name.
- `phone_numbers` (array): Array of phone numbers (E.164).
- `timezone` (string): IANA timezone, e.g. America/New_York.
- `user_id` (string, required): MagicBell user id or external id to update.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell#diagnostics

## Score history

- 2026-08-03: 18
- 2026-08-02: 73
- 2026-08-01: 18
- 2026-07-31: 72
- 2026-07-30: 69
- 2026-07-29: 71
- 2026-07-28: 71
- 2026-07-27: 70
- 2026-07-26: 27

## Links

- Remote endpoint: https://magicbell.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-magicbell/magicbell