---
title: "API pública, MCP y superficie para agentes"
description: "Los endpoints públicos de Caricalia: servicios, precio, casos y siguiente paso en JSON, servidor MCP, OpenAPI y tarjetas de agente. Sin clave y sin registro."
canonical: https://caricalia.com/developers
last-updated: 2026-09-29
---

# Lo que puede leer un agente.

Todo lo que decimos en la web está también en JSON, sin clave y sin registro, y un programa puede pedir un diagnóstico por su cuenta.

Es la misma información que lee una persona: sale del mismo contenido, así que no puede decir una cosa la página y otra el endpoint.

## Qué pasa cuando alguien escribe

1. **Escribes.** Por el formulario, por correo o por la API. Nos cuentas qué tienes en marcha.
2. **Te contestamos en un día laborable.** Con tres preguntas sobre el sistema. Si no encaja, también te lo decimos.
3. **Veinte minutos por videollamada.** Si encaja. No se cobra y no hay que preparar nada.
4. **Empieza el diagnóstico.** Tres semanas sobre tu sistema, con acuerdo de confidencialidad firmado antes de ver nada.

## Lectura

Ocho recursos de solo lectura y uno de escritura. JSON, sin clave.

- `GET /api/v1/company` — Quién es Caricalia
- `GET /api/v1/services` — Qué se puede encargar
- `GET /api/v1/pricing` — Cuánto cuesta empezar
- `GET /api/v1/cases` — Trabajo publicado
- `GET /api/v1/next-step` — Qué pasa cuando alguien escribe
- `GET /api/v1/articles` — Las notas publicadas
- `GET /api/v1/articles/{slug}` — Una nota, con su cuerpo
- `GET /api/v1/glossary` — El glosario
- `GET /api/v1/glossary/{term}` — Una definición
- `GET /api/v1/comparisons` — Las comparativas
- `POST /api/v1/diagnostic-request` — Pedir un diagnóstico

Se cachean una hora y responden a cualquier origen (`Access-Control-Allow-Origin: *`).

## Pedir un diagnóstico

Un POST con lo mismo que rellena una persona en el formulario.

Responde `202` con un identificador. Manda el mismo correo que el formulario y no guarda nada. Cinco peticiones por minuto y dirección IP; con `Idempotency-Key` la misma clave devuelve el mismo identificador durante veinticuatro horas.

## MCP y tarjetas de agente

El servidor y los descriptores que busca un cliente antes de conectarse.

- Servidor MCP: https://caricalia.com/mcp (también en https://caricalia.com/.well-known/mcp)
- Tarjeta del servidor: https://caricalia.com/.well-known/mcp/server-card.json
- Descubrimiento corto: https://caricalia.com/.well-known/mcp.json
- Tarjeta A2A: https://caricalia.com/.well-known/agent-card.json
- Índice de Agent Skills: https://caricalia.com/.well-known/agent-skills/index.json
- Catálogo de recursos (ARD 1.0): https://caricalia.com/.well-known/ard.json
- Catálogo de APIs (RFC 9727): https://caricalia.com/.well-known/api-catalog

## Documentos para modelos

El sitio en markdown, para lo que no cabe en un endpoint.

- [/llms.txt](https://caricalia.com/llms.txt): Índice del sitio
- [/llms-full.txt](https://caricalia.com/llms-full.txt): Todo el contenido en un fichero
- [/openapi.json](https://caricalia.com/openapi.json): OpenAPI 3.1 de la API pública
- [/mcp](https://caricalia.com/mcp): Servidor MCP (Streamable HTTP)
- [/.well-known/api-catalog](https://caricalia.com/.well-known/api-catalog): Catálogo de APIs (RFC 9727)
- [/developers](https://caricalia.com/developers): Cómo usar todo lo anterior
- [/sitemap.xml](https://caricalia.com/sitemap.xml): Mapa del sitio

## Errores

Todo error sale en `application/problem+json` (RFC 9457) con `type`, `title`, `status` y `detail`. Un `404` añade un `hint` al `/openapi.json`. La versión va en la URL: `/api/v1`. Si algún día hay una `v2`, la `v1` seguirá contestando al menos seis meses y lo dirá en la cabecera `Deprecation`.

## Si algo no responde

Escríbenos y lo miramos. Contesta el mismo equipo que mantiene la API. info@caricalia.com