trumpia_add_subscriptions

WRITE: 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 contract. Returns a request_id; check trumpia_get_request_report. PUT /subscription.

destructive

Argument	Type	Description
list_names*	array	Names of existing distribution lists to add the contacts to.
subscriptions*	array	1-100 contacts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_names",
    "subscriptions"
  ],
  "properties": {
    "list_names": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 30,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Names of existing distribution lists to add the contacts to."
    },
    "subscriptions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "maxLength": 200
          },
          "mobile": {
            "type": "object",
            "required": [
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "pattern": "^\\d{4,20}$",
                "description": "Mobile number, digits only (US: 10 digits)."
              },
              "country_code": {
                "type": "string",
                "pattern": "^\\d{1,4}$",
                "description": "Country code (default 1)."
              }
            }
          },
          "landline": {
            "type": "object",
            "required": [
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "pattern": "^\\d{4,20}$",
                "description": "Landline number, digits only (10 digits)."
              },
              "country_code": {
                "type": "string",
                "pattern": "^\\d{1,4}$"
              }
            }
          },
          "last_name": {
            "type": "string",
            "maxLength": 100
          },
          "customdata": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "customdata_id",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "string",
                  "maxLength": 4000,
                  "minLength": 1,
                  "description": "The value; its format depends on the field type."
                },
                "customdata_id": {
                  "type": "string",
                  "pattern": "^\\d{1,20}$",
                  "description": "Custom data field id (from trumpia_list_custom_fields)."
                }
              }
            },
            "maxItems": 50
          },
          "first_name": {
            "type": "string",
            "maxLength": 100
          },
          "voice_device": {
            "enum": [
              "mobile",
              "landline"
            ],
            "type": "string",
            "description": "Number to reach by voice (US, Canada, Guam, Puerto Rico)."
          }
        }
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "1-100 contacts."
    }
  }
}

trumpia_cancel_scheduled_message

WRITE: 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}.

destructive

Argument	Type	Description
message_id*	string	Scheduled message id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Scheduled message id."
    }
  }
}

trumpia_create_list

WRITE: 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.

destructive

Argument	Type	Description
frequency*	integer	Messages per month subscribers will receive (disclosure required by mobile regulations).
list_name*	string	List name (no spaces or special characters), e.g. GeneralList.
description*	string	What the list sends, e.g. 'promo alerts' (max 20 characters).
display_name*	string	Name subscribers see when they sign up (max 50 characters).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_name",
    "display_name",
    "frequency",
    "description"
  ],
  "properties": {
    "frequency": {
      "type": "integer",
      "maximum": 999,
      "minimum": 1,
      "description": "Messages per month subscribers will receive (disclosure required by mobile regulations)."
    },
    "list_name": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "List name (no spaces or special characters), e.g. GeneralList."
    },
    "description": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "What the list sends, e.g. 'promo alerts' (max 20 characters)."
    },
    "display_name": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "description": "Name subscribers see when they sign up (max 50 characters)."
    }
  }
}

trumpia_get_credit_balance

The account's remaining domestic and international text credits. GET /balance/credit.

read-only

No arguments.

Input schema (JSON)

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

trumpia_get_custom_field

One custom data field: type, options (allowed values, max length), whether required, and its mail-merge text. GET /customdata/{customdata_id}.

read-only

Argument	Type	Description
customdata_id*	string	Custom data field id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "customdata_id"
  ],
  "properties": {
    "customdata_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Custom data field id."
    }
  }
}

trumpia_get_keyword

One mobile keyword in detail: auto-response message, code, alternative messages. GET /keyword/{keyword_id}.

read-only

Argument	Type	Description
keyword_id*	string	Keyword id (from trumpia_list_keywords).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "keyword_id"
  ],
  "properties": {
    "keyword_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Keyword id (from trumpia_list_keywords)."
    }
  }
}

trumpia_get_list

One distribution list: display name, description, message frequency and subscription / mobile / email counts. GET /list/{list_id}.

read-only

Argument	Type	Description
list_id*	string	Distribution list id (from trumpia_list_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Distribution list id (from trumpia_list_lists)."
    }
  }
}

trumpia_get_message

