Perplexica MCP Server

Perplexica MCP Server is a Model Context Protocol (MCP) server that acts as a proxy to provide LLM access to Perplexica's AI-powered search engine. This server enables AI assistants and other MCP clients to perform searches through the Perplexica API.

What This MCP Server Provides

Single Search Tool: Exposes Perplexica's search functionality as an MCP tool
API Proxy: Acts as a bridge between MCP clients and the Perplexica search endpoint
Parameter Passthrough: Forwards all search parameters (focus modes, models, etc.) to the Perplexica API
MCP Protocol Compliance: Implements the Model Context Protocol for seamless integration with AI assistants

Installation

To use the Perplexica MCP Server, you'll need to have Python 3.12 or later installed on your system.

Clone this repository:

git clone https://github.com/yourusername/perplexica-mcp.git
cd perplexica-mcp

Install the required dependencies:

pip install -e .

MCP Server Configuration

This server is designed to be used with MCP-compatible clients. Add the following configuration to your MCP client:

{
  "mcpServers": {
    "perplexica": {
      "command": "uv",
      "args": ["run", "/path/to/perplexica-mcp/perplexica_mcp_tool.py"],
      "env": {
        "PERPLEXICA_BACKEND_URL": "http://localhost:3000/api/search"
      }
    }
  }
}

Backend URL Configuration

The Perplexica MCP Server uses an environment variable to configure the backend URL. To set this up:

Create a .env file in the root of the project (if it doesn't already exist)
Add the PERPLEXICA_BACKEND_URL variable with your desired backend URL:

PERPLEXICA_BACKEND_URL=http://localhost:3000/api/search

The server will use this URL to communicate with the Perplexica backend. If the environment variable is not set, it will default to http://localhost:3000/api/search.

Usage

This MCP server provides a search tool that can be used by MCP clients to perform searches through Perplexica. The tool accepts the following parameters:

Search Tool Parameters

query (required): The search query string
focus_mode (required): The search focus mode
chat_model (optional): Chat model configuration
embedding_model (optional): Embedding model configuration
optimization_mode (optional): Performance optimization setting
history (optional): Conversation history
system_instructions (optional): Custom AI guidance
stream (optional): Whether to stream responses

Example Usage via MCP Client

When connected to an MCP client, you can use the search tool like this:

Search for "Python programming best practices" using webSearch focus mode

The MCP client will automatically invoke the search tool with the appropriate parameters.

Perplexica Integration

This MCP server acts as a proxy to the Perplexica search API. All search parameters and configurations are passed through to the underlying Perplexica service:

Focus Modes: Supports all Perplexica focus modes (webSearch, academicSearch, writingAssistant, wolframAlphaSearch, youtubeSearch, redditSearch)
Model Configuration: Passes through chat model and embedding model settings to Perplexica
Search Options: Forwards optimization modes, conversation history, and system instructions

For detailed information about Perplexica's capabilities and features, please refer to the Perplexica documentation.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that acts as a proxy to provide LLM access to Perplexica's AI-powered search engine, enabling AI assistants to perform searches with various focus modes.

Related MCP Servers

MCP Reddit Server
wllcnm
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to browse and analyze Reddit content, including searching subreddits, retrieving post details with comments, and viewing trending posts.
Last updated -
1
Python
MIT License
MCP Web Search Tool
gabrimatic
-
security
A
license
-
quality
A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
Last updated -
3
TypeScript
MIT License
Scrapeless MCP Server
scrapeless-ai
A
security
A
license
A
quality
A Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.
Last updated -
1
75
3
TypeScript
MIT License
Google Search MCP Server
hunter-arton
A
security
F
license
A
quality
A Model Context Protocol server that provides web and image search capabilities through Google's Custom Search API, allowing AI assistants like Claude to access current information from the internet.
Last updated -
2
1
TypeScript

View all related MCP servers

Perplexica MCP Server