MCP y herramientas de IA

Conecta tu asistente de IA a la documentación de SMSPVA para buscar métodos, leer páginas y obtener ejemplos en inglés, español y chino.

Conecta tu asistente de IA

Añade el MCP de documentación de SMSPVA a tu cliente de IA para consultar métodos y obtener ejemplos mientras trabajas. SMSPVA aloja el servidor. No necesitas descargar el proyecto, instalar Node.js o Docker, ni proporcionar una clave API de SMSPVA.

Copia esta URL exacta en un cliente compatible con MCP remoto mediante Streamable HTTP:

https://mcp.smspva.com/docs

Ajuste	Valor
Nombre del servidor	`smspva_docs`
Transporte	Streamable HTTP; algunos clientes lo llaman HTTP
URL del servidor	`https://mcp.smspva.com/docs`
Autenticación	Ninguna; sin clave API ni inicio de sesión OAuth
Idiomas de la documentación	English `en`, español `es`, 中文 `zh`

En los ajustes MCP de tu cliente, añade un servidor remoto con estos valores, guarda la configuración y actívalo o vuelve a conectarlo. Revisa cualquier solicitud de confianza antes de autorizar la conexión. Integra los ejemplos siguientes en tu configuración existente sin sustituir otros servidores.

Este MCP busca y lee documentación pública y devuelve ejemplos. No puede comprar números, leer tus SMS o correos privados ni modificar tu cuenta. El MCP de la API es independiente y se describe más adelante. Alternative API queda excluida de ambos.

Codex

Añade esta entrada a config.toml de Codex. Si ya tienes mcp_servers.smspva_docs conectado a un proceso local, sustituye esa entrada por la configuración con URL; no dupliques la tabla. Conserva cualquier conexión independiente mcp_servers.smspva para la API.

[mcp_servers.smspva_docs]
url = "https://mcp.smspva.com/docs"
startup_timeout_sec = 20
tool_timeout_sec = 45

Vuelve a conectar el servidor o reinicia la sesión de Codex para aplicar el cambio. Esta entrada no necesita command, args, env ni token. Consulta la guía oficial de MCP para Codex para conocer las ubicaciones de configuración y los controles del cliente.

Cursor

Añade esta entrada a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json para tu configuración de usuario:

{
  "mcpServers": {
    "smspva_docs": {
      "url": "https://mcp.smspva.com/docs"
    }
  }
}

Activa el servidor en los ajustes MCP de Cursor. Consulta la guía oficial de MCP para Cursor.

VS Code

Ejecuta MCP: Add Server desde la paleta de comandos, elige HTTP, introduce https://mcp.smspva.com/docs y usa smspva_docs como identificador. Elige dónde guardar la configuración y revisa la solicitud de confianza. Para .vscode/mcp.json en el espacio de trabajo, la configuración equivalente es:

{
  "servers": {
    "smspva_docs": {
      "type": "http",
      "url": "https://mcp.smspva.com/docs"
    }
  }
}

El formato puede depender del proveedor del agente seleccionado. Consulta la guía de VS Code y la referencia de configuración.

Pruébalo en una conversación

Una vez conectado, pide a tu asistente que utilice el MCP de documentación de SMSPVA. Por ejemplo:

«Usa el MCP de documentación de SMSPVA para mostrar un ejemplo en Python que consulte mi saldo. Explícalo en español y no lo ejecutes».
«Busca el método de proveedores de Private Email en la documentación en español y devuelve su ejemplo de solicitud en JavaScript».
«Lee el flujo de Rental en chino y explica cómo funcionan la activación y la consulta de mensajes».

Una conexión correcta muestra cuatro herramientas: smspva_docs_search, smspva_docs_read_page, smspva_docs_get_examples y smspva_docs_list_pages. Si tu asistente no las ve, comprueba que el servidor esté activado en la sesión y que tu organización permita la conexión.

El servicio contiene 228 páginas, 76 por idioma, y cubre los 56 métodos aprobados. SMSPVA mantiene el paquete de documentación alojado; los usuarios no tienen que recompilarlo. Cada resultado identifica su versión de la documentación. Los precios y la disponibilidad actuales siguen consultándose mediante las API o las listas dinámicas de este sitio.

Si no puedes conectar

