Skip to main content
Glama

Voodoo SMS MCP by usefulapi

Server Details

Read Voodoo SMS credits, reports, inbox and lists; send one SMS; manage the opt-out blacklist.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

Score is being calculated.

Available Tools

13 tools
voodoosms_add_to_blacklistAdd a number to the blacklist
Destructive
Inspect

WRITE: adds one number to the account's opt-out blacklist; from then on no SMS is sent to it (sends to it fail with error 20). Use it for a recipient who asked to stop. This tool cannot remove a number again. Voodoo SMS REST: POST /blacklist.

ParametersJSON Schema
NameRequiredDescriptionDefault
numberYesPhone number in international format with the country code and no leading 0, e.g. 447700900123.
voodoosms_cancel_scheduled_messageCancel a scheduled SMS
Destructive
Inspect

WRITE: cancels one SMS that was scheduled through the send API, so it will not be sent. A message that has already gone out cannot be cancelled. Whether credits are refunded for a cancelled message is not documented by the vendor. Voodoo SMS REST: DELETE /schedule/{id}.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe scheduled message id (id from list_scheduled_messages).
voodoosms_create_contact_listCreate a contact list
Destructive
Inspect

WRITE: creates a new contact list with up to 500 contacts (the list name must be unique, at most 32 characters). It does not send anything. Voodoo SMS REST: POST /contacts.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesUnique list name, at most 32 characters.
countryNoDefault country calling code for the list (default 44).
contactsYesContacts to put in the list: [{number, dynamic_data?}].
descriptionNoOptional description.
voodoosms_get_contact_listGet contacts in a list
Read-only
Inspect

Get one contact list including its contacts (id, number, status, dynamic_data, created_at). Voodoo SMS REST: GET /contacts?contact_list_id=.

ParametersJSON Schema
NameRequiredDescriptionDefault
skipNoWhere to start the returned results (default 0).
limitNoNumber of contacts to return (default 100, max 5000).
contact_list_idYesThe contact list id (id from list_contact_lists).
voodoosms_get_creditsGet credit balance
Read-only
Inspect

Get the SMS credit balance of the account. One credit pays for one 160-character SMS part (153 characters per part in a long message). Voodoo SMS REST: GET /credits.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

voodoosms_list_blacklistList blacklisted numbers
Read-only
Inspect

List the numbers on the account's opt-out blacklist (no SMS is ever sent to them), or look up one number ({empty: true} means it is not on the list). Returns an empty result when the blacklist is empty. Voodoo SMS REST: GET /blacklist.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoNewest date a number was added.
skipNoWhere to start the returned results (default 0).
sortNoSort by id, ASC or DESC (default DESC).
limitNoNumber of entries to return (default 25, max 1000).
startNoOldest date a number was added.
numberNoLook up a single number (international format, e.g. 447700900123).
voodoosms_list_contact_listsList contact lists
Read-only
Inspect

List the account's contact lists (id, name, status, size, created/updated times) without their contacts. Returns an empty result if there are none. Voodoo SMS REST: GET /contacts.

ParametersJSON Schema
NameRequiredDescriptionDefault
skipNoWhere to start the returned results (default 0).
limitNoNumber of lists to return (default 100, max 5000).
voodoosms_list_delivery_reportsList delivery reports
Read-only
Inspect

List delivery reports of sent messages (message_id, sender_id, to, sent_at, delivered_at, price, status), optionally filtered. Use it to check whether a message was delivered. Dates accept a UNIX timestamp, ISO 8601 (2026-10-01T09:00:00+00:00) or plain English ('yesterday', '2 weeks'). Voodoo SMS REST: GET /report.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoOnly messages sent to this number (international format, e.g. 447700900123).
endNoEnd of the date range to filter on.
limitNoNumber of reports to return (default 25, max 1000).
startNoStart of the date range to filter on.
statusNoOnly messages with this status.
sent_atNoOnly messages sent at this date/time.
sender_idNoThe sender id the messages were sent with.
message_idNoThe messages[].id returned when the SMS was sent.
delivered_atNoOnly messages delivered at this date/time.
external_referenceNoThe external_reference used when sending.
voodoosms_list_inboxList received SMS
Read-only
Inspect

