SuperPhone MCP by usefulapi

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

¿Debería usar esto?

Calidad de la descripción

98%

Integridad del esquema

85%

Calidad de los nombres

80%

Riesgo de envenenamiento

100%

Coincidencia de permisos

100%

Cumplimiento del protocolo

100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,680Tokens (definiciones de herramientas)

~1.5 KBTamaño de respuesta típico

Impacto significativo en la atención (2.88% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

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

Puntos de conexión remotos

https://superphone.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

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

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "page_size": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "after": {
      "description": "Cursor: pass the previous reply's next_cursor to get the next page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone contact id."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "mobile": {
      "description": "Mobile number, ideally E.164.",
      "type": "string",
      "maxLength": 40
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 254
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "page_size": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "after": {
      "description": "Cursor: pass the previous reply's next_cursor to get the next page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone conversation id."
    },
    "message_count": {
      "description": "How many of the latest messages to return, 1-100 (default 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "before": {
      "description": "Cursor: pass the previous reply's previous_cursor to read older messages.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "required": [
    "conversation_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone message id."
    }
  },
  "required": [
    "message_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "form_id": {
      "description": "Superphone form id; omit for the default form.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "starts_with": {
      "description": "Digits the number should start with, e.g. an area code like 415.",
      "type": "string",
      "pattern": "^\\d{1,10}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "First name."
    },
    "lastName": {
      "description": "Last name.",
      "type": "string",
      "maxLength": 100
    },
    "nickname": {
      "description": "Nickname.",
      "type": "string",
      "maxLength": 100
    },
    "mobile": {
      "description": "Mobile number, ideally E.164 (+12132679977); without a country code Superphone assumes the US.",
      "type": "string",
      "maxLength": 40
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 254
    },
    "birthday": {
      "description": "Birthday as text, e.g. 1990-05-17.",
      "type": "string",
      "maxLength": 40
    },
    "gender": {
      "description": "Gender.",
      "type": "string",
      "enum": [
        "MALE",
        "FEMALE"
      ]
    },
    "twitter": {
      "description": "Twitter handle.",
      "type": "string",
      "maxLength": 100
    },
    "instagram": {
      "description": "Instagram handle.",
      "type": "string",
      "maxLength": 100
    },
    "linkedin": {
      "description": "LinkedIn profile.",
      "type": "string",
      "maxLength": 200
    },
    "job_title": {
      "description": "Job title.",
      "type": "string",
      "maxLength": 100
    },
    "company": {
      "description": "Company.",
      "type": "string",
      "maxLength": 150
    },
    "vip": {
      "description": "Mark as VIP.",
      "type": "boolean"
    },
    "hidden": {
      "description": "Hide the contact.",
      "type": "boolean"
    },
    "archived": {
      "description": "Archive the contact.",
      "type": "boolean"
    },
    "unsubscribed": {
      "description": "Mark the contact as unsubscribed from messages.",
      "type": "boolean"
    },
    "country": {
      "description": "Country.",
      "type": "string",
      "maxLength": 100
    },
    "province": {
      "description": "State or province.",
      "type": "string",
      "maxLength": 100
    },
    "city": {
      "description": "City.",
      "type": "string",
      "maxLength": 100
    },
    "zip_code": {
      "description": "Postal code.",
      "type": "string",
      "maxLength": 30
    },
    "notes": {
      "description": "Free-text notes.",
      "type": "string",
      "maxLength": 5000
    }
  },
  "required": [
    "first_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone contact id."
    },
    "first_name": {
      "description": "New first name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "lastName": {
      "description": "Last name.",
      "type": "string",
      "maxLength": 100
    },
    "nickname": {
      "description": "Nickname.",
      "type": "string",
      "maxLength": 100
    },
    "mobile": {
      "description": "Mobile number, ideally E.164 (+12132679977); without a country code Superphone assumes the US.",
      "type": "string",
      "maxLength": 40
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 254
    },
    "birthday": {
      "description": "Birthday as text, e.g. 1990-05-17.",
      "type": "string",
      "maxLength": 40
    },
    "gender": {
      "description": "Gender.",
      "type": "string",
      "enum": [
        "MALE",
        "FEMALE"
      ]
    },
    "twitter": {
      "description": "Twitter handle.",
      "type": "string",
      "maxLength": 100
    },
    "instagram": {
      "description": "Instagram handle.",
      "type": "string",
      "maxLength": 100
    },
    "linkedin": {
      "description": "LinkedIn profile.",
      "type": "string",
      "maxLength": 200
    },
    "job_title": {
      "description": "Job title.",
      "type": "string",
      "maxLength": 100
    },
    "company": {
      "description": "Company.",
      "type": "string",
      "maxLength": 150
    },
    "vip": {
      "description": "Mark as VIP.",
      "type": "boolean"
    },
    "hidden": {
      "description": "Hide the contact.",
      "type": "boolean"
    },
    "archived": {
      "description": "Archive the contact.",
      "type": "boolean"
    },
    "unsubscribed": {
      "description": "Mark the contact as unsubscribed from messages.",
      "type": "boolean"
    },
    "country": {
      "description": "Country.",
      "type": "string",
      "maxLength": 100
    },
    "province": {
      "description": "State or province.",
      "type": "string",
      "maxLength": 100
    },
    "city": {
      "description": "City.",
      "type": "string",
      "maxLength": 100
    },
    "zip_code": {
      "description": "Postal code.",
      "type": "string",
      "maxLength": 30
    },
    "notes": {
      "description": "Free-text notes.",
      "type": "string",
      "maxLength": 5000
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone contact id."
    },
    "tag_names": {
      "description": "Tag names.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "tag_ids": {
      "description": "Tag ids (from superphone_get_contact). Give tag_names or tag_ids, not both.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone contact id."
    },
    "tag_names": {
      "description": "Tag names.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "tag_ids": {
      "description": "Tag ids (from superphone_get_contact). Give tag_names or tag_ids, not both.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Superphone contact id."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "What it was for, e.g. 'Gift card' or 'October order #1042'."
    },
    "amount": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Amount in the account's currency."
    },
    "created_at": {
      "description": "When it happened, ISO 8601 (2026-10-01T12:00:00Z or 2026-10-01). Default: now.",
      "type": "string"
    }
  },
  "required": [
    "contact_id",
    "name",
    "amount"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1600,
      "description": "The message text."
    },
    "conversation_id": {
      "description": "Reply in this conversation.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "mobile": {
      "description": "Recipient mobile number, E.164 recommended.",
      "type": "string",
      "maxLength": 40
    },
    "platform": {
      "description": "TWILIO = SMS (default); FACEBOOK = Messenger conversation.",
      "type": "string",
      "enum": [
        "TWILIO",
        "FACEBOOK"
      ]
    }
  },
  "required": [
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

1 nov 2026, 2:02 UTCverificadoversión no registrada17 herramientas

SuperPhone MCP by usefulapi

Calidad y seguridad

Costo de contexto

Instalación con un clic

Puntos de conexión remotos

Inventario de herramientas

Herramientas (17)

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Esquema de entrada

Califica este servidor

Observaciones recientes