# Documentación legible por máquina

> Los artefactos que el portal publica para agentes: llms.txt, Markdown crudo en cualquier URL, openapi.json y mcp.json.

- kind: guide
- status: stable
- last_verified: 2026-08-29
- url: https://tilopay.com/developers/agentes/documentacion-legible

## Índices para modelos [#llms]

- [tilopay.com/llms.txt](https://tilopay.com/llms.txt) — índice del sitio en español, con la URL y una descripción
  de cada página.
- [tilopay.com/llms-full.txt](https://tilopay.com/llms-full.txt) — el mismo índice con el contenido completo.
- [tilopay.com/en/llms.txt](https://tilopay.com/en/llms.txt) y [tilopay.com/en/llms-full.txt](https://tilopay.com/en/llms-full.txt) — las
  versiones en inglés, con las URLs `/en`.

## Markdown crudo [#markdown]

Cualquier URL del sitio devuelve su Markdown agregándole `.md`: por ejemplo
[tilopay.com/developers/sdk/instalacion.md](https://tilopay.com/developers/sdk/instalacion.md) o
[tilopay.com/tarifas.md](https://tilopay.com/tarifas.md). Se sirve como `text/markdown`, con un encabezado de
metadatos (tipo de página, estado, versión y fecha de última verificación). Una URL que no existe
devuelve 404, no HTML.

## Spec del API [#openapi]

- [`openapi.json`](/developers/openapi.json) — spec OpenAPI 3.1 del API de Tilopay: endpoints,
  parámetros, respuestas y ejemplos. Es la fuente de verdad del API.
- [`openapi.yaml`](/developers/openapi.yaml) — el mismo contenido en YAML.

Las dos rutas responden con `Access-Control-Allow-Origin: *`, así que se pueden leer desde el
navegador.

## Catálogo del MCP [#mcp-json]

[`mcp.json`](/developers/mcp.json) describe el servidor MCP: su URL, el modelo de acceso y el
catálogo completo de herramientas con parámetros, salida y nivel de acceso. Cuando la herramienta
envuelve una operación del API, la entrada incluye ese endpoint.

El campo `verified_at` en la raíz trae la fecha (`YYYY-MM-DD`) en que el catálogo se comparó con el
servidor. La versión del servidor no cambia cuando se agregan herramientas, así que ésa es la señal
que conviene mirar para saber si una copia en caché quedó vieja.