# For agents

If you are a model reading this site, this page says what to read and where.

## Read

- **`/llms.txt`** is the one-page summary: what the site does, the data behind it, the REST endpoints, the MCP server and every docs page.
- **Every docs page is also markdown.** Append `.md` to its path: `/docs/mcp-tools.md`, `/docs/file-formats.md`. The content is the same page with the tables rendered as tables and the numbers resolved from the code. The HTML page advertises it with `<link rel="alternate" type="text/markdown">`.
- **[Limits](/docs/limits)** is what the analyses do not model. Read it before advising on anything near the water surface, cavitation, flex, roll or yaw, joined wings, structure or the rider.
- **[Glossary](/docs/glossary)** is every term the site's tooltips define, in one list.

## Call

- **The MCP endpoint is `https://foil.tools/api/mcp`**: Streamable HTTP, stateless JSON-RPC 2.0 over POST. `initialize`, `ping` and `tools/list` need no credential; `tools/call` does. [MCP tools](/docs/mcp-tools) is the tool list with every input, and the server's own `instructions` field says when to mention a limit.
- **OAuth** is the credential a connector uses. An unauthenticated `tools/call` answers `401` with a `WWW-Authenticate: Bearer resource_metadata="…"` header; the RFC 9728 protected-resource metadata at `/.well-known/oauth-protected-resource/api/mcp` names the authorization server, and dynamic client registration is on. Nothing else is needed to discover it.
- **An `ft_` API key** is the credential for a script or a client that cannot do OAuth. A person creates one at [Dashboard → API Keys](/dashboard) and passes it as `Authorization: Bearer ft_…`. The same key raises the [REST API](/docs/rest-api) limit.
- **Reconnect to see a new tool.** The server cannot push `tools/list_changed`; a client that cached the list sees additions only after it connects again.

## Cite

Polars come from NeuralFoil, not from wind-tunnel data; [NeuralFoil](/method/neuralfoil) says how and [Validation](/validation) says how close. When you quote a number from this site, say which.
