text_em_all_add_account_user

MUTATES Text-Em-All data: adds a new user to your account (a master user can do this). Text-Em-All API: POST /v1/account/users. Provide the user's fields via `fields` using the API's PascalCase names (e.g. UserName, FirstName, LastName, EmailAddress, Permissions). Returns the created user.

destructive

Argument	Type	Description
fields	object	Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.
lastName	string	Last name (LastName).
userName	string	The new user's login username (UserName).
firstName	string	First name (FirstName).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "fields": {
      "type": "object",
      "description": "Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "lastName": {
      "type": "string",
      "description": "Last name (LastName)."
    },
    "userName": {
      "type": "string",
      "description": "The new user's login username (UserName)."
    },
    "firstName": {
      "type": "string",
      "description": "First name (FirstName)."
    }
  }
}

text_em_all_create_broadcast

MUTATES Text-Em-All data AND SENDS MESSAGES (spends account credits): creates + sends a broadcast to the given contacts. Text-Em-All API: POST /v1/broadcasts. Set broadcastType to 'SMS' (a text broadcast — provide textMessage) or 'Announcement' (a voice broadcast — provide voiceText for text-to-speech, or a pre-recorded AudioID via `fields.Audio`). Contacts is a list of { primaryPhone, firstName?, lastName?, notes? }. Extra documented fields (CallerID, TextNumberID, Lists, RetryTimes, CallThrottle, MaxMessageLength, StartDate, CheckCallingWindow) go through `fields` (PascalCase). Returns the created broadcast.

destructive

Argument	Type	Description
fields	object	Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.
contacts*	array	Recipients (each needs primaryPhone). Required.
voiceText	string	Text-to-speech message for an Announcement broadcast (mapped to Audio.TextToSpeech=true + Audio.Text).
textMessage	string	The text body for an SMS broadcast (TextMessage). Required when broadcastType='SMS'.
broadcastName*	string	A name/label for this broadcast (BroadcastName). Required.
broadcastType

text_em_all_create_draft_broadcast

MUTATES Text-Em-All data (creates a DRAFT — does NOT send anything): stages a broadcast with the given contacts and returns a single-sign-on URL to finish + send it in the Text-Em-All UI. Safer than text_em_all_create_broadcast when a human should review before sending. Text-Em-All API: POST /v1/draftbroadcasts. Returns { SingleSignOnUrl, ... }.

destructive

Argument	Type	Description
fields	object	Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.
contacts*	array	Contacts to pre-populate on the draft broadcast (each needs primaryPhone). Required.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contacts"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "primaryPhone"
        ],
        "properties": {
          "notes": {
            "type": "string",
            "description": "Free-text notes about the contact (Person.Notes)."
          },
          "lastName": {
            "type": "string",
            "description": "Contact last name (Person.LastName)."
          },
          "firstName": {
            "type": "string",
            "description": "Contact first name (Person.FirstName)."
          },
          "primaryPhone": {
            "type": "string",
            "description": "The contact's phone number (Person.PrimaryPhone). Required."
          }
        }
      },
      "minItems": 1,
      "description": "Contacts to pre-populate on the draft broadcast (each needs primaryPhone). Required."
    }
  }
}

text_em_all_get_account

Fetch your Text-Em-All account settings — company/billing info plus credit balances (AvailableCallUnits, CallBalance) used for sending. Text-Em-All API: GET /v1/account. Use this first to confirm your credentials work.

read-only

No arguments.

Input schema (JSON)

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

text_em_all_get_authorization_token

Exchange a Text-Em-All account username + PIN/password for that user's authorization token (the value you set as TEXTEMALL_AUTH_TOKEN). Text-Em-All API: POST /v1/user/login. Signed with your App/Secret key only (no user token yet). Returns { AuthToken }. Use this once to bootstrap; store the token in config thereafter.

read-only

Argument	Type	Description
password*	string	The Text-Em-All website login PIN/password. Required.
username*	string	The Text-Em-All website login username. Required.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "username",
    "password"
  ],
  "properties": {
    "password": {
      "type": "string",
      "description": "The Text-Em-All website login PIN/password. Required."
    },
    "username": {
      "type": "string",
      "description": "The Text-Em-All website login username. Required."
    }
  }
}

text_em_all_get_broadcast

Fetch a single broadcast by id, including its status and summary. Text-Em-All API: GET /v1/broadcasts/{id}.

read-only

Argument	Type	Description
id*	string \| number	The BroadcastID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": [
        "string",
        "number"
      ],
      "description": "The BroadcastID."
    }
  }
}

text_em_all_get_broadcast_details

Fetch per-contact delivery details/results for a broadcast (who was reached, delivery status). Text-Em-All API: GET /v1/broadcasts/{id}/details.

read-only

Argument	Type	Description
id*	string \| number	The BroadcastID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": [
        "string",
        "number"
      ],
      "description": "The BroadcastID."
    }
  }
}

text_em_all_get_conversations_sso_url

Generate a single-sign-on URL to the Text-Em-All conversations UI (open in a browser/iframe). Optionally scope it to one conversation thread by passing a toll-free textNumber + the other phoneNumber. Text-Em-All API: POST /v1/singlesignon/conversations. Returns { Url }. No account data is changed.

read-only

Argument	Type	Description
textNumber	string	A toll-free text number on the account, e.g. 18885551234.
phoneNumber	string	A phone number that has a conversation with the text number, e.g. 9725551212.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "textNumber": {
      "type": "string",
      "description": "A toll-free text number on the account, e.g. 18885551234."
    },
    "phoneNumber": {
      "type": "string",
      "description": "A phone number that has a conversation with the text number, e.g. 9725551212."
    }
  }
}

