shotanvil

Servidor MCP de capturas de pantalla, PDF y captura de elementos en warm-pool para agentes de IA (HTTP Streamable sin estado). Requiere una clave API o pago por llamada x402; el acceso sin clave está actualmente deshabilitado.

Documentación

Servidor MCP

POST /mcp monta un transporte MCP HTTP Streamable (sin estado). Accesible a través de las mismas tres rutas de acceso que GET /take (x402 / clave API / sin clave).

Herramientas

  • screenshot — captura una URL como imagen. Parámetros: url, format (png/jpeg/webp), además de los parámetros de renderizado comunes (viewport, delay, wait_until, block_ads, block_cookie_banners, dark_mode, full_page).
  • pdf — captura una URL como PDF. Mismos parámetros de renderizado comunes; format está fijado a pdf.
  • capture_element — captura una URL después de esperar a que aparezca un selector CSS. Mismos parámetros que screenshot más un selector obligatorio.

Las tres herramientas declaran ToolAnnotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true } y devuelven bloques de contenido de imagen + texto/metadatos extraídos en una sola llamada.

Los fallos a nivel de herramienta (parámetros incorrectos, fallo de navegación, tiempo de espera agotado) se devuelven como resultados MCP isError: true con un mensaje autocorrectivo — nunca como un estado de error HTTP, según la convención de MCP.

Cada solicitud debe enviar Accept: application/json, text/event-streamapplication/json solo se rechaza con 406.