For agents
If you are a model reading this site, this page says what to read and where.
Read
/llms.txtis 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
.mdto 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,pingandtools/listneed no credential;tools/calldoes. MCP tools is the tool list with every input, and the server's owninstructionsfield says when to mention a limit. - OAuth is the credential a connector uses. An unauthenticated
tools/callanswers401with aWWW-Authenticate: Bearer resource_metadata="…"header; the RFC 9728 protected-resource metadata at/.well-known/oauth-protected-resource/api/mcpnames 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 asAuthorization: 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.