Perplexity

by letsbuildagent

2 stars

Not rated

GitHub

About

Integrates Perplexity AI's API, enabling web-based research and cited answers through real-time search capabilities.

Details

Author: letsbuildagent
Repository: letsbuildagent/perplexity-tool
GitHub stars: 2
License: MIT License
Categories: AI, Design, Developer Tools, Search, API, Knowledge Base, Frontend
Tags: #web

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Perplexity

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /full/path/to/perplexity-tool/server.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

From the repository

Once installed, you can use the tool through Claude with commands like:

- "Ask Perplexity about recent developments in AI"
- "Use Perplexity to research the history of quantum computing"
- "Search Perplexity for information about climate change, focusing on the last month"

1. Install Git:
- For Mac:
- Install Homebrew first by pasting this in Terminal:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

- Then install Git:

     brew install git

- For Windows:
- Download Git from git-scm.com
- Run the installer

2. Install Node.js:
- For Mac:

     brew install node

- For Windows:
- Download from nodejs.org
- Run the installer

3. Verify installations by running:

git --version

node --version

1. Clone the repository

git clone https://github.com/letsbuildagent/perplexity-tool

cd perplexity-tool

2. Install dependencies

npm install

3. Set up your API Key

You have two options:

Option 1 (Quick setup):
- Open server.js
- Find this line:

const PERPLEXITY_API_KEY = "YOUR-API-KEY-HERE";

- Replace with your Perplexity API key

Option 2 (Best practice):
- Create a .env file:
```bash

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "perplexity": {
            "cwd": "optional",
            "env": {},
            "args": [
                "/full/path/to/perplexity-tool/server.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "optional",
    "env": [],
    "args": [
        "/full/path/to/perplexity-tool/server.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "optional",
    "env": [],
    "args": [
        "/full/path/to/perplexity-tool/server.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "optional",
    "env": [],
    "args": [
        "/full/path/to/perplexity-tool/server.js"
    ],
    "shell": false,
    "command": "node"
}

Perplexity Tool for Claude Desktop

A custom MCP tool that integrates Perplexity AI's API with Claude Desktop, allowing Claude to perform web-based research and provide answers with citations.

Prerequisites Installation

1. Install Git:
- For Mac:
- Install Homebrew first by pasting this in Terminal:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

- Then install Git:

     brew install git

- For Windows:
- Download Git from git-scm.com
- Run the installer

2. Install Node.js:
- For Mac:

     brew install node

- For Windows:
- Download from nodejs.org
- Run the installer

3. Verify installations by running:

git --version

node --version

Tool Installation

1. Clone the repository

git clone https://github.com/letsbuildagent/perplexity-tool

cd perplexity-tool

2. Install dependencies

npm install

3. Set up your API Key

You have two options:

Option 1 (Quick setup):
- Open server.js
- Find this line:

const PERPLEXITY_API_KEY = "YOUR-API-KEY-HERE";

- Replace with your Perplexity API key

Option 2 (Best practice):
- Create a .env file:

  # On Mac/Linux:

  touch .env

  open .env

  

  # On Windows:

  notepad .env

Or simply create a new file named .env in your text editor
- Add your API key to the .env file:

  PERPLEXITY_API_KEY=your-api-key-here

- Install dotenv:

  npm install dotenv

- Update server.js:

  import 'dotenv/config'

  const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;

4. Configure Claude Desktop
- Open ~/Library/Application Support/Claude/claude_desktop_config.json
- Add this configuration:

{

  "mcpServers": {

    "perplexity-tool": {

      "command": "node",

      "args": [

        "/full/path/to/perplexity-tool/server.js"

      ]

    }

  }

}

Replace /full/path/to with the actual path where you cloned the repository.

5. Restart Claude Desktop

Usage

Once installed, you can use the tool through Claude with commands like:

Advanced Options

You can specify additional parameters:
- temperature: Controls response randomness (0-2)
- max_tokens: Limits response length
- search_domain_filter: Restricts search to specific domains
- search_recency_filter: Filters by time period (day/week/month/year)

Troubleshooting

1. Git not found:
- Make sure you've installed Git correctly
- Try restarting your terminal
- On Mac, make sure Homebrew is in your PATH

2. Node.js errors:
- Verify Node.js installation with node --version
- Try reinstalling Node.js

3. API Key issues:
- Make sure you've correctly copied your API key
- Check that there are no extra spaces in your .env file
- If using Option 2, verify dotenv is installed

4. Tool not appearing in Claude:
- Check the path in claude_desktop_config.json
- Make sure the path points to your server.js file
- Restart Claude Desktop
- Check the console for any error messages

License

MIT

Security Note

If you're planning to share your code or make it public:
- Don't commit your API key to Git
- Use the .env method (Option 2)
- Add .env to your .gitignore file

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

Perplexity Tool for Claude Desktop

Prerequisites Installation

Tool Installation

Usage

Advanced Options

Troubleshooting

License

Security Note

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel