SETTO API

Docs for LLMs

Every page of these docs is available as raw Markdown, plus llms.txt, llms-full.txt and openapi.json — the machine-readable artifacts an AI agent or a RAG pipeline needs.

These docs are written to be read twice: once by you, once by a model. Every page has a raw Markdown twin, the whole site is available as two plain-text bundles, and the API contract is published as OpenAPI. No scraping, no JavaScript rendering, no API key.

The four artifacts

URLWhat it isUse it for
/llms.txtAn index: one line per page, with its title and descriptionLetting an agent decide what to fetch
/llms-full.txtEvery page's Markdown concatenated into one documentDropping the whole documentation into a context window
<page>.mdAny single page as raw MarkdownFetching exactly the page you need
/openapi.jsonThe OpenAPI 3 description of the six endpointsGenerating a client, or feeding a tool-calling model

llms.txt and llms-full.txt

/llms.txt follows the llms.txt convention: a short Markdown index of the site, one bullet per page, cheap to fetch and cheap to read. Start there when you want a model to pick its own reading.

curl -s https://docs.setto.io/llms.txt

/llms-full.txt is the same site with the bodies included — every guide, every concept page and the whole generated reference in one response. It is the single-request way to give a model everything:

curl -s https://docs.setto.io/llms-full.txt

Both describe the canonical English site. Spanish pages live under /es/docs/… and have the same .md twins.

Any page as Markdown

Append .md to a docs URL and you get the source Markdown instead of the rendered page:

curl -s https://docs.setto.io/docs/concepts/populate.md
curl -s https://docs.setto.io/docs/guides/get-round.md
curl -s https://docs.setto.io/es/docs/quickstart.md

Generated reference pages work too. Their rendered form is an interactive component, so the Markdown twin is assembled from the OpenAPI document instead — method and path, auth, a parameter table, the response table and a curl example:

curl -s https://docs.setto.io/docs/reference/tournaments/list-tournaments.md

Copy and open-in-AI actions

Every page carries two controls under its title:

  • Copy Markdown — puts that page's raw Markdown on your clipboard, ready to paste into a chat.
  • View options — the same page as Markdown in a new tab, or opened directly in ChatGPT, Claude or another assistant with a prompt that references the URL.

They are the one-click version of the curl commands above; use whichever fits.

/openapi.json

curl -s https://docs.setto.io/openapi.json

The document the API reference is generated from, with servers[0].url already pointing at the live API host. Six operations, stable operationIds — getMe, listTournaments, getTournament, listDivisions, listTeams, getRound — so a generated client or a tool-calling model gets the same names the guides use.

For RAG builders

A few properties worth relying on:

  • URLs are stable. A page's path is its identity; we do not renumber pages or reshuffle sections underneath a URL. Store the URL as the citation for a chunk and it keeps pointing at the same material.
  • .md is the canonical text. Index the Markdown twin, not the rendered HTML — no navigation chrome, no duplicated sidebar text, and headings map cleanly onto chunks.
  • Headings are meaningful. Every page starts with a one-paragraph summary under the title, then ## sections that stand alone. Chunk on ## and each chunk is still answerable.
  • Re-crawl cheaply. Fetch /llms.txt and diff it to see which pages exist; fetch /llms-full.txt when you want everything in one request.
  • The reference is generated. /docs/reference/** is produced from /openapi.json. If you are indexing for API questions, the OpenAPI document is the denser, more reliable source.
  • Two locales, one content tree. English is unprefixed, Spanish is under /es/. Pages that have no Spanish translation yet fall back to the English text at the Spanish URL, so treat /es/… duplicates as the same document.
  • MCP server — live tournament data as tool calls, not docs.
  • Agent Skills — the setto-api skill and how to install it.
  • API reference — the rendered form of /openapi.json.

On this page

The four artifactsllms.txt and llms-full.txtAny page as MarkdownCopy and open-in-AI actions/openapi.jsonFor RAG buildersRelated