Perplexity Agent MCP Server

by zalezio.github.zalez/perplexity-agent-mcpv0.4.0

Multi-step web research with citations via Perplexity's Agent API. Standard library only.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install Perplexity Agent MCP server

claude mcp add perplexity-agent -e PERPLEXITY_API_KEY='<perplexity-api-key>' -- uvx perplexity-agent-mcp

{
  "mcpServers": {
    "perplexity-agent": {
      "command": "uvx",
      "args": [
        "perplexity-agent-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "<perplexity-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "perplexity-agent": {
      "command": "uvx",
      "args": [
        "perplexity-agent-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "<perplexity-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "perplexity-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "perplexity-agent-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "<perplexity-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "perplexity-agent": {
      "command": "uvx",
      "args": [
        "perplexity-agent-mcp"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "<perplexity-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PERPLEXITY_API_KEY	yes	yes	Your Perplexity API key. Read at call time and sent only as an Authorization header to api.perplexity.ai; never logged or echoed.
PERPLEXITY_AGENT_WAIT_SECONDS	—	—	How long a blocking call waits before handing back a response_id to collect later. Defaults to 55, just inside Claude Desktop's unconfigurable 60s tool-call timeout. Raise to 300 on clients without that limit.

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-01 · 9d ago · GitHub
Latest release
2026-08-04 · 2mo ago · GitHub · v0.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-02 · 2mo ago · official registry · v0.4.0

FAQ

›How do I install the Perplexity Agent MCP server in Claude Code?

Run: claude mcp add perplexity-agent -e PERPLEXITY_API_KEY='<perplexity-api-key>' -- uvx perplexity-agent-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Perplexity Agent require an API key?

Yes. It expects PERPLEXITY_API_KEY, of which 1 is a secret.

›Can I use Perplexity Agent as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Perplexity Agent in the official MCP registry?

Yes, as io.github.zalez/perplexity-agent-mcp.