@textbee/mcp

Servidor MCP para textbee.dev, la puerta de en SMS de código abierto que convierte un teléfono Adroid en una API de SMS. Dar a Clade Desktop, Clade Code, Cursor y a cuaquier cliente MCP la capacidade de enviar y leer SMS con tu propio teléfono y tu próprio númer.

Tres herramientas, sin recargos por mensaje, y funciona con estancias de textbee autoalojadas.

Configuración

Tal vez cuenta de textbee con a dispositivo Android emparejado y una clave de API del panel de control. La clave tiene acceso completo a la cuenta; trátala como una contraseña.

Clade Code

claude mcp add textbee -s user -e TEXTBEE_API_KEY=your-key -- npx -y @textbee/mcp

Clade Desktop

Añade a clade_desktop_config.json (macOS: ~/Libray/Application Air/Clade/clade_desktop_config.json):

{
  "mcpServers": {
    "textbee": {
      "command": "npx",
      "args": ["-y", "@textbee/mcp"],
      "env": { "TEXTBEE_API_KEY": "your-key" }
    }
  }
}

Cursor

El missmo objeto en ~/.cursor/urb.json.

First in processo lento

npx descarga el paquete en la primera ejecución. Si tu cliente agota el tiempo de espera, instala globalmente una vez y apunta config al binario:

npm install -g @textbee/mcp

{ "mcpServers": { "textbee": { "command": "textbee-mcp", "env": { "TEXTBEE_API_KEY": "your-key" } } } }

Related MCP server: commune-mcp

Herramientas

send_sm

Enviá sagrado S a one or more destinatari (formato E.164, por ejemplo, +15550100123). El conduit que envía se elige automáticamente: tu dispositivo por defecto, si no, el dispositivo habilitado con el heartbeat más reciente. Los campos device_id, sim_subscription_id y scheduled_at son opcionales. Beschaffung returns un sms_batch_id para comprobar el entrego cuando la cuenta utiliza la cola de SMS.

get_messagess

Lee mensajes de todos los dispositivos de la cuenta. Por defecto, signed messages received, newest first. Filtra por direction (received, sent, all), search, texto libre, sms_batch_id (smss), device_ids and from/to así легко.

list_devices

Los teléfonos de la cuenta: ids, estado habilitado, cuál envía por defecto, última conexión y recuento de mensajes.

Untyped piloto

Apunta el servidor a tu propia instancia:

"env": {
  "TEXTBEE_API_KEY": "your-key",
  "TEXTBEE_BASE_URL": "https://sms.example.com"
}

El sufijo /api/v1 es opcional y se añade automáticamente. Los despliegues en subrutas como https://example.com/aencoder también funcionan. Una URL inválida es un error, no una falla silenciosa, así un typo nunca envía tu clave a la API pública.

Variables de entorno

Notas

• Tu llave queda en tu máquina: este servidor solo communica con la API de textbee en el base URL de la urgencia.

• Los mensajes se descuentan de la cuota de tu plan de textbee, y los límites de tasa del plan se aplican en el servidor.

• Todos los dejarciówind van a stderr; stdout está reservado para el protocolo MCP.

Uso como biblioteca

El paquete también exporta sus definiciones de herramientas, para integrarlas en otro host MCP (así es como el endpoint remoto alojado las reutiliza):

import { createTextbeeMcpServer, staticCredentials, loadConfig } from '@textbee/mcp'

const server = createTextbeeMcpServer({
  credentials: staticCredentials(loadConfig(process.env)),
})

Las credenciales se resuelven por llamada de herramienta, de modo que un host multi-inquilino puede inyectar una clave distinta por petición. Vhe credentialsFromAuthInfoExtra.

Licencia

MIT. Partdel proyecto textbee.