Delivery 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}.

read-only

Argument	Type	Description
message_id*	string	Message id returned by trumpia_send_message.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Message id returned by trumpia_send_message."
    }
  }
}

trumpia_get_request_report

The 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}.

read-only

Argument	Type	Description
request_id*	string	The request_id from a write reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "request_id"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The request_id from a write reply."
    }
  }
}

trumpia_get_subscription

One subscription (contact): name, email, mobile and landline (with verified flags), list ids, created date and custom data. Contains personal data. GET /subscription/{subscription_id}.

read-only

Argument	Type	Description
subscription_id*	string	Subscription id (from a list or search).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subscription_id"
  ],
  "properties": {
    "subscription_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Subscription id (from a list or search)."
    }
  }
}

trumpia_list_custom_fields

All custom data fields (id and name) that can be stored on subscriptions and used as mail-merge values. GET /customdata.

read-only

No arguments.

Input schema (JSON)

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

trumpia_list_email_senders

Registered 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.

read-only

No arguments.

Input schema (JSON)

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

trumpia_list_keywords

All mobile keywords with id, keyword and the short or long code. GET /keyword.

read-only

No arguments.

Input schema (JSON)

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

trumpia_list_lists

All distribution lists (id and name). Lists group subscriptions for targeted messages. GET /list.

read-only

No arguments.

Input schema (JSON)

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

trumpia_list_org_names

Registered 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.

read-only

No arguments.

Input schema (JSON)

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

trumpia_list_scheduled_messages

Messages 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.

read-only

Argument	Type	Description
limit	integer	Messages to return, 1-1000 (default 50).
order	string	scheduled_at = oldest first (default), -scheduled_at = newest first.
offset	integer	Messages to skip (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": "Messages to return, 1-1000 (default 50)."
    },
    "order": {
      "enum": [
        "scheduled_at",
        "-scheduled_at"
      ],
      "type": "string",
      "description": "scheduled_at = oldest first (default), -scheduled_at = newest first."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Messages to skip (default 0)."
    }
  }
}

trumpia_list_subscriptions

Subscription (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.

read-only

Argument	Type	Description
page	integer	Page number from 1 (default 1).
row_size	integer	Ids per page, 100-10000 (default 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number from 1 (default 1)."
    },
    "row_size": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 100,
      "description": "Ids per page, 100-10000 (default 100)."
    }
  }
}

trumpia_search_subscriptions

Find 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.

read-only

Argument	Type	Description
page	integer	Page number from 1 (default 1).
list_id	string	Limit the search to this distribution list.
row_size	integer	Ids per page, 100-10000 (default 100).
search_data*	string	The value to find, or 'all' (every subscription that has data of that type; email, mobile and landline only). For search_type created_date a range is required: 'YYYY-MM-DD hh:mm:ss~YYYY-MM-DD hh:mm:ss', e.g. '2026-03-01 00:00:00~2026-04-01 00:00:00'.
search_type*	string	Which field to search.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "search_type",
    "search_data"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number from 1 (default 1)."
    },
    "list_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Limit the search to this distribution list."
    },
    "row_size": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 100,
      "description": "Ids per page, 100-10000 (default 100)."
    },
    "search_data": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The value to find, or 'all' (every subscription that has data of that type; email, mobile and landline only). For search_type created_date a range is required: 'YYYY-MM-DD hh:mm:ss~YYYY-MM-DD hh:mm:ss', e.g. '2026-03-01 00:00:00~2026-04-01 00:00:00'."
    },
    "search_type": {
      "enum": [
        "email",
        "mobile",
        "landline",
        "country_code",
        "created_date",
        "first_name",
        "last_name"
      ],
      "type": "string",
      "description": "Which field to search."
    }
  }
}

trumpia_send_message

WRITE, 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). Confirm the recipients and text with the user first. Mail merge tokens: [$FirstName], [$LastName], [$FullName], [$CustomData-NAME]. Returns request_id and message_id. PUT /message.

destructive

