SuperPhone MCP by usefulapi

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

MCP server for SuperPhone — contacts, conversations, tags and consent-based text messages.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for SuperPhone that lets an assistant read contacts, conversations and messages, manage tags, and send consent-based texts.

What you can do
  • Read the account, its phone numbers and notification preferences
  • List, look up and search contacts by mobile or email, with tags and purchase history
  • List conversations and read messages, including older pages, delivery status and media
  • Inspect sign-up forms, webhooks and purchasable phone numbers with prices
  • Create and update contacts, add or remove tags, and record purchases
  • Send a real text message from the account's number
When to use it
Useful when you want an assistant to answer questions about an SMS or Messenger inbox, look up a customer's history, or draft and send follow-up texts from a SuperPhone account without switching apps.
Requirements
Remote endpoint added by URL only; the server signs in with OAuth and the login page asks for SuperPhone credentials. No API key or Authorization header goes in the client config. A SuperPhone account is required; the free plan allows 50 tool calls per month.
Before you install
Write tools change SuperPhone data: creating and updating contacts, adding or removing tags (which can affect tag-driven automations), and recording purchases that cannot be undone here. Sending a text is irreversible, uses messaging credits and must respect unsubscribed or opted-out contacts. Paid plans are billed through a Stripe checkout link, and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open SuperPhone 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%2Fsuperphone/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": {
    "superphone-by-usefulapi": {
      "type": "http",
      "url": "https://superphone.usefulapi.io/mcp"
    }
  }
}

README

SuperPhone MCP by usefulapi

Connect your SuperPhone account.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://superphone.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http superphone https://superphone.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": {    "superphone": {      "url": "https://superphone.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 SuperPhone credentials.

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

Tools

ToolTypeWhat it does
superphone_get_accountreadGet account
superphone_list_contactsreadList contacts
superphone_get_contactreadGet contact
superphone_find_contactreadFind contact by mobile or email
superphone_list_conversationsreadList conversations
superphone_get_conversationreadGet conversation messages
superphone_get_messagereadGet message
superphone_list_formsreadList sign-up forms
superphone_get_formreadGet sign-up form
superphone_list_webhooksreadList webhooks
superphone_search_numbersreadSearch available phone numbers
superphone_create_contactwriteCreate contact
superphone_update_contactwriteUpdate contact
superphone_add_contact_tagswriteAdd tags to contact
superphone_remove_contact_tagswriteRemove tags from contact
superphone_add_contributionwriteRecord a purchase (custom contribution)
superphone_send_messagewriteSend a text message
superphone_usage_statusmetaUsage status (free-tier meter)
superphone_request_featuremetaRequest a missing feature
superphone_upgrademetaUpgrade to Pro or Pro+
superphone_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 (per verified SuperPhone user)$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 superphone_upgrade (it returns a Stripe Checkout link). Cancel any time with superphone_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running superphone_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

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

Tools

17

superphone_get_account

Get account

The Superphone account behind the API key: user id, email, name, the business phone numbers (number, default/active flags, short code) and notification preferences. GraphQL query `me`.

Takes no parameters.

superphone_list_contacts

List contacts

List the SMS contacts (the subscriber list) with name, mobile, email, company, VIP/hidden/archived/unsubscribed/opted-out flags, total spent, creation date and tags (up to 20). Oldest first; page with next_cursor. `total` is the size of the whole list. GraphQL query `contacts`.

Parametersafterpage_size

superphone_get_contact

Get contact

One contact by id with every profile field, tags, custom contributions (recorded purchases) and its latest 10 conversations (ids to read with superphone_get_conversation). GraphQL query `contact`.

Parameterscontact_idrequired

superphone_find_contact

Find contact by mobile or email

Find one contact by exact mobile number or email address (give at least one; E.164 such as +12132679977 is best). Returns the full contact or null when none matches. GraphQL query `contactByIdentifier`.

Parametersemailmobile

superphone_list_conversations

List conversations

