# Perplexity MCP server > Search the live web, ask questions and run deep research through the Perplexity Search and Agent APIs. - Listing: https://mcp.tc/i/perplexity - Connect: use the server's own URL `https://api.perplexity.ai/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint. - Type: remote (Streamable HTTP) - Auth: OAuth sign-in - Category: [Search & Web Data](https://mcp.tc/c/search-web) - Vendor: Perplexity - Verified: yes, mcp.tc checked that this is the official server (https://mcp.tc/verify). It says who runs the server, not that it is safe. - Homepage: - Repository: - Package: npm `@perplexity-ai/mcp-server` ## About Connects an assistant to the Perplexity API Platform. It can run direct web searches that return ranked results, answer questions with real-time web context, and carry out deeper multi-step research. Search supports recency filters, domain restrictions and a fast mode for lower latency. Runs as a hosted Streamable HTTP endpoint at https://api.perplexity.ai/mcp. Sign in with Perplexity through OAuth, or send an Authorization: Bearer header with a Perplexity API key. Usage is billed to your API organization. A local alternative runs with npx and the PERPLEXITY\_API\_KEY environment variable, and a self-hosted HTTP mode is available. ## What it can do - Run direct web searches with ranked results and metadata - Filter searches by recency or by domain - Use fast search for lower latency and cost - Ask questions answered with real-time web context - Run deep research for thorough analysis ## Example prompts - "Search the web for the latest news on the EU AI Act, last week only." - "Ask Perplexity what changed in the newest Node.js release." - "Do deep research on solid-state battery makers and summarize the findings." - "Search only docs.python.org for asyncio TaskGroup examples." ## Install ### Claude Code 1. Run this in a terminal, in your project folder: ```bash claude mcp add --transport http perplexity https://api.perplexity.ai/mcp ``` 2. Start Claude Code, type `/mcp`, pick **perplexity** and choose **Authenticate**. A browser window opens for the Perplexity sign-in. Add `--scope user` to make it available in every project, not just this one. ### Claude Desktop 1. Open **Settings → Connectors** and click **Add custom connector**. 2. Name it **Perplexity** and paste this URL: ```url https://api.perplexity.ai/mcp ``` 3. Click **Add**, then **Connect**, and sign in when Perplexity asks. Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too. ### claude.ai 1. Open the connector form on claude.ai. This button fills in the name and URL for you: [Add to claude.ai]() (opens connector settings) 2. Check that the URL reads `https://api.perplexity.ai/mcp` and click **Add**. 3. Click **Connect** and sign in when Perplexity asks. Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**. ### ChatGPT 1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. 2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server. 3. Paste `https://api.perplexity.ai/mcp` as the server URL and choose **OAuth**. ChatGPT sends you to Perplexity to sign in. Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts. ### Cursor [Add to Cursor]() (opens Cursor) Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project): `mcp.json`: ```json { "mcpServers": { "perplexity": { "url": "https://api.perplexity.ai/mcp" } } } ``` Cursor shows **Needs login** next to the server. Click it to sign in. ### VS Code [Install in VS Code]() (opens VS Code) Or from a terminal: ```bash code --add-mcp '{"name":"perplexity","type":"http","url":"https://api.perplexity.ai/mcp"}' ``` Or commit it to the repo in `.vscode/mcp.json`: `.vscode/mcp.json`: ```json { "servers": { "perplexity": { "type": "http", "url": "https://api.perplexity.ai/mcp" } } } ``` VS Code asks you to sign in the first time the server starts. ### Devin Desktop 1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows): `mcp_config.json`: ```json { "mcpServers": { "perplexity": { "serverUrl": "https://api.perplexity.ai/mcp" } } } ``` 2. Refresh the MCP server list in Cascade and sign in when asked. Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers. ### Codex ```bash codex mcp add perplexity --url https://api.perplexity.ai/mcp codex mcp login perplexity ``` Or edit `~/.codex/config.toml` directly: `config.toml`: ```toml [mcp_servers.perplexity] url = "https://api.perplexity.ai/mcp" ``` ### Gemini CLI ```bash gemini mcp add --transport http perplexity https://api.perplexity.ai/mcp ``` Then, inside Gemini CLI, run `/mcp auth perplexity` to sign in. This adds it to the current project. Add `-s user` to use it everywhere. ### Any client Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file. ```json { "mcpServers": { "perplexity": { "type": "http", "url": "https://api.perplexity.ai/mcp" } } } ``` Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE. Client only starts local servers? Bridge it with `npx -y mcp-remote https://api.perplexity.ai/mcp`. ## Details - Server version: 1.2.1 - Last checked: 2026-10-03 (reachable, asks for credentials) - Listed: 2026-10-03 - Updated: 2026-10-03 --- Source: https://mcp.tc/i/perplexity (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report