Perplexica MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Perplexica MCP Server search the web for AI breakthroughs in 2025"
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.
Perplexica MCP Server
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
Clone this repository
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 configurationStarting the Server
Run the MCP server with stdio transport:
python -m perplexica_mcp_server.serverTesting
Test the server functionality:
python test/test_client.pyRun test for you perplexica:
python test/test_official_api.pyOutput Formats
Supports two output formats:
json: Raw JSON data (default)formatted: Human-readable formatted text
License
MIT License
Available Tools
7 toolsget_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Web search API and MCP server for developers building AI agents.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server integrating Perplexity AI's API to offer advanced search capabilities with support for multiple models and result configuration.11MIT
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables AI models to search the web using OpenAI's 4o-mini Search model, allowing access to up-to-date information for just a few cents per search.3 npm2-
- AlicenseNot gradedqualityFmaintenanceAn MCP server that integrates with Poe's API to provide AI-powered search and research tools from Perplexity, Reka, Exa, and Linkup.28 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to perform search-augmented queries and deep multi-source research using the Perplexity API.26Apache 2.0