Perplexity · ppl-ai — Claude Code MCP server: web search
Connects an AI assistant to Perplexity web search, reasoning, and research features. Useful when an agent needs current information from the web.
no license updated 2026-10-29
Open on GitHubWhat Perplexity does
The MCP server connects an assistant to the Perplexity Agent API and Search API. An agent can use it to search the web and investigate a question. Choose Perplexity’s hosted server over Streamable HTTP or run the local npm package @perplexity-ai/mcp-server.
You need a Perplexity API key, supplied through client settings or the PERPLEXITY_API_KEY environment variable. For a local Claude Code setup, the server runs through npx; Codex has its own codex mcp add command. The hosted option needs no local installation, but your client must support remote MCP servers.
What it helps with
- search the web for current information through an agent
- ask an assistant to research a question
- connect the Perplexity API to Claude Code
- configure Perplexity web search in an MCP client
Example prompts for the agent
- Search the web for current information on this topic and summarize the findings.
- Research this question with Perplexity and share the web sources you find.
- Connect the Perplexity API to this project for web search.
How to install Perplexity
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 Perplexity
How do I install Perplexity in Claude Code?
For a local setup, provide your API key and run claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server. The hosted server connects over HTTP, but this page does not provide a separate install command for it.
What does the Perplexity MCP server do?
It gives an AI assistant access to Perplexity web search and research features through the Agent API and Search API.
Do I need a Perplexity API key?
Yes. Set PERPLEXITY_API_KEY for the local server. The hosted connection also uses a Perplexity API key.
Similar MCP servers
All MCP servers for AI and ML →Perplexity by other authors comes first.