Advertise
MCP.so
Sign In

Perplexica MCP Server

@thetom42

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

thetom42

About Perplexica MCP Server

MCP server for Perplexica

#perplexica#mcp-server#ai-search

Perplexica MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "perplexica": {
      "command": "uvx",
      "args": [
        "perplexica-mcp",
        "stdio"
      ],
      "env": {
        "PERPLEXICA_BACKEND_URL": "http://localhost:3000/api/search"
      }
    }
  }
}

Perplexica MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Perplexica MCP Server?

Perplexica MCP Server is a Model Context Protocol (MCP) server that provides AI-powered web search functionality by connecting MCP clients to the Perplexica search API. It supports stdio, SSE, and Streamable HTTP transports and is built with the FastMCP framework.

How to use Perplexica MCP Server?

Clone the repository, install dependencies with uv sync, and set the PERPLEXICA_BACKEND_URL environment variable to your running Perplexica instance. Run the server using one of three transport modes: uv run src/perplexica_mcp.py stdio, sse, or http. Configuration examples for Claude Desktop, Cursor IDE, and generic MCP clients are provided. Docker deployment is also supported with compose files for HTTP and SSE transports.

Key features of Perplexica MCP Server

  • AI-powered web search with multiple focus modes
  • Supports stdio, SSE, and Streamable HTTP transports
  • Built with FastMCP for robust MCP protocol compliance
  • Single unified server implementation for all transports
  • Docker support with health checks and security best practices

Use cases of Perplexica MCP Server

  • Add AI search to MCP-compatible clients like Claude Desktop or Cursor
  • Provide real-time search results over Server-Sent Events (SSE)
  • Integrate with REST workflows using Streamable HTTP transport
  • Deploy containerized search capabilities alongside Perplexica in Docker networks

Frequently asked questions

1

What transports does Perplexica MCP Server support?

It supports stdio, SSE (Server-Sent Events), and Streamable HTTP transports. Stdio is recommended for most MCP clients; SSE and HTTP are available for web-based or real-time use cases.

2

How do I configure Perplexica MCP Server for my client?

Set the `PERPLEXICA_BACKEND_URL` environment variable to point to your Perplexica instance, then run the server with the appropriate transport command. For Claude Desktop or Cursor, use a stdio configuration with `uv run ... stdio`.

3

Does Perplexica MCP Server require a separate Perplexica instance?

Yes. The server connects to a running Perplexica instance via the `PERPLEXICA_BACKEND_URL`. You must ensure Perplexica is accessible at that URL.

4

How can I run Perplexica MCP Server in Docker?

Docker Compose files are provided for HTTP and SSE transports. Create an external Docker network named `backend`, set environment variables (e.g., `PERPLEXICA_BACKEND_URL`), then run `docker-compose up -d`. Both containers include health checks.

5

How do I test the server?

Run `uv run src/test_transports.py` to verify stdio, SSE, and HTTP transports, including MCP protocol handshake and endpoint accessibility.

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K
Advertise