TextUs MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.6.3Updated Nov 7, 2026

Read texts, contacts, campaigns and opt-outs; send SMS, add contacts and notes in TextUs.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for TextUs that lets an assistant read SMS conversations, contacts, groups and campaigns, and send texts or add contacts and notes.

What you can do
  • Read account and user context: profile, accounts, account users
  • Browse and search contacts, contact filters, notes, groups and opt-outs
  • List inbox views, conversations, timelines, conversation stats and saved replies
  • Review campaigns, campaign views and aggregated campaign analytics
  • Send a real SMS, create contacts and add internal contact notes
  • Check usage, request features, upgrade or cancel the subscription
When to use it
Useful when you work with a TextUs business SMS account and want an assistant to summarize inbox conversations, look up contacts or campaign delivery results, or draft and send texts without switching apps.
Requirements
A remote MCP endpoint reached over HTTP; no local install. Sign-in uses OAuth, and the login page asks for a TextUs API token (from TextUs profile advanced settings), which the server stores per user. A TextUs account is required; the free plan allows 50 tool calls per month.
Before you install
textus_send_message sends a real, irreversible SMS to one or more recipients and is never retried; confirm recipients and text first. Creating contacts and adding notes also change account data. The server stores your TextUs API token per user. Paid plans cost money (Pro $9/month or $90/year, Pro+ $39/month or $390/year) and upgrades return a Stripe Checkout link; cancellation has no refund for the current period.

Installation

In SourceWeft

  1. Open TextUs MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ftextus/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "textus-by-usefulapi": {
      "type": "http",
      "url": "https://textus.usefulapi.io/mcp"
    }
  }
}

README

TextUs MCP by usefulapi

Use your TextUs account from Claude, Cursor, or any MCP client. Read conversations, contacts and campaigns, and send texts. Hosted, no local install: connect with your own credentials.

Live endpoint: https://textus.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://textus.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http textus https://textus.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "textus": {      "url": "https://textus.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your TextUs credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/textus/

On first connect you provide a TextUs API token (TextUs → Profile → Advanced user settings → API Tokens). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
textus_get_profilereadGet my profile
textus_list_accountsreadList accounts
textus_get_accountreadGet an account
textus_list_account_usersreadList account users
textus_list_contactsreadList or search contacts
textus_list_contact_filtersreadList contact filters
textus_get_contactreadGet a contact
textus_list_contact_notesreadList contact notes
textus_list_conversation_filtersreadList conversation filters
textus_list_conversationsreadList or search conversations
textus_get_conversationreadGet a conversation
textus_get_conversation_timelinereadGet conversation timeline
textus_get_conversation_statsreadGet conversation stats
textus_list_campaign_filtersreadList campaign filters
textus_list_campaignsreadList campaigns
textus_get_campaignreadGet a campaign
textus_get_campaign_analyticsreadGet campaign analytics
textus_list_groupsreadList groups
textus_list_group_contactsreadList group contacts
textus_list_opt_outsreadList opt-outs
textus_list_saved_repliesreadList saved replies
textus_send_messagewriteSend a text message
textus_create_contactwriteCreate a contact
textus_add_contact_notewriteAdd a contact note
textus_usage_statusmetaUsage status (free-tier meter)
textus_request_featuremetaRequest a missing feature
textus_upgrademetaUpgrade to Pro or Pro+
textus_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with textus_upgrade (it returns a Stripe Checkout link). Cancel any time with textus_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running textus_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/textus/README.md at commit 4046075

Tools

24

textus_get_profile

Get my profile

Get the profile of the user who owns the API token, including account memberships and roles. TextUs API: GET /profile.

Takes no parameters.

textus_list_accounts

List accounts

List the TextUs accounts the user belongs to, with phone numbers and role. Most other tools need an account `slug` from here. TextUs API: GET /accounts.

Parameterscursor

textus_get_account

Get an account

Get one account by slug: name, phone numbers, type and links. TextUs API: GET /accounts/{account}.

Parametersaccountrequired

textus_list_account_users

List account users

List the users who belong to an account. TextUs API: GET /{account}/users.

Parameterscursoraccountrequired

textus_list_contacts

List or search contacts

List contacts of an account in alphabetical order. Use `q` to search by name or phone number. Pass a saved `contact_filter` slug for a saved view (default `all`). TextUs API: GET /{account}/contact_filters/{filter}/contacts.

Parametersqcursoraccountrequiredcontact_filter

