MagicBell MCP by usefulapi
Read MagicBell broadcasts, users, events, workflows and channels; create and update user records.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"magicbell": {
"url": "https://magicbell.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://magicbell.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (13)
🟢magicbell_list_broadcasts(limit, starting_after, ending_before)
List broadcasts (notification-send batches) with cursor pagination. Read-only observability. Project API: GET /broadcasts.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_get_broadcast(broadcast_id)
Fetch a single broadcast by id. Project API: GET /broadcasts/{broadcast_id}.
입력 스키마
{
"type": "object",
"properties": {
"broadcast_id": {
"type": "string",
"description": "Broadcast id."
}
},
"required": [
"broadcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_users(limit, starting_after, ending_before)
List users (notification recipients) with cursor pagination. Project API: GET /users.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_get_user(user_id)
Fetch a single user by MagicBell user id or external id. Project API: GET /users/{user_id}.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "MagicBell user id or external id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_events(limit, starting_after, ending_before)
List notification delivery events with cursor pagination. Read-only observability. Project API: GET /events.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_get_event(event_id)
Fetch a single delivery event by id. Project API: GET /events/{event_id}.
입력 스키마
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"description": "Event id."
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_workflows(limit, starting_after, ending_before)
List notification workflows with cursor pagination. Project API: GET /workflows.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_workflow_runs(limit, starting_after, ending_before)
List workflow runs (execution history) with cursor pagination. Project API: GET /workflows/runs.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_get_workflow_run(run_id)
Fetch a single workflow run by id. Project API: GET /workflows/runs/{run_id}.
입력 스키마
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"description": "Workflow run id."
}
},
"required": [
"run_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_channels(limit, starting_after, ending_before)
List delivery channels (in-app, email, push, SMS, etc.) with cursor pagination. Project API: GET /channels.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Max items per page (cursor pagination).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"starting_after": {
"description": "Cursor: return items after this id (next page).",
"type": "string"
},
"ending_before": {
"description": "Cursor: return items before this id (previous page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢magicbell_list_integrations
List configured provider integrations (e.g. Sendgrid, APNs, FCM). Project API: GET /integrations.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴magicbell_create_user(external_id, email, first_name, last_name, timezone, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"external_id": {
"description": "Your own stable id for this user (recommended identifier).",
"type": "string"
},
"email": {
"description": "User email address.",
"type": "string"
},
"first_name": {
"description": "User first name.",
"type": "string"
},
"last_name": {
"description": "User last name.",
"type": "string"
},
"timezone": {
"description": "IANA timezone, e.g. America/New_York.",
"type": "string"
},
"custom_attributes": {
"description": "Arbitrary key/value metadata for the user.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"phone_numbers": {
"description": "Array of phone numbers (E.164).",
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴magicbell_update_user(user_id, external_id, email, first_name, last_name, ...)
Updates a user record (reversible; sends no notification). Project API: PUT /users/{user_id}.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "MagicBell user id or external id to update."
},
"external_id": {
"description": "Your own stable id for this user (recommended identifier).",
"type": "string"
},
"email": {
"description": "User email address.",
"type": "string"
},
"first_name": {
"description": "User first name.",
"type": "string"
},
"last_name": {
"description": "User last name.",
"type": "string"
},
"timezone": {
"description": "IANA timezone, e.g. America/New_York.",
"type": "string"
},
"custom_attributes": {
"description": "Arbitrary key/value metadata for the user.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"phone_numbers": {
"description": "Array of phone numbers (E.164).",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거