For AI agents

​

Entry points

• llms.txt is a condensed summary of this documentation.
• llms-full.txt is the entire documentation in one file.
• The OpenAPI schema describes every endpoint.
• The MCP server exposes the browser as tools an agent can call directly, with no HTTP client to write.

Read https://docs.tilion.dev/llms.txt and use the Tilion API to
create a browser session, attach Playwright over CDP, open
example.com, print the title, and release the session in a
finally block.

​

Rules worth encoding

• Always release the session in a finally block. Sessions bill until released.
• Reuse browser.contexts()[0] and .pages()[0] instead of creating new ones.
• Never cache connect_url. Re-mint before every attach.
• Treat 404 on a release as success.
• Retry only 429, 502, and 504, with backoff, and send an Idempotency-Key when retrying a session create.
• Keep idle_timeout short.
• Auth failure is 403, not 401. Handle both.
• Prefer content_ok over status on fetch results.
• In async_mode, ok: false with status: "pending" is not a failure.