BulkSMS MCP by usefulapi

Working · 2.2 s

io.usefulapi/bulksmsv1.7.0 Domain verified

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

Communication

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://bulksms.usefulapi.io/mcp

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.

bulksms_block_number Destructive

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.

phone_numberstring, required

The number in international format, e.g. +447700900000 or 447700900000.

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.

I understand, run it anyway

Tools (8)

bulksms_block_number

destructive

Argument	Type	Description
phone_number*	string	The number in international format, e.g. +447700900000 or 447700900000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "phone_number"
  ],
  "properties": {
    "phone_number": {
      "type": "string",
      "minLength": 1,
      "description": "The number in international format, e.g. +447700900000 or 447700900000."
    }
  }
}

bulksms_get_message

Get one sent or received message by its id: body, recipient, delivery status, number of parts and credit cost. BulkSMS REST: GET /messages/{id}.

read-only

Argument	Type	Description
message_id*	string	The message id (from list_messages or send_message).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "minLength": 1,
      "description": "The message id (from list_messages or send_message)."
    }
  }
}

bulksms_get_profile

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

bulksms_list_blocked_numbers

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.

read-only

Argument	Type	Description
limit	integer	Maximum records, default 100.
min_id	integer	Only records with id >= min_id (default 0).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum records, default 100."
    },
    "min_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Only records with id >= min_id (default 0)."
    }
  }
}

bulksms_list_messages

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.

read-only

Argument	Type	Description
type	string	SENT = outgoing (MT), RECEIVED = incoming replies (MO).
limit	integer	Maximum number of messages, default 50. The API may return fewer even if more exist: page with before_id.
after_id	string	Only messages with an id higher than this (newer), for paging with sort_order ASCENDING: pass the largest id of the previous page.
before_id	string	Only messages with an id lower than this (older), for paging.
status_id	string	Filter by full status id, e.g. FAILED.BLOCKED or FAILED.EXPIRED.
sort_order	string	Default DESCENDING (newest first).
status_type	string	Filter by delivery status type.

bulksms_list_replies

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.

read-only

Argument	Type	Description
message_id*	string	The id of the SENT message.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "minLength": 1,
      "description": "The id of the SENT message."
    }
  }
}

bulksms_list_webhooks

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

bulksms_send_message

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.

destructive

Argument	Type	Description
to*	array	1 to 10 recipient numbers in international format with country code, e.g. +447700900000 or 27831234567.
body*	string	The message text.
from	string	Optional sender id: an allowed international number or a short alphanumeric name (see get_profile originAddresses). Omit to use the account default.
max_parts	integer	Cap on concatenated parts (and so on cost per recipient). Default 3.
auto_unicode

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "type": { "enum": [ "SENT", "RECEIVED" ], "type": "string", "description": "SENT = outgoing (MT), RECEIVED = incoming replies (MO)." }, "limit": { "type": "integer", "maximum": 200, "minimum": 1, "description": "Maximum number of messages, default 50. The API may return fewer even if more exist: page with before_id." }, "after_id": { "type": "string", "pattern": "^\\d{1,20}$", "description": "Only messages with an id higher than this (newer), for paging with sort_order ASCENDING: pass the largest id of the previous page." }, "before_id": { "type": "string", "pattern": "^\\d{1,20}$", "description": "Only messages with an id lower than this (older), for paging." }, "status_id": { "type": "string", "pattern": "^[A-Za-z_.]{1,64}$", "description": "Filter by full status id, e.g. FAILED.BLOCKED or FAILED.EXPIRED." }, "sort_order": { "enum": [ "ASCENDING", "DESCENDING" ], "type": "string", "description": "Default DESCENDING (newest first)." }, "status_type": { "enum": [ "ACCEPTED", "SENT", "DELIVERED", "FAILED" ], "type": "string", "description": "Filter by delivery status type." }, "submission_id": { "type": "string", "pattern": "^[A-Za-z0-9_.-]{1,64}$", "description": "Only messages of this submission (the submission.id of a sent message)." }, "user_supplied_id": { "type": "string", "pattern": "^[A-Za-z0-9_.-]{1,20}$", "description": "The userSuppliedId you set when sending (SENT messages only)." }, "submission_date_from": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$", "description": "Only messages submitted at or after this time, ISO 8601 with offset, e.g. 2026-10-01T00:00:00Z." } } }