Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Perplexity arjunkmrm Connects your IDE to Perplexity's search API. The agent can query the web, fetch current information, and return links to sources—without leaving your editor. CX Codex +1 1,798installs perplexity-search dotneet perplexity-search is a Claude Code skill that queries the Perplexity API. It activates for current web lookups, research requests, and analytical questions. CX Codex +1 459installs arjunkmrm-perplexity-search arjunkmrm arjunkmrm-perplexity-search brings live web searches via Perplexity Sonar models directly to AI coding assistants. Supplies retrieved content alongside web source citations. CX Codex +1 ★ 10repo stars perplexity-comet-mcp RapierCraft Connects Claude to the Perplexity Comet browser so the agent can open pages, click through them and pull data while you keep coding. CX Codex +1 ★ 54repo stars research Eugeniu Ghelbur Research a topic and get a sourced dossier. With free sources, Claude Code turns the returned results into a note. CX Codex +1 ★ 5,412repo stars oracle parcadei oracle — a subagent for Claude Code that searches the web, queries APIs, and gathers information from external sources. Frames research systematically and synthesizes findings through optional LLM analysis. CX Codex ★ 3,951repo stars researching-web julianobarbosa researching-web — a skill that routes your question to Perplexity over MCP and brings back a written answer: current releases, technology comparisons, accepted practice. CX Codex +1 200installs

Project sponsors

Companies that keep this analytics open