# Developer AI Context - Espacio Interior Salud Mental
# https://espaciointerior.com.uy/developer-ai.txt
# Version: 1.0.0
# Last Updated: 2026-02-20

## Technology Stack

- Framework: Next.js 15.3.1 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS 4
- Icons: Lucide React
- Fonts: Lora (serif, headings), Source Sans 3 (sans-serif, body) via Google Fonts
- Email: EmailJS (@emailjs/browser)
- Analytics: Google Analytics (G-ZGVH9NE6K8) via @next/third-parties
- Deployment: Vercel
- Package Manager: npm

## Site Architecture

- / — Home page with services overview and value propositions
- /contacto — Contact form with service preselection via URL params
- /servicios/psicoterapia-individual — Individual Psychotherapy
- /servicios/consumos-problematicos — Substance Use Treatment
- /servicios/trastornos-mentales-severos — Severe Mental Disorders
- /servicios/trastornos-duales — Dual Disorders
- /servicios/acompanamiento-familiar — Family Accompaniment
- /servicios/talleres-desarrollo-personal — Personal Development Workshops
- /servicios/intervenciones-equipos — Team Interventions

## AI Integration Points

### Content Negotiation
The site supports content negotiation via middleware. Sending `Accept: text/markdown` header to any page returns a markdown version via internal API routes.

### WebMCP (Chrome 146+)
The contact form at /contacto implements WebMCP declarative API:
- tool-name: solicitar_consulta
- Parameters: name, email, phone, service, preferredContact, message
- AI agents can submit consultation requests directly

### MCP Server (Model Context Protocol)
Endpoint: POST /api/mcp (JSON-RPC over HTTP)
Discovery: /.well-known/mcp/server-card.json (SEP-1649)
Protocol version: 2025-11-05

Available tools:
- solicitar_consulta: Generate contact links (WhatsApp, form, phone) for booking a consultation
- obtener_informacion: Get services, contact info, or crisis resources

Available resources:
- espacio-interior://servicios — List of services with URLs
- espacio-interior://contacto — Full contact information
- espacio-interior://crisis — Uruguay mental health crisis resources

### API Endpoints
- POST /api/mcp — MCP JSON-RPC endpoint (tools + resources)
- GET /api/mcp — MCP server metadata (human-readable)
- GET /api/ai-context — JSON structured business data (Schema.org MedicalBusiness)
- GET /api/markdown/{page} — Markdown versions of each page

### AI Discovery Files
- /llms.txt — Business summary (llms.txt spec v1.1.1)
- /llms-full.txt — Complete business information (400+ lines)
- /ai.txt — AI interaction permissions and restrictions
- /ai.json — Machine-parseable AI guidance
- /identity.json — Structured identity data (Schema.org)
- /brand.txt — Brand guidelines for AI
- /faq-ai.txt — FAQ optimized for AI citation
- /robots-ai.txt — AI crawler access directives
- /.well-known/ai-plugin.json — AI agent plugin manifest
- /.well-known/mcp/server-card.json — MCP server card (SEP-1649)

### Structured Data (JSON-LD)
Every page includes JSON-LD structured data:
- Layout: MedicalBusiness, WebSite, Organization (site-wide)
- Home: BreadcrumbList, ItemList
- Contact: ContactPage, BreadcrumbList
- Service pages: MedicalTherapy/Service, FAQPage, BreadcrumbList

### HTTP Headers
All responses include:
- X-AI-Context: /llms.txt
- Link: </llms.txt>; rel="ai-context", </api/ai-context>; rel="alternate"

## Contact Form URL Params

The contact form accepts preselected services via query params:
- /contacto?servicio=psicoterapia-individual
- /contacto?servicio=consumos-problematicos
- /contacto?servicio=trastornos-mentales-severos
- /contacto?servicio=trastornos-duales
- /contacto?servicio=acompanamiento-familiar-consumos
- /contacto?servicio=acompanamiento-familiar-trastornos
- /contacto?servicio=acompanamiento-familiar-duales
- /contacto?servicio=talleres-desarrollo-personal
- /contacto?servicio=intervenciones-equipos

## Repository

Private repository. For technical inquiries: info@espaciointerior.com.uy