Skip to content

BulkSMS MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.3.3 · published by io.usefulapi

Read BulkSMS messages, replies, profile and webhooks; send SMS to up to 10 numbers.

Deletes · 2
CompareRegistry entry

8 tools: 2 can delete or cancel things and 6 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http bulksms https://bulksms.usefulapi.io/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

8 tools

Deletes or cancels 2Claude Code: deny
  • bulksms_block_numberWRITE: adds ONE phone number to the account's blocked list, so that no further messages are sent to it (a send to a blocked number fails with FAILED.BLOCKED and still costs credits…No findings

    Why it is in this group

    • The description's first verb is "write": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: adds ONE phone number to the account's blocked list, so that no further messages are sent to it (a send to a blocked number fails with FAILED.BLOCKED and still costs credits). This API has no way to remove a block again: do it only when the user asks for it. BulkSMS REST: POST /blocked-numbers.

    Annotations the server declares

    • title: Block a phone number
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
  • bulksms_send_messageWRITE: SENDS REAL SMS to real people and SPENDS CREDITS from the user's BulkSMS account; it cannot be undone or recalled.No findings

    Why it is in this group

    • The name "bulksms_send_message" says "send": a word for sending, and what is sent cannot be taken back.
    • The description says "cannot be undone".
    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: SENDS REAL SMS to real people and SPENDS CREDITS from the user's BulkSMS account; it cannot be undone or recalled. One message text to 1 to 10 phone numbers in international format (e.g. +447700900000). Cost = credits per message part x number of parts x number of recipients (about 1 credit per 160-character GSM part to a standard-route destination; the exact cost depends on the destination and appears as creditCost on the sent messages afterwards). Messages longer than one part are concatenated up to max_parts parts (default 3). Non-GSM characters (emoji, accents outside GSM 03.38) are replaced by "?" unless auto_unicode is true, which sends Unicode (shorter parts, more credits). Messages to blocked numbers still cost credits. Only send what the user explicitly asked for, confirm the text and recipients first. No groups, no scheduling. Texts containing BulkSMS template placeholders such as {F0###}, {fn###} or {sn###} are rejected (they would merge contact data). BulkSMS REST: POST /messages.

    Annotations the server declares

    • title: Send SMS
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
Only reads 6Claude Code: allow
  • bulksms_get_messageGet one sent or received message by its id: body, recipient, delivery status, number of parts and credit cost.No findings

    Why it is in this group

    • The name "bulksms_get_message" says "get": a word for reading.
    Description, as the server wrote it
    Get one sent or received message by its id: body, recipient, delivery status, number of parts and credit cost. BulkSMS REST: GET /messages/{id}.

    Annotations the server declares

    • title: Get message
    • readOnlyHint: true
  • bulksms_get_profileShow the BulkSMS account: username, credit balance, credit limit, whether credit transfer is allowed, the daily message quota (size and remaining today) and the sender ids this acc…No findings

    Why it is in this group

    • The name "bulksms_get_profile" says "get": a word for reading.
    Description, as the server wrote it
    Show the BulkSMS account: username, credit balance, credit limit, whether credit transfer is allowed, the daily message quota (size and remaining today) and the sender ids this account may use. Company and billing details are left out. BulkSMS REST: GET /profile.

    Annotations the server declares

    • title: Get account profile and credits
    • readOnlyHint: true
  • bulksms_list_blocked_numbersList phone numbers the account may not send to (added via the API, by a recipient replying STOP, or by BulkSMS).No findings

    Why it is in this group

    • The name "bulksms_list_blocked_numbers" says "list": a word for reading.
    Description, as the server wrote it
    List phone numbers the account may not send to (added via the API, by a recipient replying STOP, or by BulkSMS). To page, pass min_id = the largest id of the previous page + 1. BulkSMS REST: GET /blocked-numbers.

    Annotations the server declares

    • title: List blocked numbers
    • readOnlyHint: true
  • bulksms_list_messagesList sent (SENT) and received (RECEIVED) SMS messages, newest first by default.No findings

    Why it is in this group

    • The name "bulksms_list_messages" says "list": a word for reading.
    Description, as the server wrote it
    List sent (SENT) and received (RECEIVED) SMS messages, newest first by default. BulkSMS limits the window to the last 7 days unless submission_date_from is given. To page newest-first, pass before_id = the smallest id of the previous page; with sort_order ASCENDING pass after_id = the largest id of the previous page. REST: GET /messages with a `filter` built from the arguments.

    Annotations the server declares

    • title: List messages
    • readOnlyHint: true
  • bulksms_list_repliesList the received (RECEIVED) replies linked to a sent message id.No findings

    Why it is in this group

    • The name "bulksms_list_replies" says "list": a word for reading.
    Description, as the server wrote it
    List the received (RECEIVED) replies linked to a sent message id. Only messages sent with a REPLIABLE sender have linked replies. An empty list means none or an unknown id. BulkSMS REST: GET /messages/{id}/relatedReceivedMessages.

    Annotations the server declares

    • title: List replies to a sent message
    • readOnlyHint: true
  • bulksms_list_webhooksList the account's webhooks (name, trigger SENT/RECEIVED, active flag, invoke option).No findings

    Why it is in this group

    • The name "bulksms_list_webhooks" says "list": a word for reading.
    Description, as the server wrote it
    List the account's webhooks (name, trigger SENT/RECEIVED, active flag, invoke option). Only the host of each webhook URL is shown: the path and query can hold a secret. Read-only: webhooks are not changed by this server. BulkSMS REST: GET /webhooks.

    Annotations the server declares

    • title: List webhooks
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.3.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http bulksms https://bulksms.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__bulksms__bulksms_get_profile",
      "mcp__bulksms__bulksms_list_messages",
      "mcp__bulksms__bulksms_get_message",
      "mcp__bulksms__bulksms_list_replies",
      "mcp__bulksms__bulksms_list_blocked_numbers",
      "mcp__bulksms__bulksms_list_webhooks"
    ],
    "ask": [],
    "deny": [
      "mcp__bulksms__bulksms_send_message",
      "mcp__bulksms__bulksms_block_number"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as bulksms. Review it before you use it.