v0.1.0 — first release

A single-file, zero-third-party-dependency MCP server exposing Perplexity's Agent API (POST /v1/agent) — multi-step web research with citations — to any MCP client over stdio.

Python standard library only: no MCP SDK, no HTTP library, nothing generated at build time. The audit boundary is exactly one file.

Tools

Tool	What it does
perplexity_agent	Start a research run. Blocks for the answer, or returns a response_id with wait: false.
perplexity_agent_result	Collect a run. Reports real progress while it is still going.
perplexity_agent_cancel	Ask Perplexity to stop a run you no longer need.

Install

Both paths ship the same bytes. See the README for the trust-chain comparison and the full config.

{
  "mcpServers": {
    "perplexity-agent": {
      "command": "/absolute/path/to/uvx",
      "args": ["--from", "git+https://github.com/zalez/perplexity-agent-mcp@v0.1.0",
               "perplexity-agent-mcp"],
      "env": { "PERPLEXITY_API_KEY": "pplx-…" }
    }
  }
}

Verification

158 tests (stdlib unittest, no install step), green on Python 3.10–3.14. Every acceptance criterion exercised against the live API.

Security posture, including the prompt-injection mitigation and its limits, is documented honestly in SECURITY.md.