io.usefulapi/superphone

up checked 2026-11-11T12:37:49.885Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

SuperPhone MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Lets agents manage SMS contacts, tags, purchases, inbox conversations and opt-in forms, and send consent-based texts.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add superphone --url https://superphone.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "superphone": {
      "url": "https://superphone.usefulapi.io/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (17 tools)

Publisher-provided text

superphone_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 preferen
superphone_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
superphone_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_con
superphone_find_contact 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 mat
superphone_list_conversations List text conversations (the inbox): id, participant number, platform (TWILIO = SMS, FACEBOOK = Messenger), hidden/archived flags, creation date and the contact
superphone_get_conversation One conversation with its most recent messages (default 20, newest last): body, from/to, direction (INCOMING_TEXT, OUTGOING_TEXT, SYSTEM, calls), delivery statu
superphone_get_message One message by id: body, from/to, direction, delivery status, error and media. GraphQL query `message`.
superphone_list_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 `f
superphone_get_form One sign-up form by id, or the account's default form when form_id is omitted. GraphQL queries `form` / `defaultForm`.
superphone_list_webhooks List the configured webhooks: id, destination URL, active flag and subscribed events (CONTACT_ADDED, CONTACT_UPDATED, CONTACT_TAGS_CHANGED, MESSAGE_RECEIVED, ME
superphone_search_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 to
superphone_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
superphone_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
superphone_add_contact_tags 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.
superphone_remove_contact_tags 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 rema
superphone_add_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
superphone_send_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 can

Details

Version: 1.8.3
Transports: streamable-http
Uptime (7 days): 100%
Median latency: 400 ms
First indexed: 2026-11-01T10:06:26.318Z
Last seen in registry: 2026-11-11T00:17:35.086Z
Repository: https://github.com/m190/usefulapi-mcp
Website: https://usefulapi.io/superphone/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/superphone.svg)](https://lookupd.com/servers/io.usefulapi/superphone)

62071 servers
Last crawl: 2026-11-11T16:39:06.253Z
API base: https://api.lookupd.com
MCP URL: https://api.lookupd.com/mcp