Skip to content
Back to search

perplexity-mcp

A Model Context Protocol (MCP) server that provides web search functionality using Perplexity AI's API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jsonallen--perplexity-mcp/badge.svg)](/listings/jsonallen--perplexity-mcp)

HTML

<a href="/listings/jsonallen--perplexity-mcp"><img src="/api/listings/jsonallen--perplexity-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Installing via Smithery

To install Perplexity MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/perplexity-mcp):

npx -y @smithery/cli install perplexity-mcp --client claude

Requires [UV](https://github.com/astral-sh/uv) (Fast Python package and project manager)

If uv isn't installed.

# Using Homebrew on macOS
brew install uv

or

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Environment Variables

The following environment variable is required in your claude_desktop_config.json. You can obtain an API key from [Perplexity](https://perplexity.ai)

- `PERPLEXITY_API_KEY`: Your Perplexity AI API key

Optional environment variables:

- `PERPLEXITY_MODEL`: The Perplexity model to use (defaults to "sonar" if not specified)

Available models:

- `sonar-deep-research`: 128k context - Enhanced research capabilities - `sonar-reasoning-pro`: 128k context - Advanced reasoning with professional focus - `sonar-reasoning`: 128k context - Enhanced reasoning capabilities - `sonar-pro`: 200k context - Professional grade model - `sonar`: 128k context - Default model - `r1-1776`: 128k context - Alternative architecture

And updated list of models is avaiable (here)[https://docs.perplexity.ai/guides/model-cards]

Cursor & Claude Desktop Installation

Add this tool as a mcp server by editing the Cursor/Claude config file.

  "perplexity-mcp": {
    "env": {
      "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX",
      "PERPLEXITY_MODEL": "sonar"
    },
    "command": "uvx",
    "args": [
      "perplexity-mcp"
    ]
  }

Cursor

- On MacOS: `/Users/your-username/.cursor/mcp.json` - On Windows: `C:\Users\your-username\.cursor\mcp.json`

If everything is working correctly, you should now be able to call the tool from Cursor.

Claude Desktop

- On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json` - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

To verify the server is working. Open the Claude client and use a prompt like "search the web for news about openai in the past week". You should see an alert box open to confirm tool usage. Click "Allow for this chat".

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 119 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # perplexity-mcp MCP server
  2. [![smithery badge](https://smithery.ai/badge/perplexity-mcp)](https://smithery.ai/server/perplexity-mcp)
  3. A Model Context Protocol (MCP) server that provides web search functionality using [Perplexity AI's](https://www.perplexity.ai/) API. Works with the [Anthropic](https://www.anthropic.com/news/model-context-protocol) Claude desktop client.
  4. ## Example
  5. Let's you use prompts like, "Search the web to find out what's new at Anthropic in the past week."
  6. ## Glama Scores
  7. <a href="https://glama.ai/mcp/servers/ebg0za4hn9"><img width="380" height="200" src="https://glama.ai/mcp/servers/ebg0za4hn9/badge" alt="Perplexity Server MCP server" /></a>
  8. ## Components
  9. ### Prompts
  10. The server provides a single prompt:
  11. - perplexity_search_web: Search the web using Perplexity AI
  12. - Required "query" argument for the search query
  13. - Optional "recency" argument to filter results by time period:
  14. - 'day': last 24 hours
  15. - 'week': last 7 days
  16. - 'month': last 30 days (default)
  17. - 'year': last 365 days
  18. - Uses Perplexity's API to perform web searches
  19. ### Tools
  20. The server implements one tool:
  21. - perplexity_search_web: Search the web using Perplexity AI
  22. - Takes "query" as a required string argument
  23. - Optional "recency" parameter to filter results (day/week/month/year)
  24. - Returns search results from Perplexity's API
  25. ## Installation
  26. ### Installing via Smithery
  27. To install Perplexity MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/perplexity-mcp):
  28. ```bash
  29. npx -y @smithery/cli install perplexity-mcp --client claude
  30. ```
  31. ### Requires [UV](https://github.com/astral-sh/uv) (Fast Python package and project manager)
  32. If uv isn't installed.
  33. ```bash
  34. # Using Homebrew on macOS
  35. brew install uv
  36. ```
  37. or
  38. ```bash
  39. # On macOS and Linux.
  40. curl -LsSf https://astral.sh/uv/install.sh | sh
  41. # On Windows.
  42. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  43. ```
  44. ### Environment Variables
  45. The following environment variable is required in your claude_desktop_config.json. You can obtain an API key from [Perplexity](https://perplexity.ai)
  46. - `PERPLEXITY_API_KEY`: Your Perplexity AI API key
  47. Optional environment variables:
  48. - `PERPLEXITY_MODEL`: The Perplexity model to use (defaults to "sonar" if not specified)
  49. Available models:
  50. - `sonar-deep-research`: 128k context - Enhanced research capabilities
  51. - `sonar-reasoning-pro`: 128k context - Advanced reasoning with professional focus
  52. - `sonar-reasoning`: 128k context - Enhanced reasoning capabilities
  53. - `sonar-pro`: 200k context - Professional grade model
  54. - `sonar`: 128k context - Default model
  55. - `r1-1776`: 128k context - Alternative architecture
  56. And updated list of models is avaiable (here)[https://docs.perplexity.ai/guides/model-cards]
  57. ### Cursor & Claude Desktop Installation
  58. Add this tool as a mcp server by editing the Cursor/Claude config file.
  59. ```json
  60. "perplexity-mcp": {
  61. "env": {
  62. "PERPLEXITY_API_KEY": "XXXXXXXXXXXXXXXXXXXX",
  63. "PERPLEXITY_MODEL": "sonar"
  64. },
  65. "command": "uvx",
  66. "args": [
  67. "perplexity-mcp"
  68. ]
  69. }
  70. ```
  71. #### Cursor
  72. - On MacOS: `/Users/your-username/.cursor/mcp.json`
  73. - On Windows: `C:\Users\your-username\.cursor\mcp.json`
  74. If everything is working correctly, you should now be able to call the tool from Cursor.
  75. <img width="800" alt="mcp_screenshot" src="https://github.com/user-attachments/assets/4b59774f-646c-41b3-9886-5cfd4c4ca051" width=600>
  76. #### Claude Desktop
  77. - On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
  78. - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  79. To verify the server is working. Open the Claude client and use a prompt like "search the web for news about openai in the past week". You should see an alert box open to confirm tool usage. Click "Allow for this chat".
  80. <img width="600" alt="mcp_screenshot" src="https://github.com/user-attachments/assets/922d8f6a-8c9a-4978-8be6-788e70b4d049" />

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.