Perplexity Agent
PYPI · PERPLEXITY-AGENT-MCP · SCANNED AUG 3
Multi-step web research with citations via Perplexity's Agent API. Standard library only.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (BSD License) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 443 tokens (~147/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
pypi · perplexity-agent-mcp
claude mcp add zalez-perplexity-agent-mcp -- uvx perplexity-agent-mcp
codex mcp add zalez-perplexity-agent-mcp -- uvx perplexity-agent-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zalez-perplexity-agent-mcp": {
"type": "local",
"command": [
"uvx",
"perplexity-agent-mcp"
],
"enabled": true
}
}
} openclaw mcp add zalez-perplexity-agent-mcp --command uvx --arg perplexity-agent-mcp
mcp_servers:
zalez-perplexity-agent-mcp:
command: "uvx"
args: ["perplexity-agent-mcp"] {
"mcpServers": {
"zalez-perplexity-agent-mcp": {
"command": "uvx",
"args": [
"perplexity-agent-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +30
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- MCP protocol: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Schema quality: fail functional
- First check of Schema quality: excellent functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Capabilities: Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet. functional
- Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
- Package version: 0.3.1 → 0.4.0 functional
- 31 Jul 26 −5
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 29 Jul 26 0
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- 28 Jul 26 44
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed pypi/[email protected]
Provenance none
Ecosystem: pypi · Outcome: none
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Dependencies 0 packages
0 packages in the resolved dependency tree.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
perplexity_agent Perplexity Agent Research ~196
Run a research query through Perplexity's Agent API (multi-step web research with citations). Use for deep or multi-hop questions where a single synthesized, sourced answer is wanted. With wait=true (default) this blocks until the answer is ready; if it takes too long you get a response_id to collect later with perplexity_agent_result.
| Name | Type | Req | Description |
|---|---|---|---|
| domains | array | — | Restrict sources to these domains. Prefix with '-' to exclude. Allowlist or denylist, not both. |
| preset | string | — | Research depth: fast, low, medium, high, xhigh, wide-research. Deeper takes longer. |
| query | string | yes | The research question. |
| recency | string | — | Only use sources published within this window. |
| wait | boolean | — | Block until the answer is ready. Set false to get a response_id immediately — useful for running several deep queries in parallel while you do other work. |
No output schema declared.
No examples provided.
perplexity_agent_cancel Cancel Perplexity Research ~62
Ask Perplexity to stop a research run that is no longer needed. Perplexity does not report usage for cancelled runs, so this cannot tell you whether it changed your bill.
| Name | Type | Req | Description |
|---|---|---|---|
| response_id | string | yes | The response_id from perplexity_agent. |
No output schema declared.
No examples provided.
perplexity_agent_result Collect Perplexity Research ~114
Retrieve the result of a research run started by perplexity_agent. If it is still running, reports what it has done so far and how to check again.
| Name | Type | Req | Description |
|---|---|---|---|
| response_id | string | yes | The response_id from perplexity_agent. |
| wait_seconds | integer | — | Block up to this many seconds waiting for completion. 0 checks once. A larger value is silently CLAMPED to this server's configured wait budget (55s here; set PERPLEXITY_AGENT_WAIT_SECONDS to raise i… |
No output schema declared.
No examples provided.