MCP Server

magicbell

io.usefulapi/magicbell
Communication Public & reachable MCP 2026-07-28

What this MCP does

Reads MagicBell notification users, broadcasts, workflows, channels, integrations, and delivery events, and manages user records.

magicbell_create_user
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.
Destructive
Input schema
{'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': {}}}}
magicbell_get_broadcast
Get a broadcast
Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['broadcast_id'], 'properties': {'broadcast_id': {'type': 'string', 'description': 'Broadcast id.'}}}
magicbell_get_event
Get an event
Fetch a single delivery event by id. Project API: GET /events/{event_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['event_id'], 'properties': {'event_id': {'type': 'string', 'description': 'Event id.'}}}
magicbell_get_user
Get a user
Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.
Read only
Input schema
{'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.'}}}
magicbell_get_workflow_run
Get a workflow run
Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'Workflow run id.'}}}
magicbell_list_broadcasts
List broadcasts
List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.
Read only
Input schema
{'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).'}}}
magicbell_list_channels
List channels
List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.
Read only
Input schema
{'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).'}}}
magicbell_list_events
List events
List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.
Read only
Input schema
{'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).'}}}
magicbell_list_integrations
List integrations
List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
magicbell_list_users
List users
List users (notification recipients) with cursor pagination. Project API: GET /users.
Read only
Input schema
{'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).'}}}
magicbell_list_workflow_runs
List workflow runs
List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.
Read only
Input schema
{'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).'}}}
magicbell_list_workflows
List workflows
List notification workflows with cursor pagination. Project API: GET /workflows.
Read only
Input schema
{'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).'}}}
magicbell_update_user
Update a user
Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.
Destructive
Input schema
{'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': {}}}}
Changed
magicbell_update_user
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_create_user
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_integrations
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_channels
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_get_workflow_run
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_workflow_runs
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_workflows
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_get_event
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_events
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_get_user
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_users
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_get_broadcast
Oct. 1, 2026, 2:43 a.m.
Changed
magicbell_list_broadcasts
Oct. 1, 2026, 2:43 a.m.
Added
magicbell_update_user
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_create_user
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_integrations
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_channels
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_get_workflow_run
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_workflow_runs
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_workflows
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_get_event
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_events
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_get_user
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_users
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_get_broadcast
Sept. 21, 2026, 2:44 a.m.
Added
magicbell_list_broadcasts
Sept. 21, 2026, 2:44 a.m.