Voodoo SMS MCP by usefulapi
Server Details
Read Voodoo SMS credits, reports, inbox and lists; send one SMS; manage the opt-out blacklist.
- 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 toolsvoodoosms_add_to_blacklistAdd a number to the blacklistDestructiveInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| number | Yes | Phone number in international format with the country code and no leading 0, e.g. 447700900123. |
voodoosms_cancel_scheduled_messageCancel a scheduled SMSDestructiveInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The scheduled message id (id from list_scheduled_messages). |
voodoosms_create_contact_listCreate a contact listDestructiveInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique list name, at most 32 characters. | |
| country | No | Default country calling code for the list (default 44). | |
| contacts | Yes | Contacts to put in the list: [{number, dynamic_data?}]. | |
| description | No | Optional description. |
voodoosms_get_contact_listGet contacts in a listRead-onlyInspect
Get one contact list including its contacts (id, number, status, dynamic_data, created_at). Voodoo SMS REST: GET /contacts?contact_list_id=.
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Where to start the returned results (default 0). | |
| limit | No | Number of contacts to return (default 100, max 5000). | |
| contact_list_id | Yes | The contact list id (id from list_contact_lists). |
voodoosms_get_creditsGet credit balanceRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
voodoosms_list_blacklistList blacklisted numbersRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Newest date a number was added. | |
| skip | No | Where to start the returned results (default 0). | |
| sort | No | Sort by id, ASC or DESC (default DESC). | |
| limit | No | Number of entries to return (default 25, max 1000). | |
| start | No | Oldest date a number was added. | |
| number | No | Look up a single number (international format, e.g. 447700900123). |
voodoosms_list_contact_listsList contact listsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Where to start the returned results (default 0). | |
| limit | No | Number of lists to return (default 100, max 5000). |
voodoosms_list_delivery_reportsList delivery reportsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only messages sent to this number (international format, e.g. 447700900123). | |
| end | No | End of the date range to filter on. | |
| limit | No | Number of reports to return (default 25, max 1000). | |
| start | No | Start of the date range to filter on. | |
| status | No | Only messages with this status. | |
| sent_at | No | Only messages sent at this date/time. | |
| sender_id | No | The sender id the messages were sent with. | |
| message_id | No | The messages[].id returned when the SMS was sent. | |
| delivered_at | No | Only messages delivered at this date/time. | |
| external_reference | No | The external_reference used when sending. |
voodoosms_list_inboxList received SMSRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | The number the message was sent to: your virtual number (international format). | |
| end | No | Newest date of the messages to return. | |
| from | No | The number the message came from (international format). | |
| skip | No | Where to start the returned results (default 0). | |
| sort | No | Sort by id, ASC or DESC (default DESC). | |
| limit | No | Number of messages to return (default 25, max 1000). | |
| start | No | Oldest date of the messages to return. | |
| keyword | No | The keyword (first word of the message). | |
| reference | No | The external_reference of the original outgoing message. |
voodoosms_list_numbersList virtual mobile numbersRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
voodoosms_list_scheduled_messagesList scheduled messagesRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
voodoosms_send_smsSend an SMS to one recipientDestructiveInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ONE recipient number: international format with the country code and no leading 0 (447700900123), or a national number if country_code is given. | |
| msg | Yes | The 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). | |
| from | Yes | Sender id shown to the recipient: 4 to 11 letters/digits or a number of up to 15 digits. | |
| sandbox | Yes | REQUIRED. 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. | |
| schedule | No | Send later: a UNIX timestamp, ISO 8601 (2026-12-25T09:00:00+00:00) or plain English ('2 weeks'). Must be in the future. | |
| timezone | No | Timezone for `schedule` (default UTC). | |
| country_code | No | Country calling code of the recipient (e.g. 44), when `to` has no country code. | |
| external_reference | No | Your own reference for this SMS (e.g. an order number); shown in reports. |
voodoosms_update_contact_listRename a contact list or add contactsDestructiveInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New list name, at most 32 characters. | |
| contacts | No | Contacts to add: [{number, dynamic_data?}]. | |
| contact_list_id | Yes | The contact list id (id from list_contact_lists). |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
13 tool updates
- First observed
voodoosms_add_to_blacklist - First observed
voodoosms_cancel_scheduled_message - First observed
voodoosms_create_contact_list - First observed
voodoosms_get_contact_list - First observed
voodoosms_get_credits - First observed
voodoosms_list_blacklist - First observed
voodoosms_list_contact_lists - First observed
voodoosms_list_delivery_reports - First observed
voodoosms_list_inbox - First observed
voodoosms_list_numbers - First observed
voodoosms_list_scheduled_messages - First observed
voodoosms_send_sms - First observed
voodoosms_update_contact_list
Related MCP Connectors
Read FireText credit, messages and reports; send an SMS to up to 10 numbers; manage opt-outs.
131Read D7 Networks balance, SMS pricing and delivery status; look up numbers; send one SMS.
61Read smsmode balance, messages, replies, campaigns and usage; send SMS to up to 10 numbers.
131Read BulkSMS messages, replies, profile and webhooks; send SMS to up to 10 numbers.
81
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables 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.42MIT
- FlicenseAqualityDmaintenanceEnables sending SMS messages and checking delivery status and credit balance via the web2sms.ro Romanian SMS gateway.3-
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT
- AlicenseAqualityAmaintenanceEnables sending SMS, querying delivery reports, and managing senders and blacklists through the iletiMerkezi SMS API.1120 npm2MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.