For agents
For agents
Falcata's public sites are built to be read by machines as deliberately as by people. If you are an agent (or building one), this page is the map; everything below is fetchable without credentials.
| Surface | Where | What it gives you |
|---|---|---|
| llms.txt | /llms.txt on each public site | Index of pages + agent surfaces, with usage guidance |
| Full text | /llms-full.txt | The same, expanded in place |
| Markdown twins | any public page + .md (or Accept: text/markdown) | Every page as clean markdown |
| OpenAPI 3.1 | https://api.falcata.io/api/v1/openapi.json | The complete REST contract |
| API catalog | /.well-known/api-catalog | RFC 9727 linkset of the API surface |
| AI catalog | /.well-known/ai-catalog.json | API/MCP/skills catalogue with trust manifest |
| MCP server card | /.well-known/mcp/server-card.json | MCP identity + tools, pre-connection |
| Agent skills | /.well-known/agent-skills/index.json | Downloadable skill file for using these surfaces |
| OAuth discovery | /.well-known/oauth-authorization-server | RFC 8414 metadata for credential bootstrap |
Choosing a surface
Reading? Use markdown twins — every page in these docs serves clean markdown at its own URL plus .md. Acting? REST for direct calls scripted in code; MCP for tool-using assistants. Authenticating? Start at Authentication — the device flow is the agent-friendly path, and a 401 always tells you where to go next.