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 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 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 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 and passes it as Authorization: Bearer ft_…. The same key raises the 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 says how and Validation says how close. When you quote a number from this site, say which.