# Developer docs

Read the Interlinea library from an AI assistant, your own code or a script: Latin and Greek texts with citations, stored word analyses and context notes. Free, read only, no key.

Canonical: https://interlinea.aeterna-institute.org/docs

> Arma virumque cano, Troiae qui primus ab oris
> Italiam, fato profugus, Laviniaque venit
> litora, multum ille et terris iactatus et alto
> vi superum saevae memorem Iunonis ob iram;
> multa quoque et bello passus, dum conderet urbem,

Virgil, Aeneid 1.1-45, urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.45. From `GET /api/v1/text?ref=Virgil, Aeneid 1.1`.

- [MCP server](https://interlinea.aeterna-institute.org/docs/quickstart.md#mcp): Add one URL to Claude, ChatGPT, Cursor or VS Code, and the assistant can search and read the library.
- [REST API](https://interlinea.aeterna-institute.org/docs/quickstart.md#rest): JSON over GET with an OpenAPI document. Call it from a browser, a script or a server.
- [Markdown](https://interlinea.aeterna-institute.org/docs/quickstart.md#markdown): Add .md to any author, work or section URL for plain text with its citation and credit.

## What you can do

- Read any text in the library, a section at a time, with its citation, canonical URL, CTS URN where the edition has one, and the edition's credit and licence. Each section links to the next, so you can read a whole work in order.
- Get the stored word-by-word analysis: each word's dictionary form, grammar, role in the sentence and meaning in context, with a translation of each sentence.
- Get the context notes: what has happened so far, who and where is named, and what comes next.
- Follow the graded path: short Latin and Greek passages for learners, levels 1 to 5, each analysed in full.
- Search authors, works and topics, and look a word up across every stored analysis.

## What it costs

Nothing. Every endpoint is free and read only, with no key, no account and no cookies. Please keep to about 120 requests a minute from one address. Past that you get `429 Too Many Requests` for the rest of the minute. If you need more, [write to us](https://interlinea.aeterna-institute.org/contact).

Nothing here calls a language model. You get what is stored: every graded passage is analysed in full, and a library section once a reader has opened it in Interlinea. [Analyses and context](https://interlinea.aeterna-institute.org/docs/analyses.md) explains when each exists.

## Reading these pages

Code here takes the reader's case colours, and a colour marks a role, as a case does in a sentence. HTTP methods and tool calls are verbs, so they are rubric red.

- Nominative: names: keys and fields, such as `"citation"`.
- Accusative: strings, such as `"Arma virumque cano"`.
- Dative: numbers, such as `46`.
- Genitive: keywords, such as `await`.
- Ablative: true, false and null, such as `null`.
- Vocative: flags, such as `--transport`.
- Verb: commands, function calls and HTTP methods, such as `GET`.

## Next steps

- [Quickstart](https://interlinea.aeterna-institute.org/docs/quickstart.md): connect an assistant or make your first request.
- [MCP server](https://interlinea.aeterna-institute.org/docs/mcp.md): the tools and resources an assistant sees.
- [REST API](https://interlinea.aeterna-institute.org/docs/api.md): every endpoint, with examples you can run.
- [Citations and CTS URNs](https://interlinea.aeterna-institute.org/docs/citations.md) and [Editions and licences](https://interlinea.aeterna-institute.org/docs/licences.md): how to name a text and how to credit it.

---

Next: [Quickstart](https://interlinea.aeterna-institute.org/docs/quickstart.md)