perplexity.com
perplexity.com logo

Perplexity

Connector for the Perplexity API, to enable web search without leaving the MCP ecosystem.

Created byApr 22, 2025

Perplexity Ask MCP Server

An MCP server implementation that integrates the Sonar API to provide Claude with unparalleled real-time, web-wide research.
Demo

Tools

  • perplexity_ask

Configuration

Step 1:

Clone this repository:
Navigate to the perplexity-ask directory and install the necessary dependencies:

Step 2: Get a Sonar API Key

  1. Sign up for a Sonar API account.
  1. Follow the account setup instructions and generate your API key from the developer dashboard.
  1. Set the API key in your environment as PERPLEXITY_API_KEY.

Step 3: Configure Claude Desktop

  1. Download Claude desktop here.
  1. Add this to your claude_desktop_config.json:

NPX

You can access the file using:

Step 4: Build the Docker Image

Docker build:

Step 5: Testing

Let's make sure Claude for Desktop is picking up the two tools we've exposed in our perplexity-ask server. You can do this by looking for the hammer icon:
Claude Visual Tools
After clicking on the hammer icon, you should see the tools that come with the Filesystem MCP Server:
Available Integration
If you see both of these this means that the integration is active. Congratulations! This means Claude can now ask Perplexity. You can then simply use it as you would use the Perplexity web app.

Step 6: Advanced parameters

Currently, the search parameters used are the default ones. You can modify any search parameter in the API call directly in the index.ts script. For this, please refer to the official API documentation.

Troubleshooting

The Claude documentation provides an excellent troubleshooting guide you can refer to. However, you can still reach out to us at api@perplexity.ai for any additional support or file a bug.

Cursor integration

You can also use our MCP with Cursor (or any other app that supports this). To use Sonar with Cursor, you can follow the following steps.

Step 1: Navigate to your Cursor settings:

Cursor Settings

Step 2: Navigate to the MCP directory

And click on Add new global MCP server
Add Server

Step 3: Insert the MCP Server Configuration from above

This is the same configuration you would use for any other application that supports MCP.
You should then see the application being part of your available tools like this:
Cursor MCP

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Perplexity Ask MCP Server

An MCP server implementation that integrates the Sonar API to provide Claude with unparalleled real-time, web-wide research.
Demo

Tools

  • perplexity_ask

Configuration

Step 1:

Clone this repository:
Navigate to the perplexity-ask directory and install the necessary dependencies:

Step 2: Get a Sonar API Key

  1. Sign up for a Sonar API account.
  1. Follow the account setup instructions and generate your API key from the developer dashboard.
  1. Set the API key in your environment as PERPLEXITY_API_KEY.

Step 3: Configure Claude Desktop

  1. Download Claude desktop here.
  1. Add this to your claude_desktop_config.json:

NPX

You can access the file using:

Step 4: Build the Docker Image

Docker build:

Step 5: Testing

Let's make sure Claude for Desktop is picking up the two tools we've exposed in our perplexity-ask server. You can do this by looking for the hammer icon:
Claude Visual Tools
After clicking on the hammer icon, you should see the tools that come with the Filesystem MCP Server:
Available Integration
If you see both of these this means that the integration is active. Congratulations! This means Claude can now ask Perplexity. You can then simply use it as you would use the Perplexity web app.

Step 6: Advanced parameters

Currently, the search parameters used are the default ones. You can modify any search parameter in the API call directly in the index.ts script. For this, please refer to the official API documentation.

Troubleshooting

The Claude documentation provides an excellent troubleshooting guide you can refer to. However, you can still reach out to us at api@perplexity.ai for any additional support or file a bug.

Cursor integration

You can also use our MCP with Cursor (or any other app that supports this). To use Sonar with Cursor, you can follow the following steps.

Step 1: Navigate to your Cursor settings:

Cursor Settings

Step 2: Navigate to the MCP directory

And click on Add new global MCP server
Add Server

Step 3: Insert the MCP Server Configuration from above

This is the same configuration you would use for any other application that supports MCP.
You should then see the application being part of your available tools like this:
Cursor MCP

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.