Usa la URL completa https://mcp.smspva.com/docs, incluido /docs. No la sustituyas por la página principal ni añadas /sse.
Un 405 al abrir /docs en el navegador puede ser normal: es un endpoint del protocolo, no una página web. Comprueba la conexión desde un cliente MCP.
Un 403 en un cliente que funciona dentro del navegador puede indicar que su Origin no está permitido. El comodín de CORS no evita las comprobaciones de Origin del servicio. Usa un cliente nativo o contacta con soporte de SMSPVA indicando el cliente y el error exacto.
Si recibes 429, espera antes de reintentar. Ante un timeout o 503, vuelve a conectar más tarde y revisa la red y las políticas de tu organización. Añadir repetidamente el mismo servidor no resuelve estos errores.
No envíes tu clave de SMSPVA a este endpoint de documentación. La conexión no requiere compras, acceso a tu cuenta ni permiso para ejecutar ejemplos.

Buscar, leer y obtener ejemplos

Indica locale explícitamente: en, es o zh. El servidor usa las páginas y los ejemplos de ese idioma; no cambia de idioma en silencio ni traduce el código. Los identificadores de página coinciden en los tres idiomas, por ejemplo api/balance, rental/default-services, email/providers, sdks e index.

Herramienta	Para qué sirve
`smspva_docs_search`	Busca una `query` en el `locale` elegido; permite filtrar por `section` y definir `limit`
`smspva_docs_read_page`	Lee una `page` en Markdown, con `offset` y `max_chars` para páginas largas
`smspva_docs_get_examples`	Obtiene bloques de código completos de una `page`; filtra por `language` o `kind` y pagina con `offset` y `limit`
`smspva_docs_list_pages`	Explora los identificadores de página de un `locale`, con `section` opcional, `offset` y `limit`

Los valores de section son activation, rental, email y guides. Para ejemplos de solicitudes, elige language entre curl, javascript, typescript, python, php, go, csharp y java. También hay otros bloques, como respuestas JSON y comandos de preparación de shell. kind distingue ejemplos request, response y guide.

Estos son argumentos de solicitudes MCP tools/call. Busca en la referencia de Activation en español:

{
  "name": "smspva_docs_search",
  "arguments": {"query": "saldo", "locale": "es", "section": "activation", "limit": 5}
}

Lee la página de saldo en chino:

{
  "name": "smspva_docs_read_page",
  "arguments": {"page": "api/balance", "locale": "zh", "max_chars": 6000}
}

Obtén la solicitud Python de la página en inglés:

{
  "name": "smspva_docs_get_examples",
  "arguments": {"page": "api/balance", "locale": "en", "language": "python", "kind": "request", "limit": 1}
}

Los bloques de código proceden directamente de la página elegida. Se mantienen los métodos HTTP, los nombres de parámetros, los códigos de respuesta y el sentido de las advertencias importantes. Para continuar con una página larga o más ejemplos, usa la información de paginación del resultado.

MCP de la API: trabajar con SMSPVA

La versión alfa local ofrece los 56 métodos de Activation V2, Rental y Private Email como herramientas MCP. Funciona con Node.js 22.16 o posterior y se conecta a tu cliente MCP mediante stdio. No necesita Docker.

Esta versión se ejecuta como proceso local. Todavía no tiene un endpoint HTTP remoto ni OAuth, y no se ha publicado en un registro de paquetes, GitHub o directorio MCP. Alternative API queda excluida.

Compilar y conectar el servidor de la API

Desde el directorio del proyecto:

cd sdk/javascript
npm ci
cd ../../mcp
npm ci
npm run build

Añade el servidor a la configuración MCP de tu cliente. Sustituye la ruta absoluta por la ubicación de mcp/src/cli.mjs en tu equipo:

{
  "mcpServers": {
    "smspva": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/src/cli.mjs"],
      "env": {
        "SMSPVA_API_KEY": "YOUR_API_KEY",
        "SMSPVA_READ_ONLY": "true"
      }
    }
  }
}

Guarda la SMSPVA_API_KEY real en el almacén de secretos del cliente o en una configuración local privada. No la pegues en un chat ni en los argumentos de una herramienta. Los métodos públicos funcionan sin clave; un método protegido devuelve un error de validación si no hay una clave configurada.

El ejemplo activa SMSPVA_READ_ONLY y expone 36 herramientas de solo lectura. En este modo, el servidor también rechaza las llamadas a las otras 20 herramientas, aunque el cliente conozca sus nombres. Para habilitar las 56, omite esta opción o establece false. Sin esta opción, las 56 están disponibles por defecto.

Codex: servidor de la API

