MagicBell MCP by usefulapi is an MCP server published by io.usefulapi, hosted at magicbell.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including magicbell_list_broadcasts, magicbell_get_broadcast, magicbell_list_users, magicbell_get_user, magicbell_list_events.
Read MagicBell broadcasts, users, events, workflows and channels; create and update user records.
4,083 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_broadcasts",
"title": "List broadcasts",
"description": "List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List broadcasts",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.
| Parameter | Type | Description |
|---|---|---|
| broadcast_id * | string | Broadcast id. |
{
"name": "magicbell_get_broadcast",
"title": "Get a broadcast",
"description": "Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"broadcast_id"
],
"properties": {
"broadcast_id": {
"type": "string",
"description": "Broadcast id."
}
}
},
"annotations": {
"title": "Get a broadcast",
"readOnlyHint": true
}
}List users (notification recipients) with cursor pagination. Project API: GET /users.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_users",
"title": "List users",
"description": "List users (notification recipients) with cursor pagination. Project API: GET /users.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.
| Parameter | Type | Description |
|---|---|---|
| user_id * | string | MagicBell user id or external id. |
{
"name": "magicbell_get_user",
"title": "Get a user",
"description": "Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "string",
"description": "MagicBell user id or external id."
}
}
},
"annotations": {
"title": "Get a user",
"readOnlyHint": true
}
}List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_events",
"title": "List events",
"description": "List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List events",
"readOnlyHint": true
}
}Fetch a single delivery event by id. Project API: GET /events/{event_id}.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | Event id. |
{
"name": "magicbell_get_event",
"title": "Get an event",
"description": "Fetch a single delivery event by id. Project API: GET /events/{event_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "Event id."
}
}
},
"annotations": {
"title": "Get an event",
"readOnlyHint": true
}
}List notification workflows with cursor pagination. Project API: GET /workflows.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_workflows",
"title": "List workflows",
"description": "List notification workflows with cursor pagination. Project API: GET /workflows.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List workflows",
"readOnlyHint": true
}
}List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_workflow_runs",
"title": "List workflow runs",
"description": "List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List workflow runs",
"readOnlyHint": true
}
}Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.
| Parameter | Type | Description |
|---|---|---|
| run_id * | string | Workflow run id. |
{
"name": "magicbell_get_workflow_run",
"title": "Get a workflow run",
"description": "Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Workflow run id."
}
}
},
"annotations": {
"title": "Get a workflow run",
"readOnlyHint": true
}
}List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page (cursor pagination). |
| ending_before | string | Cursor: return items before this id (previous page). |
| starting_after | string | Cursor: return items after this id (next page). |
{
"name": "magicbell_list_channels",
"title": "List channels",
"description": "List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max items per page (cursor pagination).",
"exclusiveMinimum": 0
},
"ending_before": {
"type": "string",
"description": "Cursor: return items before this id (previous page)."
},
"starting_after": {
"type": "string",
"description": "Cursor: return items after this id (next page)."
}
}
},
"annotations": {
"title": "List channels",
"readOnlyHint": true
}
}List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.
No parameters.
{
"name": "magicbell_list_integrations",
"title": "List integrations",
"description": "List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List integrations",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | User email address. | |
| timezone | string | IANA timezone, e.g. America/New_York. |
| last_name | string | User last name. |
| first_name | string | User first name. |
| external_id | string | Your own stable id for this user (recommended identifier). |
| phone_numbers | array | Array of phone numbers (E.164). |
| custom_attributes | object | Arbitrary key/value metadata for the user. |
{
"name": "magicbell_create_user",
"title": "Create a user",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"description": "User email address."
},
"timezone": {
"type": "string",
"description": "IANA timezone, e.g. America/New_York."
},
"last_name": {
"type": "string",
"description": "User last name."
},
"first_name": {
"type": "string",
"description": "User first name."
},
"external_id": {
"type": "string",
"description": "Your own stable id for this user (recommended identifier)."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of phone numbers (E.164)."
},
"custom_attributes": {
"type": "object",
"description": "Arbitrary key/value metadata for the user.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Create a user",
"destructiveHint": true
}
}Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.
| Parameter | Type | Description |
|---|---|---|
| string | User email address. | |
| user_id * | string | MagicBell user id or external id to update. |
| timezone | string | IANA timezone, e.g. America/New_York. |
| last_name | string | User last name. |
| first_name | string | User first name. |
| external_id | string | Your own stable id for this user (recommended identifier). |
| phone_numbers | array | Array of phone numbers (E.164). |
| custom_attributes | object | Arbitrary key/value metadata for the user. |
{
"name": "magicbell_update_user",
"title": "Update a user",
"description": "Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user_id"
],
"properties": {
"email": {
"type": "string",
"description": "User email address."
},
"user_id": {
"type": "string",
"description": "MagicBell user id or external id to update."
},
"timezone": {
"type": "string",
"description": "IANA timezone, e.g. America/New_York."
},
"last_name": {
"type": "string",
"description": "User last name."
},
"first_name": {
"type": "string",
"description": "User first name."
},
"external_id": {
"type": "string",
"description": "Your own stable id for this user (recommended identifier)."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of phone numbers (E.164)."
},
"custom_attributes": {
"type": "object",
"description": "Arbitrary key/value metadata for the user.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Update a user",
"destructiveHint": true
}
}Tools for MagicBell, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many notification broadcasts did we send recently?"; "Show me the latest notification delivery events."; "Which workflows ran most recently and did they succeed?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes MagicBell data. Free plan: 50 tool calls per month. Run magicbell_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run magicbell_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run magicbell_upgrade without a plan: it returns both plans, each with a payment link for the user to open. magicbell_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.