Changelog de la API
Historial de cambios de la API de Vemudo y de /mcp para agentes de IA, con la fecha de disponibilidad en api.vemudo.com y la política de cambios.
Por Equipo Vemudo · Actualizado el
api.vemudo.com, no la del desarrollo interno. Todo lo que no aparece en una entrada, incluido lo que ya existía antes de la primera, es la versión inicial de /v1.
2026-11-17 — MCP remoto con OAuth 2.1, herramientas de escritura y de claves
OAuth 2.1 en /mcp
https://api.vemudo.com/mcp admite la autorización de MCP con OAuth 2.1, además de las claves de API: descubrimiento automático (/.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server), registro dinámico de clientes y PKCE S256. El cliente solo necesita la URL; al conectar, la persona entra en Vemudo y elige organización, entorno (test o live) y permisos (mcp:read, mcp:send, mcp:write, mcp:keys). Sin credenciales, /mcp responde 401 con WWW-Authenticate y la dirección de los metadatos.
409 oauth_connection_limit), que no cuentan para el máximo de claves activas del plan. Los tokens OAuth no valen en /v1, solo en /mcp. Las conexiones se ven y se revocan en el panel, en «Claves de API > Conexiones de IA».
Herramientas nuevas, solo con OAuth
Con mcp:write: escrituras sobre dominios, plantillas, contactos, listas, bajas, webhooks y campañas (incluido enviarlas desde una conexiónlive). Las destructivas exigenconfirm: true.Con mcp:keys:list_api_keys,create_api_keyyrevoke_api_key. El secreto de una clave nueva se devuelve una sola vez en el resultado decreate_api_key.
/mcp y @vemudo/mcp siguen ofreciendo las mismas 21 herramientas de consulta y envío. Instrucciones por cliente en MCP y asistentes de IA.
2026-11-14 — Agentes de IA: MCP remoto, referencia pública y límites propios
MCP remoto (POST /mcp)
POST https://api.vemudo.com/mcp con la misma clave, los mismos scopes y los mismos límites que /v1. Es Streamable HTTP sin sesiones ni SSE: cada petición es un único mensaje JSON-RPC 2.0 y la respuesta es siempre application/json; GET /mcp y DELETE /mcp devuelven 405.
tools/list están filtradas por el scope de la clave que llama. El cuerpo de la petición tiene un máximo de 1 MB y el resultado de una herramienta se recorta a 50 KB con truncated: true si lo supera. Más detalle, con ejemplos, en MCP y asistentes de IA.
Referencia pública del contrato (GET /v1/openapi.json)
GET https://api.vemudo.com/v1/openapi.json sirve el contrato OpenAPI completo de /v1, sin clave, y es cacheable durante 1 hora.
Límites por plan para claves y agentes
429 rate_limited con Retry-After. Más detalle en Planes y cuotas y en Errores y límites.
Códigos de error nuevos
/v1 y de POST /mcp (en /mcp llegan dentro del resultado de la herramienta, con isError: true, en vez de como estado HTTP):
403 | api_key_blocked | |
403 | agents_blocked | |
403 | origin_invalid | /mcp: el Origin del navegador no está en la lista permitida. |
409 | api_key_limit | |
429 | rate_limited (rpm, rpd o concurrencia) | Retry-After. extensions lleva limit, window y planCode. |
503 | agents_disabled | |
503 | rate_limit_unavailable | |
503 | openapi_unavailable | GET /v1/openapi.json no puede leer el contrato en este momento. Reintenta. |
Dos familias de cabeceras de límite
RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (la ráfaga de 10 peticiones por segundo y organización) y X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (el límite de minuto o de día que se esté aplicando). Ninguna de las dos se retirará sin aviso en esta misma página.
Política de cambios
Aditivo, entra sin aviso en esta página: campos nuevos en una respuesta, cabeceras nuevas, endpoints nuevos, valores nuevos en un campo que ya era abierto (por ejemplo, un nuevo tipo de evento de webhook), y nuevos códigos de error dentro de un estado HTTP ya documentado. Se considera ruptura: quitar o renombrar un campo o una cabecera, cambiar el tipo o el significado de un campo existente, cambiar el estado HTTP de un error ya documentado, o quitar un código de error sin sustituirlo. Versión: la API se versiona por el prefijo de ruta ( /v1). Un cambio de ruptura implica una nueva versión;/v1no cambia de forma incompatible mientras siga activo.Retirada: cualquier retirada de un campo, una cabecera o un endpoint lleva aviso previo en este changelog y, en la propia respuesta, las cabeceras DeprecationySunsetantes de desaparecer.