List text conversations (the inbox): id, participant number, platform (TWILIO = SMS, FACEBOOK = Messenger), hidden/archived flags, creation date and the contact. Page with next_cursor. Read the messages of one with superphone_get_conversation. GraphQL query `conversations`.

Parametersafterpage_size

superphone_get_conversation

Get conversation messages

One conversation with its most recent messages (default 20, newest last): body, from/to, direction (INCOMING_TEXT, OUTGOING_TEXT, SYSTEM, calls), delivery status, errors and media. To read older messages pass `before` = the previous reply's previous_cursor. GraphQL query `conversation`.

Parametersbeforemessage_countconversation_idrequired

superphone_get_message

Get message

One message by id: body, from/to, direction, delivery status, error and media. GraphQL query `message`.

Parametersmessage_idrequired

superphone_list_forms

List sign-up forms

List the sign-up (opt-in) forms: id, public hashId, domain, titles, opt-in text flag, optional fields, redirect URL, default and enabled flags. GraphQL query `forms`.

Takes no parameters.

superphone_get_form

Get sign-up form

One sign-up form by id, or the account's default form when form_id is omitted. GraphQL queries `form` / `defaultForm`.

Parametersform_id

superphone_list_webhooks

List webhooks

List the configured webhooks: id, destination URL, active flag and subscribed events (CONTACT_ADDED, CONTACT_UPDATED, CONTACT_TAGS_CHANGED, MESSAGE_RECEIVED, MESSAGE_SENT, MESSAGE_STATUS_UPDATED). GraphQL query `webhooks`.

Takes no parameters.

superphone_search_numbers

Search available phone numbers

Search phone numbers that could be bought for the account, optionally starting with some digits (for example an area code), with their price. Read-only: this tool never buys a number. GraphQL query `searchNumbers`.

Parametersstarts_with

superphone_create_contact

Create contact

WRITE: create a contact (first name required; add a mobile number or email so it can be reached). Creating a contact does not send it a message. Returns the new contact. GraphQL mutation `createContact`.

Parametersvipcityemailnotesgenderhiddenmobilecompanycountrytwitterarchivedbirthday+9 more

superphone_update_contact

Update contact

WRITE: change fields of an existing contact. Only the fields you pass change: the tool first reads the contact and sends the full record back with your changes (the API requires the first name on every update). Pass an empty string to clear a text field. Returns the updated contact. GraphQL mutation `updateContact`.

Parametersvipcityemailnotesgenderhiddenmobilecompanycountrytwitterarchivedbirthday+10 more

superphone_add_contact_tags

Add tags to contact

WRITE: apply tags to a contact, by name (a new name creates the tag) or by tag id. Tags can drive automations in Superphone. Returns the contact with its tags. GraphQL mutations `addContactTagsByNames` / `addContactTags`.

Parameterstag_idstag_namescontact_idrequired

superphone_remove_contact_tags

Remove tags from contact

WRITE: remove tags from a contact, by name or by tag id. This can take the contact out of tag-driven segments and automations. Returns the contact with its remaining tags. GraphQL mutations `removeContactTagsByNames` / `removeContactTags`.

Parameterstag_idstag_namescontact_idrequired

superphone_add_contribution

Record a purchase (custom contribution)

WRITE: record a purchase or donation against a contact (name, amount, date). It adds to the contact's total spent and cannot be undone with this server. Returns the new contribution. GraphQL mutation `createCustomContribution`.

Parametersnamerequiredamountrequiredcontact_idrequiredcreated_at

superphone_send_message

Send a text message

WRITE, IRREVERSIBLE: send a real text message to a customer from the account's number. It is delivered immediately, uses the account's messaging credits and cannot be recalled. Only send what the user explicitly asked for, to the number they named, and never to contacts who unsubscribed or opted out. Give exactly one of conversation_id (reply in an existing conversation) or mobile (a number, ideally E.164 like +12132679977; without a country code Superphone assumes the US). Returns the new message id. GraphQL mutation `sendMessage`.

Parametersbodyrequiredmobileplatformconversation_id

Version history

10
  1. v1.7.4LatestNov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.1Oct 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

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Ably MCP by usefulapi's hosted MCP server, published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026