Lo que puede leerun agente.

1. GET /api/v1/companyQuién es CaricaliaJSON
2. GET /api/v1/servicesQué se puede encargarJSON
3. GET /api/v1/pricingCuánto cuesta empezarJSON
4. GET /api/v1/casesTrabajo publicadoJSON
5. GET /api/v1/next-stepQué pasa cuando alguien escribeJSON

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

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.

Ejemplo

curl -X POST https://caricalia.com/api/v1/diagnostic-request \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6b1f2c40-0a1e-4f6d-9c2a-3d5b7e8f1234" \
  -d '{
    "name": "Ana Ruiz",
    "email": "ana@empresa.com",
    "whoUsesSystem": "clientes",
    "whoWroteIt": "proveedor",
    "message": "ERP a medida de 2019; el proveedor ya no está.",
    "source": "mi-agente"
  }'

1. POST /mcpServidor MCP por Streamable HTTP, sin autenticación. Cinco herramientas.MCP
2. /.well-known/mcp/server-card.jsonLa tarjeta del servidor: herramientas, transporte y que no pide clave.MCP
3. /.well-known/mcp.jsonEl descubrimiento corto: dónde está el servidor de este dominio.MCP
4. /.well-known/agent-card.jsonTarjeta A2A: consultar servicios y precio, o pedir un diagnóstico.A2A
5. /.well-known/agent-skills/index.jsonÍndice de Agent Skills, con el digest de la skill que hay debajo.SKILLS
6. /.well-known/agent-skills/cuando-contratar-a-caricalia/SKILL.mdCuándo contratarnos, qué no hacemos y cómo pedir un diagnóstico. Markdown.SKILL

list_services

Lista el diagnóstico de entrada y los tres tipos de proyecto de Caricalia, con duración, enlace y cuándo NO tiene sentido contratar cada uno. Léelo antes de recomendar nada.

get_pricing

Devuelve el precio publicado del diagnóstico y el orden de magnitud de un proyecto. De un proyecto no hay cifra: se cierra por fases sobre el informe del diagnóstico.

get_cases

Devuelve los casos publicados de Caricalia con su resumen, su cliente y los enlaces que un tercero puede comprobar por su cuenta sin creerse nada.

getnextstep

Devuelve la secuencia completa de qué pasa cuando alguien escribe a Caricalia, paso a paso, y por dónde se puede empezar. Úsala para explicar el proceso antes de mandar una petición.

request_diagnostic

Manda una petición de diagnóstico a Caricalia en nombre de la persona a la que ayudas. Manda un correo real; úsala solo si te lo ha pedido y te ha dado su nombre y su email. No compromete a nada: contesta una persona en un día laborable.

1. /openapi.jsonOpenAPI 3.1 de la API pública, con los esquemas de respuesta y los errores.OPENAPI
2. /.well-known/api-catalogCatálogo de APIs del dominio (RFC 9727), por si llegas solo con el dominio.RFC 9727
3. /llms.txtÍndice del sitio para modelos de lenguaje, con una línea por página.MARKDOWN
4. /llms-full.txtEl contenido íntegro del sitio en un solo fichero markdown.MARKDOWN

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`.

Escríbenos y lo miramos. Contesta el mismo equipo que mantiene la API.