Kudosity MCP

oficial

Construye con la API de Kudosity para enviar SMS y MMS. Accede a documentación para desarrolladores, referencias de API y herramientas de prueba en vivo para enviar mensajes, gestionar listas de contactos, configurar webhooks y más.

¿Qué puedes hacer con Kudosity MCP?

  • Discover available messaging APIs — ask your AI to list all Kudosity APIs (SMS, RCS, WhatsApp) using list-specs.
  • Inspect API endpoints and parameters — have the assistant explore paths, methods, and supported parameters for any service with list-endpoints and get-endpoint.
  • Retrieve request and response schemas — get the exact body format or response structure for an endpoint via get-request-body and get-response-schema.
  • Generate ready-to-run code snippets — produce curl, JavaScript, or Python examples with proper auth using get-code-snippet.
  • Execute live API calls — send real SMS or test any Kudosity endpoint directly from chat with execute-request.

Documentación

El servidor Kudosity Model Context Protocol (MCP) permite que editores potenciados por IA (como Cursor y Windsurf) y asistentes (como Claude Desktop) exploren y ejecuten directamente las API de Kudosity. Con MCP, tu IA puede buscar especificaciones de API, generar fragmentos de código y ejecutar solicitudes en vivo, todo sin salir de tu entorno de desarrollo.

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto que permite a las aplicaciones de IA acceder de forma segura a fuentes de datos y herramientas externas. El servidor Kudosity MCP proporciona a los agentes de IA:

  • Acceso directo a la API de la funcionalidad de Kudosity: enviar mensajes, actualizar listas de contactos, etc.
  • Búsqueda de documentación: permite que tu IA busque de forma inteligente en especificaciones de API y tutoriales para ofrecer respuestas precisas.
  • Datos en tiempo real de tu cuenta de Kudosity: consulta y ejecuta operaciones en vivo directamente desde el chat.
  • Generación de código para integraciones con Kudosity
  • Ejecución de API en vivo: más allá de ejemplos estáticos, ejecuta solicitudes reales
  • Siempre actualizado: impulsado por definiciones de origen de API Swagger

Capacidades del servidor MCP

El servidor Kudosity MCP ofrece herramientas completas para el descubrimiento de API, documentación, generación de código y ejecución en vivo:

🔍 Descubrimiento y exploración de API

  • list-specs: descubre las API de mensajería disponibles (SMS, RCS, WhatsApp, etc.)
  • list-endpoints: enumera todas las rutas y métodos de API para un servicio
  • get-endpoint: inspecciona los métodos y parámetros admitidos para cualquier ruta
  • search-specs: busca en las especificaciones palabras clave o patrones

📋 Esquema de API y documentación

  • get-request-body: recupera el esquema del cuerpo de la solicitud para cualquier endpoint
  • get-response-schema: visualiza el esquema de respuesta para endpoints y códigos de estado específicos
  • list-security-schemes: verifica los métodos y requisitos de autenticación
  • search-documentation: busca contenido en la documentación de la API

⚡ Generación de código

  • get-code-snippet: genera ejemplos listos para ejecutar en curl, JavaScript, Python, etc.
  • Proporciona autenticación y parámetros adecuados automáticamente

🚀 Ejecución de API en vivo

  • execute-request: ejecuta llamadas API reales utilizando el formato HAR
  • Envía mensajes SMS de prueba
  • Valida cualquier endpoint de Kudosity con credenciales activas
  • Devuelve respuestas y errores reales

API disponibles

El servidor MCP proporciona acceso a estas API de Kudosity:

  • Transmit Message API: servicio de mensajería v2 compatible con SMS, RCS, MMS, WhatsApp y webhooks
  • Transmit SMS API: SMS con todas las funciones, listas de contactos avanzadas, palabras clave e informes

Configuración del servidor Kudosity MCP

Kudosity aloja un servidor MCP remoto en https://developers.kudosity.com/mcp. Configura tus herramientas de desarrollo de IA para conectarte a este servidor.

Configuración de autenticación

Para las API que requieren autenticación, deberás configurar tus credenciales de API. Según los endpoints, los métodos difieren:

  • api.transmitsms.com (endpoints v1): Autenticación básica con clave API y secreto codificados en Base64
  • api.transmitmessage.com (endpoints v2): Autenticación por clave API con tu clave en el encabezado x-api-key

Para endpoints v1 (api.transmitsms.com) - Autenticación básica:

  1. Obtén tus credenciales desde el panel de Kudosity → Desarrolladores → Configuración de API
  2. Combínalas como: API_KEY:API_SECRET
  3. Codifica en Base64:
    • Terminal: echo -n "API_KEY:API_SECRET" | base64
    • Consola del navegador: btoa("API_KEY:API_SECRET")
    • Herramienta en línea: base64encode.org

Para endpoints v2 (api.transmitmessage.com) - Autenticación por clave API:

Usa tu clave API directamente en el encabezado x-api-key (no se requiere codificación Base64).

Para endpoints v1 (api.transmitsms.com) - Agregar aclaude_desktop_config.json:

JSON

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Importante: Reinicia tu herramienta de IA después de guardar el archivo de configuración.

También puedes instalar la integración Claude MCP para este proyecto usando:

Bash

claude mcp add kudosity --scope project -- npx mcp-remote https://developers.kudosity.com/mcp

Prueba de tu configuración MCP

Una vez configurado, puedes probar la conexión de tu servidor MCP:

  1. Reinicia tu herramienta de IA (Claude Desktop, Cursor, etc.)
  2. Inicia un nuevo chat con el asistente de IA
  3. Pregunta sobre Kudosity: prueba preguntas como:
    • "¿Qué API ofrece Kudosity?"
    • "Muéstrame un ejemplo de envío de un SMS"
    • "Crea un comando curl para enviar mi primer SMS a través de Kudosity"
    • "¿Cómo empiezo a enviar SMS con Kudosity?"

Si tiene éxito, la IA responderá con detalles de la API de Kudosity y código de ejemplo extraídos directamente de tu cuenta y documentación.

Actualizado hace aproximadamente 2 meses


Copiar página