Perplexity Agent MCP server
io.github.zalez/perplexity-agent-mcp·v0.4.0Multi-step web research with citations via Perplexity's Agent API. Standard library only.
0 stars22 downloads/wk
Reviews
Write oneNobody has reviewed Perplexity Agent yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Perplexity Agent tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumsubprocess with shell=True
exec.shell-trueperplexity_agent_mcp-0.4.0/pyproject.toml: …([sys.executable, str(SERVER)]) — never shell=True, never # attacker-controlled input. Ban…
How Perplexity Agent compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 4,464 AI and agents servers
- Downloads a week
- 22
- more than 8% of 1,515 AI and agents servers with a package
Install Perplexity Agent in Claude Code, Cursor or VS Code
claude mcp add perplexity-agent-mcp -- uvx perplexity-agent-mcp
What the publisher says
From the Perplexity Agent repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.zalez/perplexity-agent-mcp -->
perplexity-agent-mcp
A single-file, zero-third-party-dependency MCP server for Perplexity's Agent API — multi-step web research with citations, exposed to any MCP client over stdio.
Python standard library only: no MCP SDK, no HTTP library, no code generated at build time. perplexityagentmcp.py holds your API key and talks to the network on your behalf, so it is written to be read — 1,774 lines, comments included. Both install paths below ship the exact same file; which one you pick changes how many other parties you're trusting to get it onto your disk, not what actually runs.
Background reading: perplexity-agent-mcp: an open-source MCP server for Perplexity's Agent API — why this exists, what the Agent API does that Sonar doesn't, and what building it turned up.
Why this exists
Perplexity's own @perplexity-ai/mcp-server wraps the Sonar chat models and the Search API. It does not reach the Agent API (POST /v1/agent) — Perplexity's multi-step, tool-using research endpoint, which runs its own web searches, fetches pages, and synthesizes one cited answer. This server fills exactly that gap. It's meant to run alongside the official one, not replace it.
The three tools
The Agent API is asynchronous under the hood (see Configuration for why that matters), so this server exposes it as one lifecycle, not one call:
Full parameters
perplexityagent**
perplexityagentresult
perplexityagentcancel
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Perplexity Agent: common questions
- Is Perplexity Agent MCP server safe?
- Mostly: it is graded B (75/100). Read the Perplexity Agent safety report
- How do I install Perplexity Agent?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Perplexity Agent need an API key?
- Yes. The registry entry asks for
PERPLEXITY_API_KEY. - Is Perplexity Agent maintained?
- The last commit was 39 days ago (2026-09-24). The latest release is v0.4.0.
- What can I use instead of Perplexity Agent?
- Servers from other publishers that do the same job: agent-device MCP server, PaperBanana MCP server and You.com Web Access & AI MCP server.
- How does Perplexity Agent compare with other AI and agents MCP servers?
- safety score 75/100 (higher than 45% of 4,464 AI and agents servers); downloads a week 22 (more than 8% of 1,515 AI and agents servers with a package). Full comparison.
Alternatives to Perplexity Agent
Same job from other publishers: the closest match first, then the best rated.
- agent-deviceOpen source device layer for AI agents: control mobile, web, TV, and desktop apps over MCPnot reviewedWidely usedA
- PaperBananaGenerate academic diagrams and statistical plots from text using multi-agent AI.not reviewedEstablishedA
- You.com Web Access & AIWeb search, AI agent, and content extraction via You.com APIsnot reviewedEstablishedA
- Robin: AI-Powered Dark Web OSINTDark web OSINT over Tor: search onion engines, scrape pages, report with your own model.not reviewedEstablishedA
GeminiModel Context Protocol server for Google Gemini AI with chat, research, and groundingnot reviewedEstablishedA