Protocolo

Endpoint

POST /wp-json/ballesdev/mcp (o /?rest_route=/ballesdev/mcp en sitios sin enlaces permanentes). Usa el transporte Streamable HTTP de MCP sin sesiones: cada POST recibe una respuesta JSON. GET y DELETE devuelven 405.

Autenticación

El endpoint usa la autenticación de la REST API de WordPress; en la práctica, una contraseña de aplicación por HTTP Basic. El usuario tiene que poder editar páginas (Editores y Administradores).

Los pedidos con header Origin solo se aceptan desde el origen del propio sitio (esquema, host y puerto), lo que bloquea páginas de otros sitios en el navegador.

Versiones del protocolo

Versión	Métodos
2026-07-28	server/discover, tools/list, tools/call
2025-11-25, 2025-06-18	initialize, ping, tools/list, tools/call

La versión se elige en cada pedido: el header MCP-Protocol-Version o params._meta. Los pedidos en 2026-07-28 tienen que mandar los headers MCP-Protocol-Version, Mcp-Method y Mcp-Name, iguales a lo que dice el cuerpo. Otras versiones reciben el error -32022 con la lista de las soportadas. No se aceptan lotes (batches).

Errores

• Una herramienta que corre pero falla (por ejemplo content_conflict) devuelve un resultado con isError: true y el código de error entre corchetes, para que la IA lo lea y corrija.
• Los problemas de protocolo (una herramienta o método desconocido, parámetros inválidos) devuelven errores JSON-RPC.
• Una falla inesperada dentro de una herramienta devuelve un mensaje genérico; el detalle va al debug.log de WordPress cuando WP_DEBUG está activo.