The canonical agent setup guide.
start.md is the canonical machine-readable setup guide for agents. It carries the whole setup procedure in one document — an agent fetches it once and can start immediately.
https://expand.ai/start.mdThe route returns the guide as text/markdown, so any agent that can read a URL can ingest it directly.
Read the hosted guide that the setup prompt points an agent at.
The curated docs index. It links start.md before general docs.
Paste this into any coding agent.
Read https://expand.ai/start.md and set up Expand.This mirrors the setup prompt the hosted /llms.txt and the CLI emit. The Copy setup prompt button in the app produces the same instruction, and adds a single-use authorization when you are signed in.
| Section | What the agent does |
|---|---|
| Setup | Identifies its own harness, asks for project or global scope, and runs one non-interactive expandai init. |
| Authorization | Relays the browser approval URL and resumes init with the one-time setup code. |
| Proof | Fetches a live page through the installed integration and answers with an exact cited sentence. |
| Optional SDK setup | Asks before adding the SDK to a confirmed project path. |
The exact commands live in the guide itself. This page does not mirror them.
init detects every supported harness on the machine, and the guide asks which of them to configure before writing anything. Only the selected ones are touched; the rest are left alone.
https://expand.ai/start.md is the hosted public Markdown route. expand://start is a local MCP docs resource.
expand://start is only available when the MCP server is run with docs resources enabled, for example through expandai mcp run --docs. Do not assume it exists after a normal first-class MCP install.
See Other MCP Clients for how to wire and run the MCP server.
| Resource | Use when |
|---|---|
start.md | An agent needs setup instructions. |
llms.txt | An agent needs the compact docs index. |
llms-full.txt | An agent needs a larger docs bundle. |
| Other ways to use Expand | HTTP API and CLI usage, for callers that are not coding agents. |
| Markdown docs pages | An agent needs one specific authored docs page. |