text_em_all_list_broadcasts

List broadcasts (text + voice campaigns) as a paged Feed { Size, Items:[...], Previous, Next }. Text-Em-All API: GET /v1/broadcasts. Filter with equals-style `params` (e.g. BroadcastStatus=Complete) and order with `sortby`. For date-range operators (StartDate~gte~2024-01-01) use the text_em_all_request escape hatch.

read-only

Argument	Type	Description
page	integer	1-based page number (Feed `page`).
params	object	Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.
sortby	string	Comma-separated fields to sort by; prefix a field with '-' for descending (e.g. '-StartDate,CreatedDate').
pagesize	integer	Number of items per page (Feed `pagesize`, default 10).
takesize	integer	How many items to return (Feed `takesize`; defaults to pagesize).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number (Feed `page`)."
    },
    "params": {
      "type": "object",
      "description": "Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "sortby": {
      "type": "string",
      "description": "Comma-separated fields to sort by; prefix a field with '-' for descending (e.g. '-StartDate,CreatedDate')."
    },
    "pagesize": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Number of items per page (Feed `pagesize`, default 10)."
    },
    "takesize": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "How many items to return (Feed `takesize`; defaults to pagesize)."
    }
  }
}

text_em_all_list_lists

List saved contact lists (groups you can broadcast to) as a Feed; each List has a ListID/ListName. Text-Em-All API: GET /v1/lists. NOTE: inferred from the API's List model — if your account/endpoint differs, use the text_em_all_request escape hatch.

read-only

Argument	Type	Description
page	integer	1-based page number (Feed `page`).
params	object	Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.
pagesize	integer	Number of items per page (Feed `pagesize`, default 10).
takesize	integer	How many items to return (Feed `takesize`; defaults to pagesize).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number (Feed `page`)."
    },
    "params": {
      "type": "object",
      "description": "Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "pagesize": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Number of items per page (Feed `pagesize`, default 10)."
    },
    "takesize": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "How many items to return (Feed `takesize`; defaults to pagesize)."
    }
  }
}

text_em_all_list_text_numbers

List the toll-free text (SMS) numbers on your account as a Feed. Each TextNumber has a TextNumberID you need to send a 1:1 conversation text (see text_em_all_send_text_message). Text-Em-All API: GET /v1/textnumbers.

read-only

Argument	Type	Description
page	integer	1-based page number (Feed `page`).
params	object	Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.
pagesize	integer	Number of items per page (Feed `pagesize`, default 10).
takesize	integer	How many items to return (Feed `takesize`; defaults to pagesize).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "1-based page number (Feed `page`)."
    },
    "params": {
      "type": "object",
      "description": "Additional documented equals-style query filters to send verbatim (e.g. BroadcastStatus=Completed). For range operators (Field~gte~value etc.) use the text_em_all_request escape hatch. Merged with paging above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "pagesize": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Number of items per page (Feed `pagesize`, default 10)."
    },
    "takesize": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "How many items to return (Feed `takesize`; defaults to pagesize)."
    }
  }
}

text_em_all_request

Power-user escape hatch: GET any Text-Em-All API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the origin, starting with a slash, INCLUDING any query string, e.g. "/v1/broadcasts?StartDate~gte~2024-01-01&sortby=-StartDate" or "/v1/textnumbers". Returns the parsed JSON.

read-only

Argument	Type	Description
path*	string	Full API path after the origin, starting with "/", e.g. "/v1/broadcasts?pagesize=50".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Full API path after the origin, starting with \"/\", e.g. \"/v1/broadcasts?pagesize=50\"."
    }
  }
}

text_em_all_send_text_message

MUTATES Text-Em-All data AND SENDS A TEXT (spends credits): sends a 1:1 conversation text message immediately from one of your toll-free text numbers to a single contact. Text-Em-All API: POST /v1/conversations. You need a textNumberId (from text_em_all_list_text_numbers). Returns the conversation.

destructive

Argument	Type	Description
fields	object	Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.
message*	string	The text message body. Required.
lastName	string	Recipient last name (Contact.LastName).
firstName	string	Recipient first name (Contact.FirstName).
phoneNumber*	string	The recipient's phone number (e.g. 9725551212). Required.
textNumberId*	string \| number	The TextNumberID of the toll-free number to send from (see text_em_all_list_text_numbers). Required.
truncateIfExceedsLimit	boolean

text_em_all_update_account_user

MUTATES Text-Em-All data: updates an existing account user. Text-Em-All API: PUT /v1/account/users/{user_id}. Provide the fields to change via `fields` (PascalCase, e.g. FirstName, LastName, EmailAddress, Permissions). The user_id is never sent in the body. Returns the updated user.

destructive

Argument	Type	Description
fields	object	Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.
user_id*	string \| number	The id of the user to update (path only). Required.
lastName	string	New last name (LastName).
firstName	string	New first name (FirstName).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "user_id"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Additional documented Text-Em-All fields to send verbatim in the JSON write body, using the API's PascalCase names (e.g. CallerID, TextNumberID, Lists, RetryTimes). Merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "user_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "The id of the user to update (path only). Required."
    },
    "lastName": {
      "type": "string",
      "description": "New last name (LastName)."
    },
    "firstName": {
      "type": "string",
      "description": "New first name (FirstName)."
    }
  }
}

Text-Em-All MCP by usefulapi

Try it

text_em_all_add_account_user Destructive

Text-Em-All MCP by usefulapi

Try it

text_em_all_add_account_user Destructive

Tools (14)