Skip to main content

Perplexity Web Search MCP Server

A simple MCP (Model Context Protocol) server that provides web search functionality using the Perplexity API. This server allows Claude or other MCP-compatible AI assistants to search the web and get up-to-date information.

Features

  • Search the web with Perplexity's powerful search capabilities
  • Get comprehensive search results with sources and citations
  • Filter results by time period (day, week, month, year)
  • Includes a ready-to-use prompt template for web searches
  • Supports loading API key from environment variables or .env file

Installation

  1. Clone this repository
  2. Install dependencies:
    pip install -e .
    
    or
    uv pip install -e .
    

Configuration

You can set the PERPLEXITY_API_KEY environment variable with your Perplexity API key:

export PERPLEXITY_API_KEY="your-api-key-here"

Alternatively, you can create a .env file in the project root with the following content:

PERPLEXITY_API_KEY=your-api-key-here

A sample .env.example file is provided for reference.

To get a Perplexity API key:

  1. Visit Perplexity API Settings
  2. Create an account if you don't have one
  3. Generate an API key

Usage

Running the server

python server.py

Testing the server

You can test the server functionality without running the full MCP server using the included test script:

python test_server.py "your search query here" --recency month

Options for --recency are: day, week, month (default), year

Using with Claude Desktop

  1. Edit your Claude Desktop configuration file:

    • On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • On Windows: %APPDATA%/Claude/claude_desktop_config.json
  2. Add the following configuration:

    {
      "perplexity-mcp": {
        "env": {
          "PERPLEXITY_API_KEY": "your-api-key-here"
        },
        "command": "python",
        "args": [
          "/path/to/server.py"
        ]
      }
    }
    
  3. Restart Claude Desktop

Example Prompts for Claude

  • "Search the web for the latest news about artificial intelligence"
  • "Use Perplexity to find information about climate change published in the past week"
  • "Search for recent research papers on quantum computing from the past month"

API Reference

Tool: search_web(query: str, recency: str = "month") -> str

Search the web using Perplexity API and return results.

Parameters:

  • query: The search query string
  • recency: Filter results by time period - 'day', 'week', 'month' (default), or 'year'

Returns: A comprehensive text response containing:

  1. A detailed summary of the search results
  2. Key facts and information found
  3. Sources with URLs for verification
  4. Any conflicting information if present

Prompt: web_search_prompt(query: str, recency: str = "month") -> str

Creates a prompt template for searching the web with Perplexity.

Parameters:

  • query: The search query
  • recency: Time period filter - 'day', 'week', 'month' (default), or 'year'

Returns: A formatted prompt string that instructs the AI to:

  1. Search for the specified query
  2. Focus on results from the specified time period
  3. Summarize key findings
  4. Highlight important facts
  5. Mention conflicting information
  6. Cite sources with links

License

MIT

Metadata

Release files for iflow-mcp_perplexity-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_perplexity-mcp 0.1.0
File Size Uploaded Provenance Actions
iflow_mcp_perplexity_mcp-0.1.0.tar.gz 3.8 kB Without provenance Details for iflow_mcp_perplexity_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_perplexity-mcp 0.1.0
File Interpreter ABI Platform Actions
iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl

Total release size: 8.3 kB

Release files / iflow_mcp_perplexity_mcp-0.1.0.tar.gz

Download URL iflow_mcp_perplexity_mcp-0.1.0.tar.gz
Size 3.8 kB
Tags Source
SHA-256 checksum
How to use checksums
4b441b96f786eae9265facfac7cc38532affe23aaf4e5b25c29f4e73315b512e
BLAKE2b-256 checksum
How to use checksums
2577f45a210eddcd5018731e2bacd602988335006356efbf4429c12185c976d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release files / iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl

Download URL iflow_mcp_perplexity_mcp-0.1.0-py3-none-any.whl
Size 4.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
65530121051fb37e93fca2b96d6e2d2d03bd27dd971bdfa36c7beae3407cf310
BLAKE2b-256 checksum
How to use checksums
93ceed359023ac86f99cf5e3e8a014b6e9469eaad6b29ff110208db60edc0d2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Security for iflow-mcp_perplexity-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page