Argument	Type	Description
sms	string	SMS text (140 bytes per segment in US/Canada, up to 980 bytes concatenated).
send_date	string	Schedule time as YYYY-MM-DD hh:mm:ss (24-hour clock; the account's time zone). Omit to send immediately.
email_body	string	Email body (needs email_subject).
description*	string	Internal description of the message.
org_name_id	string	Organization name id to include in the mobile message (default organization name if omitted).
email_subject	string	Email subject (needs email_body).
recipient_ids*	array

trumpia_send_sms

WRITE, 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 request_id and sms_id. PUT /sms.

destructive

Argument	Type	Description
sender	string	Short/long code or registered landline to send from (default: the account's code).
message*	string	The text (the SMS header and footer count toward the length).
org_name_id	string	Organization name id (default organization name if omitted).
country_code	string	Country code (default 1). 0 = infer it from the number, which then must start with +.
mobile_number*	string	US: the 10-digit number without leading 0 or 1. With country_code 0 the number must be E.164 with a leading +, e.g. +17774443210.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mobile_number",
    "message"
  ],
  "properties": {
    "sender": {
      "type": "string",
      "pattern": "^\\d{4,20}$",
      "description": "Short/long code or registered landline to send from (default: the account's code)."
    },
    "message": {
      "type": "string",
      "maxLength": 980,
      "minLength": 1,
      "description": "The text (the SMS header and footer count toward the length)."
    },
    "org_name_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Organization name id (default organization name if omitted)."
    },
    "country_code": {
      "type": "string",
      "pattern": "^\\d{1,4}$",
      "description": "Country code (default 1). 0 = infer it from the number, which then must start with +."
    },
    "mobile_number": {
      "type": "string",
      "pattern": "^\\+?\\d{4,20}$",
      "description": "US: the 10-digit number without leading 0 or 1. With country_code 0 the number must be E.164 with a leading +, e.g. +17774443210."
    }
  }
}

trumpia_update_list

WRITE: change a distribution list's name, display name, frequency or description. Only the fields you pass change. POST /list/{list_id}.

destructive

Argument	Type	Description
list_id*	string	Distribution list id.
frequency	integer
list_name	string
description	string
display_name	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Distribution list id."
    },
    "frequency": {
      "type": "integer",
      "maximum": 999,
      "minimum": 1
    },
    "list_name": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1
    },
    "description": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1
    },
    "display_name": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1
    }
  }
}

trumpia_update_subscription

WRITE: 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}.

destructive

Argument	Type	Description
email	string
mobile	object
landline	object
last_name	string
customdata	array
first_name	string
list_names	array	Existing distribution list names the contact should be added to.
subscription_id*	string	Subscription id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subscription_id"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 200
    },
    "mobile": {
      "type": "object",
      "required": [
        "number"
      ],
      "properties": {
        "number": {
          "type": "string",
          "pattern": "^\\d{4,20}$",
          "description": "Mobile number, digits only (US: 10 digits)."
        },
        "country_code": {
          "type": "string",
          "pattern": "^\\d{1,4}$",
          "description": "Country code (default 1)."
        }
      }
    },
    "landline": {
      "type": "object",
      "required": [
        "number"
      ],
      "properties": {
        "number": {
          "type": "string",
          "pattern": "^\\d{4,20}$",
          "description": "Landline number, digits only (10 digits)."
        },
        "country_code": {
          "type": "string",
          "pattern": "^\\d{1,4}$"
        }
      }
    },
    "last_name": {
      "type": "string",
      "maxLength": 100
    },
    "customdata": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "customdata_id",
          "value"
        ],
        "properties": {
          "value": {
            "type": "string",
            "maxLength": 4000,
            "minLength": 1,
            "description": "The value; its format depends on the field type."
          },
          "customdata_id": {
            "type": "string",
            "pattern": "^\\d{1,20}$",
            "description": "Custom data field id (from trumpia_list_custom_fields)."
          }
        }
      },
      "maxItems": 50
    },
    "first_name": {
      "type": "string",
      "maxLength": 100
    },
    "list_names": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 30,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Existing distribution list names the contact should be added to."
    },
    "subscription_id": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Subscription id."
    }
  }
}

Trumpia MCP by usefulapi

Try it

trumpia_add_subscriptions

Trumpia MCP by usefulapi

Try it

trumpia_add_subscriptions

Tools (22)