Skip to main content
Glama
Perplexica MCP Server

Perplexica MCP Server

by tianmu

Perplexica MCP Server

Language: English | 中文

A Model Context Protocol (MCP) server that provides access to Perplexica's AI-powered search engine capabilities.

Features

  • Web Search: General web search using AI

  • Academic Search: Search academic sources and papers

  • YouTube Search: Find and summarize YouTube videos

  • Reddit Search: Search Reddit discussions

  • Writing Assistant: Get help with writing and research

  • Multi-model Support: Use different chat and embedding models

  • Health Monitoring: Check service status and availability

Related MCP server: 4o-mini-search-mcp

Prerequisites

  • Python 3.10+

  • A running Perplexica instance (default: http://localhost:3000)

  • Optional: OpenAI API key for enhanced search capabilities

Installation

  1. Clone this repository

  2. Install dependencies:

    pip install -r requirements.txt
    pip install .

    or

    uv tool install .

Configuration

cline

Configure the server to cline:

{
  "mcpServers": {
    "perplexica": {
      "command": "python",
      "args": [
        "-m", "perplexica_mcp_server.server"
      ],
      "env": {
        "PERPLEXICA_DEFAULT_CHAT_PROVIDER":"custom_openai",
        "PERPLEXICA_DEFAULT_CHAT_MODEL":"gpt-4.1",
        "PERPLEXICA_CUSTOM_OPENAI_BASE_URL":"https://api.poe.com/v1",
        "PERPLEXICA_CUSTOM_OPENAI_KEY":"your_api_key",
        "PERPLEXICA_DEFAULT_EMBEDDING_PROVIDER":"transformers",
        "PERPLEXICA_DEFAULT_EMBEDDING_MODEL":"xenova-bge-small-en-v1.5",
        "PERPLEXICA_OPTIMIZATION_MODE":"balanced",
        "PERPLEXICA_BASE_URL":"http://localhost:3000"
      },
      "timeout": 60,
      "transport": "stdio"
    }
  }
}

or

{
  "mcpServers": {
    "perplexica": {
      "command": "uvx",
      "args": [
        "perplexica-mcp-server"
      ],
      "env": {
        "PERPLEXICA_DEFAULT_CHAT_PROVIDER":"custom_openai",
        "PERPLEXICA_DEFAULT_CHAT_MODEL":"gpt-4.1",
        "PERPLEXICA_CUSTOM_OPENAI_BASE_URL":"https://api.poe.com/v1",
        "PERPLEXICA_CUSTOM_OPENAI_KEY":"your_api_key",
        "PERPLEXICA_DEFAULT_EMBEDDING_PROVIDER":"transformers",
        "PERPLEXICA_DEFAULT_EMBEDDING_MODEL":"xenova-bge-small-en-v1.5",
        "PERPLEXICA_OPTIMIZATION_MODE":"balanced",
        "PERPLEXICA_BASE_URL":"http://localhost:3000"
      },
      "timeout": 60,
      "transport": "stdio"
    }
  }
}

Development

Copy env.example to .env and modify as needed:

cp env.example .env
# Edit .env file to set your configuration

Starting the Server

Run the MCP server with stdio transport:

python -m perplexica_mcp_server.server

Testing

Test the server functionality:

python test/test_client.py

Run test for you perplexica:

python test/test_official_api.py

Output Formats

Supports two output formats:

  • json: Raw JSON data (default)

  • formatted: Human-readable formatted text

License

MIT License

Available Tools

7 tools
get_available_modelsA

Get available chat and embedding models from Perplexica.

Returns: JSON string containing available models

Inputs: no named parameters. Returns: result

health_checkA

Check if Perplexica API is healthy and accessible.

Returns: JSON string with health status

Inputs: no named parameters. Returns: result

search_academicC

Search academic sources using Perplexica's academic search mode.

Args: query: The academic search query chat_provider: Chat model provider (optional, uses env config if not provided) chat_model: Specific chat model to use (optional, uses env config if not provided) embedding_provider: Embedding model provider (optional, uses env config if not provided) embedding_model: Specific embedding model to use (optional, uses env config if not provided) optimization_mode: Speed vs quality tradeoff (optional, uses env config if not provided) output_format: Output format - "formatted" for human-readable text or "json" for raw JSON

Returns: Formatted text with AI response and sources, or JSON if output_format="json"

Inputs: query (required), chat_provider, chat_model, embedding_provider, +3 more. Returns: result

search_redditB

Search Reddit discussions using Perplexica.

Args: query: The Reddit search query chat_provider: Chat model provider (optional, uses env config if not provided) chat_model: Specific chat model to use (optional, uses env config if not provided) optimization_mode: Speed vs quality tradeoff (optional, uses env config if not provided) output_format: Output format - "formatted" for human-readable text or "json" for raw JSON

Returns: Formatted text with AI response and sources, or JSON if output_format="json"

Inputs: query (required), chat_provider, chat_model, optimization_mode, +1 more. Returns: result

search_webB

Search the web using Perplexica's AI-powered search engine.

Args: query: The search query or question chat_provider: Chat model provider (optional, uses env config if not provided) chat_model: Specific chat model to use (optional, uses env config if not provided) embedding_provider: Embedding model provider (optional, uses env config if not provided) embedding_model: Specific embedding model to use (optional, uses env config if not provided) optimization_mode: Speed vs quality tradeoff (optional, uses env config if not provided) output_format: Output format - "formatted" for human-readable text or "json" for raw JSON

Returns: Formatted text with AI response and sources, or JSON if output_format="json"

Inputs: query (required), chat_provider, chat_model, embedding_provider, +3 more. Returns: result

search_youtubeB

Search YouTube videos using Perplexica.

Args: query: The YouTube search query chat_provider: Chat model provider (optional, uses env config if not provided) chat_model: Specific chat model to use (optional, uses env config if not provided) optimization_mode: Speed vs quality tradeoff (optional, uses env config if not provided) output_format: Output format - "formatted" for human-readable text or "json" for raw JSON

Returns: Formatted text with AI response and sources, or JSON if output_format="json"

Inputs: query (required), chat_provider, chat_model, optimization_mode, +1 more. Returns: result

writing_assistantC

Use Perplexica's writing assistant mode for writing help and research.

Args: query: The writing-related query or request chat_provider: Chat model provider (optional, uses env config if not provided) chat_model: Specific chat model to use (optional, uses env config if not provided) optimization_mode: Speed vs quality tradeoff (optional, uses env config if not provided) output_format: Output format - "formatted" for human-readable text or "json" for raw JSON

Returns: Formatted text with AI response and sources, or JSON if output_format="json"

Inputs: query (required), chat_provider, chat_model, optimization_mode, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a clearly distinct functionality: health check, available models, and four different search sources (web, academic, Reddit, YouTube) plus a writing assistant. An agent can easily differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with verb-noun structure (e.g., get_available_models, search_web) or clear noun phrases (e.g., health_check, writing_assistant). No mixing of conventions.

    Tool Count5/5

    With 7 tools, the set is well-scoped for a search and writing assistant server. It covers essential operations without being overwhelming or too sparse.

    Completeness4/5

    The tool surface covers the main search modes (web, academic, Reddit, YouTube), utility functions, and writing assistance. A minor gap is the lack of specific modes like image or news search, but the core workflow is well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers