Perplexity

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
PERPLEXITY_API_KEYYesPerplexity API key (starts with pplx-) Docs.

Setup

  1. Create a Perplexity account: Go to https://www.perplexity.ai and sign up or sign in, then open the API section of your account settings.
  2. Add billing: Add a payment method and credits in the API portal - API calls require a positive credit balance (Pro subscribers receive monthly API credits).
  3. Generate an API key: In https://www.perplexity.ai/account/api/keys, click 'Generate' and copy the key. Add it to your .env file as PERPLEXITY_API_KEY=pplx-...
  4. Verify access: Run the Search Web tool with a simple query. A 401 means the key is invalid; a 402 means you are out of credits.

Provider notes

  • Sonar chat completions and agent responses are billed per token plus per-request search fees - they cost money on every call
  • The Search API is billed per request and returns ranked results without LLM generation

Provider API reference.

Tools

ToolAccessDescription
Search Web<br /><code className="reference-identifier">perplexity__search_web</code>ReadSearch web
Create Chat Completion<br /><code className="reference-identifier">perplexity__create_chat_completion</code>WriteGenerate chat completion
Create Agent Response<br /><code className="reference-identifier">perplexity__create_agent_response</code>WriteGenerate agent response

Verify the connection

Call a read tool such as perplexity__search_web with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.