API & Agent Readiness Documentation

HAVEN Psicología · Servicios Descubribles

Aitor Patiño Martínez · Psicólogo General Sanitario (Col. CV20898 COPCV)

1. Endpoints y Catálogos Estándar de Descubrimiento

HAVEN Psicología publica metadatos legibles por máquina conforme a los estándares RFC 8288, RFC 9727, RFC 9728, RFC 8414, Agent Skills v0.2.0, MCP Server Card (SEP-1649), ARD 1.0, WebMCP y Personal Agent Protocol (Poppy v0.1):

API Catalog (RFC 9727): /.well-known/api-catalog
OpenAPI 3.1.0 Spec: /openapi.json
Estado del Servicio (Health): /api/status.json
Información Clínica y Tarifas: /api/info.json
Agent Skills Index (v0.2.0): /.well-known/agent-skills/index.json
Skill de Cita Previa: /.well-known/agent-skills/haven-cita-previa/SKILL.md
MCP Server Card (SEP-1649): /.well-known/mcp/server-card.json
ARD Manifest (ai-catalog.json): /.well-known/ai-catalog.json
Personal Agent Protocol (Poppy): /.well-known/poppy.json
Web Bot Auth Directory (JWKS): /.well-known/http-message-signatures-directory
OAuth Protected Resource (RFC 9728): /.well-known/oauth-protected-resource
OAuth Auth Server Metadata (RFC 8414): /.well-known/oauth-authorization-server
OIDC Discovery: /.well-known/openid-configuration
Guía de Registro de Agentes: /auth.md
Versión Markdown y LLMs.txt: /index.md · /llms.txt

2. Autenticación, Registro y Privacidad Sanitaria (RGPD)

Todos los endpoints de consulta informativa (/api/info.json, /api/status.json, /openapi.json) son de acceso público sin necesidad de credenciales Bearer. Para solicitudes de cita previa, se aplica estrictamente el principio de minimización de datos (Art. 5.1.c RGPD) y confirmación humana explícita.

Para consultas técnicas, registro de agentes verificados o revocación de permisos: [email protected].

3. Herramientas en Navegador (WebMCP) y Markdown

La página de contacto (/contacto.html) expone herramientas WebMCP tanto de forma declarativa en el formulario de reserva (toolname="haven_solicitar_cita") como de forma imperativa mediante document.modelContext.registerTool() (haven_consultar_tarifas_y_horarios y haven_preparar_cita). Asimismo, ofrece versión íntegra en Markdown en /index.md y soporte para Accept: text/markdown en Cloudflare.