MagicBell MCP server. Read MagicBell broadcasts, users, events, workflows and channels; create and update user records.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"magicbell": {
"url": "https://magicbell.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
magicbell_list_broadcasts | read | List broadcasts List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts. |
magicbell_get_broadcast | read | Get a broadcast Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}. |
magicbell_list_users | read | List users List users (notification recipients) with cursor pagination. Project API: GET /users. |
magicbell_get_user | read | Get a user Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}. |
magicbell_list_events | read | List events List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events. |
magicbell_get_event | read | Get an event Fetch a single delivery event by id. Project API: GET /events/{event_id}. |
magicbell_list_workflows | read | List workflows List notification workflows with cursor pagination. Project API: GET /workflows. |
magicbell_list_workflow_runs | read | List workflow runs List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs. |
magicbell_get_workflow_run | read | Get a workflow run Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}. |
magicbell_list_channels | read | List channels List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels. |
magicbell_list_integrations | read | List integrations List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations. |
magicbell_create_user | write | 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. |
magicbell_update_user | write | Update a user Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}. |
magicbell_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
magicbell_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED MagicBell tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.