List SMS received on the account's Virtual Mobile Numbers (replies and keyword messages). Needs a purchased number; an empty inbox returns an empty result. Dates accept a UNIX timestamp, ISO 8601 or plain English. Voodoo SMS REST: GET /inbox.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoThe number the message was sent to: your virtual number (international format).
endNoNewest date of the messages to return.
fromNoThe number the message came from (international format).
skipNoWhere to start the returned results (default 0).
sortNoSort by id, ASC or DESC (default DESC).
limitNoNumber of messages to return (default 25, max 1000).
startNoOldest date of the messages to return.
keywordNoThe keyword (first word of the message).
referenceNoThe external_reference of the original outgoing message.
voodoosms_list_numbersList virtual mobile numbers
Read-only
Inspect

List the Virtual Mobile Numbers (VMNs) the account has purchased, used to receive SMS. Returns an empty result if there are none. Voodoo SMS REST: GET /numbers.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

voodoosms_list_scheduled_messagesList scheduled messages
Read-only
Inspect

List SMS that were scheduled through the send API and are still waiting to go out (messages scheduled in the portal's Web SMS are not shown). Voodoo SMS REST: GET /schedule.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

voodoosms_send_smsSend an SMS to one recipient
Destructive
Inspect

WRITE: SENDS A REAL SMS to ONE recipient and USES THE ACCOUNT'S CREDITS (1 credit per message part, charged whether or not it is delivered; it cannot be undone). sandbox is required: true validates and prices the message without sending or charging, false sends it for real. Optional schedule queues it for later (cancel with cancel_scheduled_message). Do not retry after an error or timeout without checking list_delivery_reports / list_scheduled_messages, or the recipient may get it twice. One recipient per call; there is no bulk or list send. Voodoo SMS REST: POST /sendsms.

ParametersJSON Schema
NameRequiredDescriptionDefault
toYesONE recipient number: international format with the country code and no leading 0 (447700900123), or a national number if country_code is given.
msgYesThe message text. 160 characters per part (153 in a long message), 70 (67) if it has emoji or other non-GSM characters; maximum 918 (402 with Unicode).
fromYesSender id shown to the recipient: 4 to 11 letters/digits or a number of up to 15 digits.
sandboxYesREQUIRED. true = validate and price the message only: nothing is sent and no credits are used. false = really send the SMS and use credits. Use true first unless the user clearly asked to send now.
scheduleNoSend later: a UNIX timestamp, ISO 8601 (2026-12-25T09:00:00+00:00) or plain English ('2 weeks'). Must be in the future.
timezoneNoTimezone for `schedule` (default UTC).
country_codeNoCountry calling code of the recipient (e.g. 44), when `to` has no country code.
external_referenceNoYour own reference for this SMS (e.g. an order number); shown in reports.
voodoosms_update_contact_listRename a contact list or add contacts
Destructive
Inspect

WRITE: renames a contact list and/or adds up to 500 contacts to it (existing contacts are not removed). Adding dynamic data needs a list created as dynamic. It does not send anything. Voodoo SMS REST: PUT /contacts/{contact_list_id}.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoNew list name, at most 32 characters.
contactsNoContacts to add: [{number, dynamic_data?}].
contact_list_idYesThe contact list id (id from list_contact_lists).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 13 tool updates
    • First observedvoodoosms_add_to_blacklist
    • First observedvoodoosms_cancel_scheduled_message
    • First observedvoodoosms_create_contact_list
    • First observedvoodoosms_get_contact_list
    • First observedvoodoosms_get_credits
    • First observedvoodoosms_list_blacklist
    • First observedvoodoosms_list_contact_lists
    • First observedvoodoosms_list_delivery_reports
    • First observedvoodoosms_list_inbox
    • First observedvoodoosms_list_numbers
    • First observedvoodoosms_list_scheduled_messages
    • First observedvoodoosms_send_sms
    • First observedvoodoosms_update_contact_list

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Enables management of Crazytel telephony and SMS services, including balance checks, DIDs, SIP trunks, verified caller IDs, SMS sending/bulk/scheduling, and SMS Center conversations, contacts, lists, opt-outs, and stats.
    42
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables sending SMS messages and checking delivery status and credit balance via the web2sms.ro Romanian SMS gateway.
    3
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to send and schedule SMS, send bulk messages, verify one-time codes, check delivery status, and retrieve credit from a Czech SMS gateway.
    208 npm
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.