Perplexity Docs MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Perplexity API docs remote MCP server: search Sonar API docs. No sign-in needed.
Registry name: (v)
Set it up
URL https://docs.perplexity.ai/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 | 671 ms | Connected without sign-in in 671 ms. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | list tools | Works | 295 ms | 3 tools: search_perplexity, query_docs_filesystem_perplexity, submit_feedback. | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search docs ("sonar API search_domain_filter") | Works | 803 ms | search_perplexity: about 63 KB returned. "Title: Search Domain Filter Link: https://docs.perplexity.ai/docs/search/filters/domain-filter Page: docs/search/filters/domain-filter Conte" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | browse docs filesystem (ls /) | Works | 201 ms | query_docs_filesystem_perplexity: 50 characters returned. "exit: 0 --- stdout --- api-reference docs openapi " | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | search with nonsense query | Partial | 1398 ms | search_perplexity: about 22 KB returned. "Title: Installation Link: https://docs.perplexity.ai/docs/cookbook/examples/file-attachment-qa/README#installation Page: docs/cookbook/examp" | Oct 16, 2026, 4:45 PM CT |
| MCP TypeScript SDK (reference client) | error handling (number as query) | Works | 152 ms | search_perplexity: tool error, 109 characters returned. "Input validation error: Invalid arguments for tool search_perplexity: query: Expected string, received number" | 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://docs.perplexity.ai/mcp (Streamable HTTP, protocol 2025-11-25). No sign-in needed. Mintlify-hosted docs server (search plus a read-only docs filesystem). Server Perplexity 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): Search results are large (about 63 KB for one query).
- MCP TypeScript SDK (reference client): A nonsense query still returns unrelated docs instead of an empty result, so an agent cannot tell "nothing found" from a weak match.
Errors and fixes
FAQ
Does the Perplexity Docs MCP server work?
In our hands-on test on Oct 16, 2026, 5 of 6 tasks passed. Main gotcha: Search results are large (about 63 KB for one query).
What is the Perplexity Docs MCP server URL?
https://docs.perplexity.ai/mcp (Streamable HTTP).
Does the Perplexity Docs MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the Perplexity Docs MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/perplexity-docs/setup/claude https://connectorreport.com/c/perplexity-docs/setup/claude-code https://connectorreport.com/c/perplexity-docs/setup/cursor https://connectorreport.com/c/perplexity-docs/setup/vscode https://connectorreport.com/c/perplexity-docs/setup/chatgpt
What errors does the Perplexity 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 Perplexity Docs
Get the badge
Maintain Perplexity Docs or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/perplexity-docs?utm_source=badge&utm_medium=embed&utm_campaign=perplexity-docs)
HTML
<a href="https://connectorreport.com/c/perplexity-docs?utm_source=badge&utm_medium=embed&utm_campaign=perplexity-docs"><img src="https://connectorreport.com/badge/perplexity-docs.svg" alt="Perplexity Docs MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work