Astro Docs MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Astro docs remote MCP server: search the Astro framework docs. No sign-in needed.
Registry name: (v)
Set it up
URL https://mcp.docs.astro.build/mcp. No sign-in. Paste the URL and it connects. Copy-paste setup: Claude | Claude Code | Cursor | VS Code | ChatGPT
Status grid
| App | Status | Date tested |
|---|---|---|
| Claude | Untested | Not yet tested |
| ChatGPT | Untested | Not yet tested |
| Cursor | Untested | Not yet tested |
| Grok Bot | Untested | Not yet tested |
| MCP Inspector (reference client) | Untested | Not yet tested |
| MCP TypeScript SDK (reference client) | Partial | Fri Oct 16 2026 |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP TypeScript SDK (reference client) | connect (no auth) | Works | 395 ms | Connected without sign-in in 395 ms. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | list tools | Works | 115 ms | 1 tools: search_astro_docs. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search docs ("content collections schema") | Works | 590 ms | search_astro_docs: about 25 KB returned. "{ "search_results": [ { "content": "# En > Guides > Content collections\n## Defining the collection schema\n\nSchemas enforce consistent fro" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search docs ("server islands") | Works | 197 ms | search_astro_docs: about 21 KB returned. "{ "search_results": [ { "content": "# En > Guides\n## Server islands\n\nServer islands allow you to on-demand render dynamic or personalized" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search with nonsense query | Partial | 487 ms | search_astro_docs: about 17 KB returned. "{ "search_results": [ { "content": "# En > Guides > Integrations-guide > @astrojs/ sitemap > Configuration\n## `xslURL`\n\n**Type:** `string" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | error handling (number as query) | Works | 64 ms | Protocol error: MCP error -32602: MCP error -32602: Invalid arguments for tool search_astro_docs: [ { "code": "invalid_type", "expected": "string", "received": "number", "path" | Oct 16, 2026, 4:45 PM CT |
Oct 16, 2026, 4:45 PM CT, MCP TypeScript SDK (reference client): Scripted client using the official MCP TypeScript SDK v1.32.1 against https://mcp.docs.astro.build/mcp (Streamable HTTP, protocol 2025-06-18). No sign-in needed. Server Astro Docs server v1.0.0. Read-only server, so no create task. 5 of 6 tasks passed.
Automated handshake
No public remote endpoint to check (local or package-only server).
Gotchas
- MCP TypeScript SDK (reference client): Results are large (about 25 KB per search).
- MCP TypeScript SDK (reference client): A nonsense query returned about 17 KB of unrelated docs instead of an empty result.
Errors and fixes
FAQ
Does the Astro Docs MCP server work?
In our hands-on test on Oct 16, 2026, 5 of 6 tasks passed. Main gotcha: Results are large (about 25 KB per search).
What is the Astro Docs MCP server URL?
https://mcp.docs.astro.build/mcp (Streamable HTTP).
Does the Astro Docs MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the Astro Docs MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/astro-docs/setup/claude https://connectorreport.com/c/astro-docs/setup/claude-code https://connectorreport.com/c/astro-docs/setup/cursor https://connectorreport.com/c/astro-docs/setup/vscode https://connectorreport.com/c/astro-docs/setup/chatgpt
What errors does the Astro Docs MCP server give?
MCP search returns results for nonsense queries.
Compare
Best MCP servers for documentation and docs search
Compare with other tested connectors | Connector Weather
Request a hands-on test of Astro Docs
Get the badge
Maintain Astro Docs or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/astro-docs?utm_source=badge&utm_medium=embed&utm_campaign=astro-docs)
HTML
<a href="https://connectorreport.com/c/astro-docs?utm_source=badge&utm_medium=embed&utm_campaign=astro-docs"><img src="https://connectorreport.com/badge/astro-docs.svg" alt="Astro Docs MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work