# TextUs MCP by usefulapi

> TextUs MCP by usefulapi is a freemium MCP server for communication. Hosted MCP connector to read and act on TextUs texts, contacts and campaigns from AI. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, macOS, Windows, Linux
- **Website:** https://usefulapi.io/textus/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/textus
- **MCP Registry name:** io.usefulapi/textus
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README describes a hosted remote server, so there is nothing to install locally. You add its URL to an AI client such as Claude, ChatGPT or Cursor, then sign in with a TextUs API token generated in your TextUs profile settings. Once connected, the assistant can read inboxes, search contacts and notes, review bulk campaign results and list opted-out numbers.

The server exposes 28 tools in total. Of these, 21 are read-only, three can create contacts, add notes or send a real SMS, and four handle usage metering, feature requests and subscriptions. The site says the send tool requires the recipients and text to be shown before it runs, and the README notes that clients typically ask for confirmation of write actions.

The listing is aimed at teams that text customers, leads or clients from a TextUs inbox and want an assistant to summarise conversations or check campaign performance. usefulapi states it is an independent service, not affiliated with TextUs, and the server only sees data the signed-in account can access.

## Features

- **Inbox and conversation access:** Lists unread conversations, searches by phone number or text, and reads message timelines with delivery state.
- **Contact search and notes:** Finds contacts by name or number, reads their data and tags, and adds internal notes the contact cannot see.
- **Campaign reporting:** Lists bulk message campaigns and returns recipient counts and aggregated delivery statistics.
- **Opt-out lookup:** Searches phone numbers that opted out of messages so they can be excluded before a send.
- **Broad client support:** Connects through a remote Streamable HTTP endpoint with OAuth login, including Claude, ChatGPT, Cursor and VS Code.
- **Free tier with usage meter:** Free plan includes 50 tool calls a month, with paid Pro and Pro+ plans for higher limits.

## Good for

- Summarise the unread conversations in a shared TextUs inbox each morning
- Look up a contact's message history before returning a call
- Review delivery and reply counts for a recent bulk SMS campaign
- Check for opted-out numbers before building a group message
- Add a new lead as a contact and record context in a note

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://textus.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "textus": {
      "url": "https://textus.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## FAQ

### Is this an official TextUs product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by TextUs.

### What do I need to connect?

The login page asks for a TextUs API token, which you create under Profile, Advanced user settings, API Tokens.

### Can the AI change my TextUs data?

Yes, if you approve it. Three of the 28 tools can create or change data; the rest are marked read-only.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is TextUs MCP by usefulapi free?

TextUs MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### 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

### What are the best alternatives to TextUs MCP by usefulapi?

The closest alternatives to TextUs MCP by usefulapi are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/textus-mcp-by-usefulapi
