Read MagicBell broadcasts, users, events, workflows and channels; create and update user records.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
User email address.
IANA timezone, e.g. America/New_York.
User last name.
User first name.
Your own stable id for this user (recommended identifier).
Array of phone numbers (E.164).
Arbitrary key/value metadata for the user.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
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.
| Argument | 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. |
{
"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": {}
}
}
}Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.
| Argument | Type | Description |
|---|---|---|
| broadcast_id* | string | Broadcast id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"broadcast_id"
],
"properties": {
"broadcast_id": {
"type": "string",
"description": "Broadcast id."
}
}
}Fetch a single delivery event by id. Project API: GET /events/{event_id}.
| Argument | Type | Description |
|---|---|---|
| event_id* | string | Event id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "Event id."
}
}
}Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.
| Argument | Type | Description |
|---|---|---|
| user_id* | string | MagicBell user id or external id. |
{
"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."
}
}
}Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Workflow run id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Workflow run id."
}
}
}List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.
| Argument | 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). |
{
"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)."
}
}
}List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.
| Argument | 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). |
{
"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)."
}
}
}List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.
| Argument | 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). |
{
"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)."
}
}
}List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List users (notification recipients) with cursor pagination. Project API: GET /users.
| Argument | 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). |
{
"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)."
}
}
}List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.
| Argument | 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). |
{
"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)."
}
}
}List notification workflows with cursor pagination. Project API: GET /workflows.
| Argument | 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). |
{
"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)."
}
}
}Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.
| Argument | 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. |
{
"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": {}
}
}
}