Skip to content
MCP server

TextUs MCP by usefulapi

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

Install
Runs
Remotely
Version
1.10.0
Listing updated
5 days ago

About TextUs MCP by usefulapi

TextUs MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http textus https://textus.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://textus.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "textus": {
      "url": "https://textus.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "textus": {
      "type": "http",
      "url": "https://textus.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "textus": {
      "serverUrl": "https://textus.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (24)

Read directly from the server.

textus_get_profile
Get the profile of the user who owns the API token, including account memberships and roles. TextUs API: GET /profile.
textus_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.
textus_get_account
Get one account by slug: name, phone numbers, type and links. TextUs API: GET /accounts/{account}.
textus_list_account_users
List the users who belong to an account. TextUs API: GET /{account}/users.
textus_list_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.
textus_list_contact_filters
List the saved contact filters (views) of an account. TextUs API: GET /{account}/contact_filters.
textus_get_contact
Get all known data about one contact: name, phone numbers, custom data and tags. TextUs API: GET /contacts/{contact}.
textus_list_contact_notes
List the notes users wrote about a contact. TextUs API: GET /contacts/{contact}/notes.
textus_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.
textus_list_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.
textus_get_conversation
Get one conversation: contact, assigned users, state and last message. TextUs API: GET /conversations/{conversation}.
textus_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.
textus_get_conversation_stats
Get stats for one conversation: start time, engagement grade and outbound delivery percentage. TextUs API: GET /conversations/{conversation}/stats.
textus_list_campaign_filters
List the campaign views of an account (for example mine, all). TextUs API: GET /{account}/campaign_filters.
textus_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.
textus_get_campaign
Get one campaign: message body, state, schedule and recipient counts. TextUs API: GET /campaigns/{campaign}.
textus_get_campaign_analytics
Get aggregated statistics (campaigns sent, recipients, delivery) for all campaigns of an account. TextUs API: GET /{account}/campaigns/analytics.
textus_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.
textus_list_group_contacts
List the contacts that belong to a group. TextUs API: GET /groups/{group}/contacts.
textus_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.
textus_list_saved_replies
List the canned message bodies a user saved. TextUs API: GET /users/{user}/saved_replies.
textus_send_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.
textus_create_contact
WRITE: creates a new contact in an account. TextUs API: POST /{account}/contacts.
textus_add_contact_note
WRITE: adds an internal note to a contact. The contact does not see it. TextUs API: POST /contacts/{contact}/notes.

TextUs MCP by usefulapi FAQ

How do I add TextUs MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http textus https://textus.usefulapi.io/mcp