Skip to main content

How do I connect Zoya to Perplexity?

Add Zoya as a custom MCP connector from the Plugins page in Perplexity, then sign in with your Zoya account.

Add Zoya as a custom MCP connector from the Plugins page in Perplexity, then sign in with your Zoya account. Custom connectors need a paid Perplexity plan (Pro, Max or Enterprise), and you'll need an active Zoya Pro subscription to use Zoya. If your assistant says a Zoya tool requires Zoya Pro, see Why does my AI assistant say a Zoya tool requires Zoya Pro?

Adding Zoya

  1. On perplexity.ai or in the Perplexity desktop app, open Plugins in the sidebar. If you don't see Plugins, open Customize, then Connectors

  2. Select Add custom, then Add MCP connector, and choose Remote

  3. Enter Zoya as the Name and https://mcp.zoya.finance/mcp as the MCP server URL

  4. Open Advanced and set Authentication to OAuth. Leave the client ID and client secret empty

  5. Select the checkbox to confirm you understand the risks of custom connectors, then select Add

  6. Select the Zoya card on the Plugins page to sign in. On Zoya's sign-in page, choose Zoya app account, sign in with the same login you use in the Zoya app, and click Allow access

Using Zoya in a chat

Mention Zoya in your question, for example "Using Zoya, check my watchlist and tell me which stocks aren't Compliant." You can also type @ and select Zoya. If your search is set to Web only, Academic or Social, Perplexity won't use Zoya, so switch back to the default.

I'm on a Perplexity Enterprise workspace

Your admin needs to turn on Allow members to add custom connectors in Organization settings, under Connectors. A connector you added in a personal account doesn't carry over to your Enterprise workspace, so add Zoya there separately.

Staying signed in

Expect to sign in to Zoya again about once a week. When Perplexity asks, sign in with your Zoya app account again.

Troubleshooting

  • If sign-in fails or keeps asking you to sign in again, allow pop-ups and third-party cookies for perplexity.ai, or try a private window. Ad blockers often block the sign-in step

  • If Zoya shows an error, go to Plugins, then Installed, select Disconnect on Zoya, then Connect again. This fixes most problems

  • If Perplexity answers without using Zoya, ask it to, for example "Use Zoya to check Apple"

  • Still stuck? Contact Zoya support and tell us which Perplexity plan you're on

To see what you can ask, see What is the Zoya MCP?

Related Articles
Did this answer your question?