Perplexity

​

At a glance

• Availability: Experimental (how to enable).
• Authentication: API key.
• Connection: The key comes from PERPLEXITY_API_KEY.
• Provider documentation: Authentication reference.

​

Credentials

Set these per environment. See Connect an integration.

​

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

​

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.