Para desarrolladores

Lo que un cliente necesita saber sobre el servidor y cómo llamarlo sin un asistente de por medio.

El protocolo tal como lo servimos

  • Streamable HTTP en https://api.publicwww.com/mcp: un mensaje JSON-RPC por cada POST (también se acepta un lote), y las respuestas son application/json simple. Sin server-sent events ni sesiones: cada solicitud lleva su token. GET devuelve 405.
  • Se sirven las dos generaciones del protocolo en la misma URL: las revisiones con el saludo initialize (de 2024-11-05 a 2025-11-25) y 2026-07-28 con server/discover, en la que la versión y las capacidades del cliente viajan en params._meta de cada solicitud, y Mcp-Method / Mcp-Name deben coincidir con el cuerpo.
  • Sin token, o con uno que se eliminó, cualquier solicitud devuelve 401, con un encabezado WWW-Authenticate que indica los metadatos del recurso protegido (RFC 9728), a partir de los cuales un cliente OAuth encuentra el servidor de autorización. El flujo está en OAuth 2.1 para aplicaciones.
  • Herramientas: search y account, descritas en Herramientas. Sin recursos ni prompts, y la lista no cambia entre llamadas.
  • Sin token, la tarjeta del servidor describe el servidor: nombre, dirección, versiones del protocolo y enlaces. Aparece en https://publicwww.com/.well-known/ai-catalog.json. La lista de herramientas no forma parte de la tarjeta; se obtiene con tools/list cuando el cliente ya tiene un token.

Llamarlo con curl

El servidor no guarda estado entre llamadas, así que se puede llamar a una herramienta directamente, sin el saludo inicial: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
          "params":{"name":"search","arguments":{"query":"\"angular.min.js\"","rows":3}}}'

La lista de herramientas con sus esquemas de entrada: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Estas llamadas y una comprobación de la cuenta, en un solo script: mcp-curl.sh.

Para un script que solo necesita resultados de búsqueda, la API REST es el camino más sencillo: la misma búsqueda y el mismo token, con CSV, NDJSON y los demás formatos.

Siguiente Idiomas