Perplexica MCP Server

A Model Context Protocol (MCP) server that provides search functionality using Perplexica's AI-powered search engine.

Local serverstdio

What is the Perplexica MCP Server?

Perplexica MCP Server is an MCP project maintained in the thetom42/perplexica-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that provides search functionality using Perplexica's AI-powered search engine”. Read the project documentation for the complete scope.

Installation

The documented pypi package is perplexica-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares PERPLEXICA_BACKEND_URL, PERPLEXICA_CHAT_MODEL_PROVIDER, PERPLEXICA_CHAT_MODEL_NAME, PERPLEXICA_EMBEDDING_MODEL_PROVIDER, PERPLEXICA_EMBEDDING_MODEL_NAME. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
querystring, required): Search query
sourcesarray, required): Search sources to use. Valid values: "web", "academic", "discussions". Can combine multiple sources.
chat_modelobject, optional): Chat model configuration
embedding_modelobject, optional): Embedding model configuration
optimization_modestring, optional): "speed", "balanced", or "quality"
historyarray, optional): Conversation history as [["human", "text"], ["assistant", "text"]] pairs
system_instructionsstring, optional): Custom instructions
streamboolean, optional): Whether to stream responses

How to install the Perplexica MCP Server

{
  "mcpServers": {
    "perplexica": {
      "command": "uvx",
      "args": [
        "perplexica-mcp",
        "stdio"
      ],
      "env": {
        "PERPLEXICA_BACKEND_URL": "http://localhost:3000/api/search",
        "PERPLEXICA_CHAT_MODEL_PROVIDER": "openai",
        "PERPLEXICA_CHAT_MODEL_NAME": "gpt-4o-mini",
        "PERPLEXICA_EMBEDDING_MODEL_PROVIDER": "openai",
        "PERPLEXICA_EMBEDDING_MODEL_NAME": "text-embedding-3-small"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PERPLEXICA_BACKEND_URLDeclared in the maintainer’s client configuration.Check documentation
PERPLEXICA_CHAT_MODEL_PROVIDERDeclared in the maintainer’s client configuration.Check documentation
PERPLEXICA_CHAT_MODEL_NAMEDeclared in the maintainer’s client configuration.Check documentation
PERPLEXICA_EMBEDDING_MODEL_PROVIDERDeclared in the maintainer’s client configuration.Check documentation
PERPLEXICA_EMBEDDING_MODEL_NAMEDeclared in the maintainer’s client configuration.Check documentation