textus_list_contact_filters

List contact filters

List the saved contact filters (views) of an account. TextUs API: GET /{account}/contact_filters.

Parameterscursoraccountrequired

textus_get_contact

Get a contact

Get all known data about one contact: name, phone numbers, custom data and tags. TextUs API: GET /contacts/{contact}.

Parameterscontactrequired

textus_list_contact_notes

List contact notes

List the notes users wrote about a contact. TextUs API: GET /contacts/{contact}/notes.

Parameterscursorcontactrequired

textus_list_conversation_filters

List conversation filters

List the conversation filters (inbox views such as unread, mine, closed) of an account, with unread counts. TextUs API: GET /{account}/conversation_filters.

Parametersaccountrequired

textus_list_conversations

List or search conversations

List conversations in an inbox view, newest message first. Use filter `search` with `q` (a phone number or text) to find a conversation. TextUs API: GET /{account}/conversation_filters/{filter}/conversations.

Parametersqcursoraccountrequiredconversation_filterrequired

textus_get_conversation

Get a conversation

Get one conversation: contact, assigned users, state and last message. TextUs API: GET /conversations/{conversation}.

Parametersconversationrequired

textus_get_conversation_timeline

Get conversation timeline

Get the messages and events of a conversation, newest first. Messages include direction, body and delivery state. TextUs API: GET /conversations/{conversation}/timeline.

Parameterscursorconversationrequired

textus_get_conversation_stats

Get conversation stats

Get stats for one conversation: start time, engagement grade and outbound delivery percentage. TextUs API: GET /conversations/{conversation}/stats.

Parametersconversationrequired

textus_list_campaign_filters

List campaign filters

List the campaign views of an account (for example mine, all). TextUs API: GET /{account}/campaign_filters.

Parametersaccountrequired

textus_list_campaigns

List campaigns

List campaigns (bulk messages) in a campaign view, ordered by scheduled time, with title, body and state. TextUs API: GET /{account}/campaign_filters/{filter}/campaigns.

Parameterscursoraccountrequiredcampaign_filter

textus_get_campaign

Get a campaign

Get one campaign: message body, state, schedule and recipient counts. TextUs API: GET /campaigns/{campaign}.

Parameterscampaignrequired

textus_get_campaign_analytics

Get campaign analytics

Get aggregated statistics (campaigns sent, recipients, delivery) for all campaigns of an account. TextUs API: GET /{account}/campaigns/analytics.

Parametersaccountrequired

textus_list_groups

List groups

List contact groups in a group folder (`mine` or account groups). Use `q` to search group names. TextUs API: GET /{account}/group_filters/{filter}/groups.

Parametersqcursoraccountrequiredgroup_filter

textus_list_group_contacts

List group contacts

List the contacts that belong to a group. TextUs API: GET /groups/{group}/contacts.

Parametersgrouprequiredcursor

textus_list_opt_outs

List opt-outs

List phone numbers that opted out of messages for an account. Use `q` for a partial search (3 digits or more). TextUs API: GET /{account}/opt_outs.

Parametersqcursoraccountrequired

textus_list_saved_replies

List saved replies

List the canned message bodies a user saved. TextUs API: GET /users/{user}/saved_replies.

Parametersuserrequiredcursor

textus_send_message

Send a text message

WRITE: sends a REAL SMS from the account's number to one or more recipients. It cannot be undone and is never retried. Show the user the recipients and text first, then call with confirm=true. TextUs API: POST /{account}/messages.

Parameterstorequiredbodyrequiredaccountrequiredconfirmrequired

textus_create_contact

Create a contact

WRITE: creates a new contact in an account. TextUs API: POST /{account}/contacts.

Parametersnamerequiredtagsphonerequiredaccountrequiredphone_typebusiness_name

textus_add_contact_note

Add a contact note

WRITE: adds an internal note to a contact. The contact does not see it. TextUs API: POST /contacts/{contact}/notes.

Parameterscontactrequiredcontentrequired

Version history

9
  1. v1.6.3LatestNov 7, 2026
  2. v1.5.3Nov 5, 2026
  3. v1.5.2Nov 5, 2026
  4. v1.5.1Nov 4, 2026
  5. v1.5.0Nov 3, 2026
  6. v1.4.1Nov 3, 2026
  7. v1.3.0Nov 1, 2026
  8. v1.1.0Oct 31, 2026
  9. v1.0.0Oct 31, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations