# Machine-readable documentation

> The artifacts the portal publishes for agents: llms.txt, raw Markdown on any URL, openapi.json and mcp.json.

- kind: guide
- status: stable
- last_verified: 2026-10-20
- url: https://tilopay.com/en/developers/agentes/documentacion-legible

## Indexes for models [#llms]

- [tilopay.com/llms.txt](https://tilopay.com/llms.txt) — Spanish site index, with the URL and a description of every
  page.
- [tilopay.com/llms-full.txt](https://tilopay.com/llms-full.txt) — the same index with the full content.
- [tilopay.com/en/llms.txt](https://tilopay.com/en/llms.txt) and [tilopay.com/en/llms-full.txt](https://tilopay.com/en/llms-full.txt) — the
  English versions, with `/en` URLs.

## Raw Markdown [#markdown]

Any URL on the site returns its Markdown by adding `.md`: for example
[tilopay.com/en/developers/sdk/instalacion.md](https://tilopay.com/en/developers/sdk/instalacion.md) or
[tilopay.com/en/tarifas.md](https://tilopay.com/en/tarifas.md). It is served as `text/markdown`, with a metadata header
(page kind, status, version and last verification date). A URL that does not exist returns 404, not
HTML.

## API spec [#openapi]

[Saved card payments](/en/developers/api/cobros-tarjetas-guardadas) includes the 10 public collect operations in the acquiring OpenAPI.

- [`openapi.json`](/developers/openapi.json) — OpenAPI 3.1 spec of the Tilopay API: endpoints,
  parameters, responses and examples. It is the source of truth for the API.
- [`openapi.yaml`](/developers/openapi.yaml) — the same content in YAML.
- [`api-bancario/openapi.json`](/developers/api-bancario/openapi.json) — OpenAPI 3.0.3 spec of the
  banking API (BaaS), a separate artifact from the acquiring API.
- [`api-bancario/openapi.yaml`](/developers/api-bancario/openapi.yaml) — the same content in YAML.

Both routes answer with `Access-Control-Allow-Origin: *`, so they can be read from the browser.

## MCP catalog [#mcp-json]

[`mcp.json`](/developers/mcp.json) describes the MCP server: its URL, the access model and the full
tool catalog with parameters, output and access level. When a tool wraps an API operation, the
entry includes that endpoint. The catalog is in Spanish: tool descriptions are written for the
WhatsApp assistant and published as-is.

The index of installable skills is at
[`/developers/skills/index.md`](/developers/skills/index.md).

The root-level `verified_at` field carries the date (`YYYY-MM-DD`) on which the catalog was compared
against the server. The server version does not change when tools are added, so that is the signal
to check whether a cached copy is stale.