Official MCP server for the Perplexity API, offering web-grounded search and answers.
Official MCP server for the Perplexity API, offering web-grounded search and answers.
Perplexity API Platform MCP Server
The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through the Agent API and the Search API.
The remote MCP server is hosted by Perplexity and is the easiest way to get started: same tools, nothing to install or update. The Cursor and VS Code buttons at the top of this page connect to it with one click. If your MCP client does not support remote servers yet, skip to the local server setup below. Connect over Streamable HTTP with your Perplexity API key:
For Claude Code:
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
See the MCP integration docs for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients.
your_key_here in the configurations below with your API keyPERPLEXITY_TIMEOUT_MS=600000 (default: 5 minutes)PERPLEXITY_BASE_URL=https://your-custom-url.com (default: https://api.perplexity.ai)PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (default: ERROR)claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
Or install via plugin:
export PERPLEXITY_API_KEY="your_key_here"
claude
codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
This repository is packaged as an Agent Plugin, so clients that support the standard can install it directly from this repository. The Agent Plugins format does not carry secrets, so set the PERPLEXITY_API_KEY environment variable through your client's plugin or MCP settings.
Most clients can be configured manually using the same mcpServers wrapper in their client config (as shown for Cursor). If a client has a different schema, check its docs for the exact wrapper format.
For manual setup, these clients all use the same mcpServers structure:
| Client | Config File |
| Cursor | ~/.cursor/mcp.json |
| Claude Desktop | claude_desktop_config.json |
| Kiro | .kiro/settings/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | .vscode/mcp.json |
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["-y", "@perplexity-ai/mcp-server"],
"env": {
"PERPLEXITY_API_KEY": "your_key_here"
}
}
}
}
If you are running this server at work—especially behind a company firewall or proxy—you may need to tell the program how to send its internet traffic through your network's proxy. Follow these steps:
• Ask your IT department for your HTTPS proxy address and port.
• You may also need a username and password.
The easiest and most reliable way for Perplexity MCP is to use PERPLEXITY_PROXY. For example: …
MCP server · MCP servers / Search · Open Source · MIT · TypeScript
Website https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server · Repo https://github.com/perplexityai/modelcontextprotocol · Docs https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server
2,620 stars · 391 forks · 24 open issues · pushed 2026-10-21 · verified 2026-11-12
Tags: ai-agents, mcp-server, search
Install: claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
What is Perplexity MCP Server? Perplexity MCP Server is a research website listed on Scriptiii Webnest. Official MCP server for the Perplexity API, offering web-grounded search and answers. Pricing: Free. Free to use. Best for: ai-agents, mcp-server, search.
Everything you need to know about Perplexity MCP Server
Similar websites in Research
Web data API that turns websites into LLM-ready Markdown or structured data.
Research·Free
MCP server for Tavily search, extract, map and crawl APIs, hosted remotely or run locally.
Research·Free