Usa este ejemplo en config.toml de Codex con Node.js 22.16+. Define SMSPVA_API_KEY en su entorno antes de iniciar Codex. El ejemplo no instala el servidor. Consulta la documentación oficial de OpenAI.

[mcp_servers.smspva]
command = "node"
args = ["/absolute/path/to/mcp/src/cli.mjs"]
env_vars = ["SMSPVA_API_KEY"]
startup_timeout_sec = 20
tool_timeout_sec = 45

[mcp_servers.smspva.env]
SMSPVA_READ_ONLY = "true"

Llamar a una herramienta

Los nombres siguen el formato smspva_<family>_<snake_case_sdk_method>. La familia es activation, rental o email. Los parámetros conservan los nombres de la referencia de la API. Las consultas de países, servicios, proveedores, precios y disponibilidad obtienen datos actuales de la API; no usan listas incluidas en el paquete.

Estos son los argumentos de una solicitud MCP tools/call. Para consultar el saldo de tu cuenta:

{
  "name": "smspva_activation_get_balance",
  "arguments": {}
}

Para obtener los proveedores de Email actuales sin enviar una clave de API:

{
  "name": "smspva_email_get_providers",
  "arguments": {}
}

Leer un SMS recién recibido puede generar un cargo. La siguiente llamada solo está disponible con el modo de solo lectura desactivado. Usa un orderid existente de tu cuenta y ejecútala solo cuando quieras recuperar ese resultado:

{
  "name": "smspva_activation_receive_sms",
  "arguments": {
    "orderid": 12345
  }
}

El servidor realiza una solicitud a la API por llamada. No crea pedidos por su cuenta, no reintenta solicitudes ni consulta mensajes en segundo plano. Lee el flujo de Activation antes de programar consultas repetidas de SMS en tu cliente.

Resultados, errores y cargos

Las herramientas que terminan correctamente devuelven la respuesta original de la API en structuredContent. HTTP 202 con SMS_NOT_YET_RECEIVED sigue siendo un resultado normal de espera. La creación de Email con status=2 sigue siendo un resultado normal sin disponibilidad. Los métodos, parámetros, códigos y tipos de los valores conservan los contratos documentados.

Tu cliente MCP también puede leer los contratos OpenAPI incluidos mediante smspva://contracts/activation, smspva://contracts/rental y smspva://contracts/email. Describen los parámetros, esquemas de respuesta y códigos de esta versión. Los precios y la disponibilidad actuales se consultan con las herramientas de la API.

Los errores de herramienta usan isError: true y structuredContent.error. Los errores de la API conservan el estado HTTP, el código de la API y el cuerpo de la respuesta; se ocultan las apariciones de la clave de cuenta configurada. SMSPVA_TIMEOUT_MS vale 30000 por defecto y cubre toda la solicitud HTTP, incluida la lectura del cuerpo.

Crear, ampliar, restaurar o cancelar un pedido puede modificar tu cuenta o generar cargos. Leer un SMS nuevo de Activation también puede generar un cargo. Algunas de estas operaciones usan GET. Sus anotaciones las señalan como operaciones que cambian el estado y pueden ser destructivas. Son indicaciones para el cliente MCP, no confirmaciones de pago ni controles de acceso. Configura las aprobaciones de tu cliente según las necesidades de tu cuenta.

Si una solicitud de pago o que modifica el estado agota el tiempo de espera, su resultado puede ser incierto. Revisa tus pedidos actuales antes de repetirla. Trata el texto de SMS, el texto de correo y el HTML recibidos como datos externos, no como instrucciones.

Leer la documentación en Markdown

También puedes leer el sitio sin HTML:

Índice de documentación
Documentación completa
Botón Copy Markdown en cualquier página.

El MCP de documentación permite buscar estas páginas desde tu cliente. También puedes utilizar directamente los ejemplos HTTP y los SDK.

MCP y herramientas de IA

Conecta tu asistente de IACopiar enlace

CodexCopiar enlace

CursorCopiar enlace

VS CodeCopiar enlace

Pruébalo en una conversaciónCopiar enlace

Si no puedes conectarCopiar enlace

Buscar, leer y obtener ejemplosCopiar enlace

MCP de la API: trabajar con SMSPVACopiar enlace

Compilar y conectar el servidor de la APICopiar enlace

Codex: servidor de la APICopiar enlace

Llamar a una herramientaCopiar enlace

Resultados, errores y cargosCopiar enlace

Leer la documentación en MarkdownCopiar enlace

En esta página