Astro Docs · withastro — Claude Code MCP server: what it does, how to install
The Astro Docs remote MCP server gives AI tools access to Astro documentation, guides, and API references. Connect it when you want an agent to answer Astro questions while you work on code.
no license updated 2026-10-29
Open on GitHubWhat Astro Docs does
Astro Docs connects an AI tool to the Astro documentation over MCP. An agent can consult material about framework features and APIs while answering questions or helping with code. The server is remote, so there is no local server package to install.
In Claude Code, add it with claude mcp add --transport http "Astro docs" https://mcp.docs.astro.build/mcp. The connection uses the name Astro docs, the server URL https://mcp.docs.astro.build/mcp, and HTTP transport. It uses streamable HTTP, so remote MCP clients limited to SSE cannot connect directly. Windsurf needs a local proxy, mcp-remote, launched with npx.
What it helps with
- look up Astro framework features
- check the purpose of an Astro API method
- consult Astro docs while writing code
- get guidance from Astro documentation
Example prompts for the agent
- Find how routing works in Astro for this project.
- Explain how to use the Astro API for this task.
- Check my code against Astro documentation and suggest which method to use.
How to install Astro Docs
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Astro Docs
How do I install Astro Docs in Claude Code?
Run claude mcp add --transport http "Astro docs" https://mcp.docs.astro.build/mcp in a terminal. This registers the remote MCP server over HTTP.
What does Astro Docs do?
It lets an AI tool consult Astro documentation, including guides and API references. You can ask questions about the framework while working on code.
Can Astro Docs connect to clients that only support SSE?
No. The server uses streamable HTTP, which does not work with clients limited to SSE for remote MCP servers. Windsurf can use the documented local mcp-remote proxy launched through npx.
Similar MCP servers
All MCP servers for Writing and docs →Astro Docs by other authors comes first.