Skip to the content
Surface

AI

llms.txt

The documents as plain text files for agents: llms.txt, the full and the short form, and one file for each page.This page as Markdown
Statuscurrent on 2026-11-06, for version 0.
Related documentsSurface for agents, MCP server
This website serves its documents as plain text for agents. A file is one request, so an agent with no MCP can read the documents too.
Address
Content
/llms.txt
The list of the documents, with a link to each one and its summary, in the format of llmstxt.org
/llms-full.txt
All documents in one file
/llms-small.txt
A short form for a small context. It has the full text of getting started. Of each other document, it has the headings, the first paragraph under each heading, and the Surf samples
/docs/<page>.md
One document as Markdown, for example /docs/getting-started.md
/SKILLS.md
The list of the skills
/install.sh
The install script of surf
Each page of the documents has a link to its Markdown file.

1. Choose a file

  • The agent needs one feature. Give it the Markdown file of that page. It is the smallest file.
  • The agent has a large context. Give it /llms-full.txt.
  • The agent has a small context. Give it /llms-small.txt, and the Markdown file of each page that the task needs.
The files and the MCP server have the same text. The MCP server also checks the code, so use it when the agent has MCP.

2. The source of the files

The build of the website writes the files. It reads the list DOCUMENTS of crates/surf-mcp, which is also the list of the MCP server. So the files, the pages and the server always have the same documents.