Trumpia MCP by usefulapi

io.usefulapi/trumpia · v1.0.0 · communication

Trumpia MCP by usefulapi is healthy: it completed an MCP handshake in 972 ms and exposes 22 tools.

Read Trumpia lists, subscribers, keywords and reports; add contacts and send SMS or email campaigns.

Endpoint: https://trumpia.usefulapi.io/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count22
Latency972 ms
Last checked (UTC)2026-10-20T22:21:00.326Z

Health history

Checked (UTC)StatusLatencyError
2026-10-20T22:21:00.326ZHealthy972

Tools (22)

trumpia_get_credit_balanceThe account's remaining domestic and international text credits. GET /balance/credit.
trumpia_get_request_reportThe outcome of an earlier write request (list/contact/message changes are processed asynchronously). Pass the request_id that the write tool returned; the reply holds the result (for example the new list_id) or says it is still processing or failed. GET /report/{request_id}.
trumpia_list_listsAll distribution lists (id and name). Lists group subscriptions for targeted messages. GET /list.
trumpia_get_listOne distribution list: display name, description, message frequency and subscription / mobile / email counts. GET /list/{list_id}.
trumpia_create_listWRITE: create a distribution list. Trumpia requires disclosing how often subscribers get messages and what for. Returns request_id and list_id. The list name must not contain spaces or special characters. PUT /list.
trumpia_update_listWRITE: change a distribution list's name, display name, frequency or description. Only the fields you pass change. POST /list/{list_id}.
trumpia_list_subscriptionsSubscription (contact) ids, newest first. Returns ids only; use trumpia_get_subscription for the details. Pages of 100-10000 ids; next_page is set when a full page came back. GET /subscription.
trumpia_get_subscriptionOne subscription (contact): name, email, mobile and landline (with verified flags), list ids, created date and custom data. Contains personal data. GET /subscription/{subscription_id}.
trumpia_search_subscriptionsFind subscription ids by email, mobile number, landline, country code, created date, first name or last name; optionally within one list. search_data 'all' returns every subscription that has data of that type. Returns ids; use trumpia_get_subscription for details. GET /subscription/search.
trumpia_add_subscriptionsWRITE: add contacts to one or more distribution lists (comma-separated list names that already exist). Each contact needs a mobile number, an email or a landline. Only add people who gave express consent to receive messages (TCPA, CAN-SPAM, CTIA rules apply); Trumpia may require a submitted API cont
trumpia_update_subscriptionWRITE: change a contact's name, email, mobile, landline, custom data or list membership. Only the fields you pass change. Returns a request_id. POST /subscription/{subscription_id}.
trumpia_list_custom_fieldsAll custom data fields (id and name) that can be stored on subscriptions and used as mail-merge values. GET /customdata.
trumpia_get_custom_fieldOne custom data field: type, options (allowed values, max length), whether required, and its mail-merge text. GET /customdata/{customdata_id}.
trumpia_list_keywordsAll mobile keywords with id, keyword and the short or long code. GET /keyword.
trumpia_get_keywordOne mobile keyword in detail: auto-response message, code, alternative messages. GET /keyword/{keyword_id}.
trumpia_list_org_namesRegistered organization names as { org_names: [ { org_name_id, name, default } ] } (Trumpia returns a bare array; it is wrapped). The id can be set as org_name_id on messages. GET /orgname.
trumpia_list_email_sendersRegistered email sender addresses (the From / Reply-To addresses allowed for email messages) as { senders: [ { sender_id, address, default } ] } (Trumpia returns a bare array; it is wrapped). GET /email/sender.
trumpia_get_messageDelivery statistics of a message sent with trumpia_send_message: status (sent / scheduled / canceled), totals, sent and failed counts per channel and credits used. GET /message/{message_id}.
trumpia_list_scheduled_messagesMessages that are scheduled and not yet sent (id, description, scheduled time, recipient counts). Use offset and limit to page; total_count says how many exist. GET /message/scheduled.
trumpia_send_messageWRITE, SENDS REAL MESSAGES that spend credits and cannot be recalled once sent: send an SMS and/or an email to distribution lists or specific subscriptions, now or scheduled (a scheduled one can be cancelled with trumpia_cancel_scheduled_message). Subscribers must have opted in (TCPA, CAN-SPAM, CTIA
trumpia_send_smsWRITE, SENDS A REAL TEXT that spends a credit and cannot be recalled: one SMS to one mobile number without adding the contact first. The recipient must have consented; Trumpia may require API Certification for contacts that have not opted in. Confirm number and text with the user first. Returns requ
trumpia_cancel_scheduled_messageWRITE: cancel a message that is scheduled and has not been sent yet (see trumpia_list_scheduled_messages). Does nothing for a message already sent. DELETE /message/scheduled/{message_id}.