Which integrations are available for this server?

Enables web searches with Reddit-focused results through Perplexica's search API, allowing queries to be specifically targeted at Reddit content. Provides access to Wolfram Alpha computational knowledge through Perplexica's search API, enabling computational and factual queries. Enables YouTube-focused searches through Perplexica's search API, allowing queries to find and surface video content from YouTube.

How do I use MCP Perplexica?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Perplexica search for recent advancements in quantum computing with academic focus" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Perplexica

by Kaiohz

Overview Schema Related Servers Score Discussions

Python

Hybrid

MCP Perplexica

MCP server proxy for Perplexica search API.

This server allows LLMs to perform web searches through Perplexica using the Model Context Protocol (MCP).

Features

🔍 Web search through Perplexica
📚 Multiple focus modes (web, academic, YouTube, Reddit, etc.)
⚡ Configurable optimization modes (speed, balanced, quality)
🔧 Customizable model configuration
📖 Source citations in responses
🚀 Multiple transport modes (stdio, SSE, Streamable HTTP)

Related MCP server: Perplexica MCP Server

Prerequisites

Python 3.11+
UV package manager
Running Perplexica instance

Installation

Clone the repository:

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

Install dependencies with UV:

uv sync

Create your environment file:

cp .env.example .env

Edit .env with your configuration:

# Perplexica API
PERPLEXICA_URL=http://localhost:3000

# Transport: stdio (default), sse, or streamable-http
TRANSPORT=stdio
HOST=127.0.0.1
PORT=8000

# Model configuration
DEFAULT_CHAT_MODEL_PROVIDER_ID=your-provider-id
DEFAULT_CHAT_MODEL_KEY=anthropic/claude-sonnet-4.5
DEFAULT_EMBEDDING_MODEL_PROVIDER_ID=your-provider-id
DEFAULT_EMBEDDING_MODEL_KEY=openai/text-embedding-3-small

Usage

Transport Modes

The server supports three transport modes:

Transport	Description	Use Case
`stdio`	Standard input/output	CLI tools, Claude Desktop
`sse`	Server-Sent Events over HTTP	Web clients
`streamable-http`	Streamable HTTP (recommended for production)	Production deployments

Running with Docker Compose

The easiest way to run both Perplexica and MCP Perplexica together:

# Copy and configure environment files
cp .env.example .env
cp .env.perplexica.example .env.perplexica

# Edit .env with your MCP Perplexica settings
# Edit .env.perplexica with your Perplexica settings

# Start services
docker compose up -d

This starts:

Perplexica on http://localhost:3000
MCP Perplexica connected to Perplexica

Running the MCP Server (without Docker)

Stdio mode (default)

uv run python src/main.py

SSE mode

TRANSPORT=sse PORT=8000 uv run python src/main.py

Streamable HTTP mode

TRANSPORT=streamable-http PORT=8000 uv run python src/main.py

Claude Desktop Configuration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "perplexica": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-perplexica", "python", "-m", "main"],
      "env": {
        "PERPLEXICA_URL": "http://localhost:3000",
        "TRANSPORT": "stdio",
        "DEFAULT_CHAT_MODEL_PROVIDER_ID": "your-provider-id",
        "DEFAULT_CHAT_MODEL_KEY": "anthropic/claude-sonnet-4.5",
        "DEFAULT_EMBEDDING_MODEL_PROVIDER_ID": "your-provider-id",
        "DEFAULT_EMBEDDING_MODEL_KEY": "openai/text-embedding-3-small"
      }
    }
  }
}

Claude Code Configuration

For HTTP-based transports, you can add the server to Claude Code:

# Start the server with streamable-http transport
TRANSPORT=streamable-http PORT=8000 uv run python -m main

# Add to Claude Code
claude mcp add --transport http perplexica http://localhost:8000/mcp

Available Tools

`search`

Perform a web search using Perplexica.

Parameters:

Parameter	Type	Required	Description
`query`	string	Yes	The search query
`focus_mode`	string	No	Search focus: `webSearch`, `academicSearch`, `writingAssistant`, `wolframAlphaSearch`, `youtubeSearch`, `redditSearch`
`optimization_mode`	string	No	Optimization: `speed`, `balanced`, `quality`
`system_instructions`	string	No	Custom instructions for AI response
`chat_model_provider_id`	string	No	Override default chat model provider
`chat_model_key`	string	No	Override default chat model
`embedding_model_provider_id`	string	No	Override default embedding provider
`embedding_model_key`	string	No	Override default embedding model

Example:

Search for "latest developments in AI" using academic focus

Development

Install dev dependencies

uv sync --dev

Run tests

uv run pytest

Run linter

uv run ruff check .
uv run ruff format .
uv run black src/

Architecture

This project follows hexagonal architecture:

src/
├── main.py              # MCP server entry point
├── config.py            # Pydantic Settings
├── dependencies.py      # Dependency injection
├── domain/              # Business core (pure Python)
│   ├── entities.py      # Dataclasses
│   └── ports.py         # ABC interfaces
├── application/         # Use cases
│   ├── requests.py      # Pydantic DTOs
│   └── use_cases.py     # Business logic
└── infrastructure/      # External adapters
    └── perplexica/
        └── adapter.py   # HTTP client

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

searchC

Related MCP Servers

Perplexica MCP Server
Search RAG Systems Autonomous Agents
thetom42
A
license
A
quality
C
maintenance
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.
Last updated 2026-01-20
1
71
MIT
Perplexica MCP Server
Search RAG Systems Web Scraping
armand0e
A
license
-
quality
D
maintenance
Enables AI-powered searches through a local Perplexica instance with multiple focus modes including web search, academic search, YouTube, Reddit, and more, with streaming support and conversation history.
Last updated 2025-08-21
6
MIT
Perplexity MCP Server
Search RAG Systems Research & Data
Pantainos-Toolkit
F
license
-
quality
D
maintenance
Integrates with Perplexity's API to provide web search and AI-powered answers with citations. Offers a three-tier research workflow: search for sources, ask for grounded AI answers, and ask_more for deeper analysis using advanced models.
Last updated 2026-02-09
Perplexity Web-Search MCP
Search Research & Data
lv042
F
license
B
quality
D
maintenance
Enables AI assistants to perform real-time web and academic searches using Perplexity's Sonar API.
Last updated 2025-09-17
2

View all related MCP servers

Related MCP Connectors

agentsearch-mcp
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Parallel Search MCP
The best web search for your AI Agent
web-search
Web search for AI agents — one tool across 6 engines, routed to the cheapest + cached.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kaiohz/mcp-perplexica'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

MCP Perplexica

Features

Prerequisites

Installation

Usage

Transport Modes

Running with Docker Compose

Running the MCP Server (without Docker)

Stdio mode (default)

SSE mode

Streamable HTTP mode

Claude Desktop Configuration

Claude Code Configuration

Available Tools

search

Development

Install dev dependencies

Run tests

Run linter

Architecture

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Perplexica MCP Server

Perplexica MCP Server

Perplexity MCP Server

Perplexity Web-Search MCP

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

`search`