perplexity-polza-mcp-server
Allows interaction with Perplexity AI models (Sonar, Sonar Pro, Sonar Reasoning, Sonar Deep Research) via Polza.ai, enabling question answering, deep research, and model listing.
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., "@perplexity-polza-mcp-server research the latest trends in quantum computing"
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.
Perplexity MCP Server via Polza.ai
mcp-name: io.github.ivanantigravity-lgtm/perplexity-polza-mcp-server
MCP сервер для Claude Desktop и Claude Code, который ходит в модели Perplexity (Sonar, Sonar Pro, Sonar Reasoning, Sonar Deep Research) через агрегатор Polza.ai.
Что умеет
perplexity_model_guide— шпаргалка по выбору модели под задачуperplexity_ask— обычный вопрос в Perplexityperplexity_research— более глубокий ресёрч с веб-поискомlist_perplexity_models— список доступныхperplexity/*моделей из каталога Polza
Related MCP server: Perplexity Agent MCP
Что нужно для установки
Claude DesktopилиClaude Code(или любой другой MCP-клиент)uv(ставится одной командой, см. ниже)Python 3.11+
POLZA_AI_API_KEY— ключ берётся на polza.ai/dashboard/api-keys
Поставить uv:
curl -LsSf https://astral.sh/uv/install.sh | shУстановка за 2 минуты (через PyPI + uvx)
Это самый простой путь: ничего клонировать не надо, uvx сам скачает пакет из PyPI.
Claude Code / VS Code
Создай файл .mcp.json в корне своего проекта:
{
"mcpServers": {
"perplexity-polza": {
"command": "uvx",
"args": ["perplexity-polza-mcp-server@latest"],
"env": {
"POLZA_AI_API_KEY": "your-polza-api-key-here"
}
}
}
}Перезапусти Claude Code — готово.
Claude Desktop (macOS)
Открой файл ~/Library/Application Support/Claude/claude_desktop_config.json и добавь:
{
"mcpServers": {
"perplexity-polza": {
"command": "uvx",
"args": ["perplexity-polza-mcp-server@latest"],
"env": {
"POLZA_AI_API_KEY": "your-polza-api-key-here"
}
}
}
}Перезапусти Claude Desktop.
Claude Desktop (Windows)
Файл: %APPDATA%\Claude\claude_desktop_config.json. Содержимое такое же, как на macOS.
Как проверить, что работает
После перезапуска Claude попроси:
Покажи доступные модели Perplexity через polza
Claude должен вызвать tool list_perplexity_models и вернуть список.
Когда какую модель брать
Sonar— быстрый поиск + ответ. Новости, факты, Q&A, короткие суммаризации.Sonar Pro— плотнее структура, сравнения, follow-up вопросы.Sonar Pro Search— глубже поиск, больше поисковых шагов.Sonar Reasoning Pro— не просто найти, а разобрать и сделать вывод.Sonar Deep Research— полноценный ресёрч, market scan, длинный отчёт.
Переключить дефолтную модель можно через переменные окружения PERPLEXITY_MODEL и PERPLEXITY_RESEARCH_MODEL — полный список ниже.
Переменные окружения
Переменная | Обязательная | По умолчанию | Описание |
| да | — | Ключ с polza.ai |
| нет |
| Base URL для chat completions (с |
| нет |
| Модель для |
| нет |
| Модель для |
| нет |
| — |
Локальная разработка
git clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.git
cd perplexity-polza-mcp-server
uv sync
POLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.serverДля локального подключения из source в Claude:
{
"mcpServers": {
"perplexity-polza-local": {
"command": "uv",
"args": ["run", "python", "-m", "perplexity_polza_mcp_server.server"],
"cwd": "/absolute/path/to/perplexity-polza-mcp-server",
"env": {
"POLZA_AI_API_KEY": "your-polza-api-key-here"
}
}
}
}Под капотом
Chat completions:
POST https://polza.ai/api/v1/chat/completions(OpenAI-совместимый формат)Model catalog:
GET https://polza.ai/api/v1/models/catalog
Важные файлы в репозитории
pyproject.toml— метаданные пакета и entry pointsserver.json— описание для MCP Registryfastmcp.json— локальная конфигурация FastMCP.github/workflows/publish-pypi.yml— публикация в PyPI через GitHub Actions
Лицензия
MIT.
Available Tools
3 toolslist_perplexity_modelsD
Inputs: include_providers.
perplexity_askD
Inputs: prompt (required), model, system, temperature, +4 more.
perplexity_researchD
Inputs: topic (required), model, system, max_tokens, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Tool names suggest distinct purposes: listing models, asking a question, and doing research. However, the lack of descriptions creates some ambiguity about each tool's exact scope.
Naming is inconsistent: one tool uses a verb_noun pattern (list_perplexity_models), while the other two use a brand prefix followed by a verb (perplexity_ask, perplexity_research). The convention is not uniform.
Three tools is on the lower side but could be sufficient for a focused server (e.g., listing models, asking questions, researching). However, the lack of descriptions makes the scope feel underdeveloped.
The tool set covers basic interactions with Perplexity (list models, ask, research), but without descriptions it's unclear if common operations like context management or follow-up questions are supported. The surface appears minimal but possibly complete for simple use cases.
Maintenance
Related MCP Connectors
Real-time web search, reasoning, and research through Perplexity's API
Enable AI assistants to perform web searches using Perplexity's Sonar Pro.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Web search, scraping, Google Trends and data lookups. Paid per call in USDC on Base via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI-powered search, research, and reasoning capabilities through integration with Perplexity.ai, offering three specialized tools: general conversational AI, deep research with citations, and advanced reasoning.2MIT
- AlicenseAqualityBmaintenanceEnables coding assistants to access Perplexity AI for quick fact-checking and in-depth research. Provides two tools: lookup for fast documentation queries and answer for comprehensive research with recommendations.21MIT
- AlicenseAqualityDmaintenanceEnables AI-powered web research using your existing Perplexity Pro subscription, providing tools for search, follow-up conversations, and thread management through the Model Context Protocol.41,201 PyPI24MIT
- AlicenseCqualityAmaintenanceEnables AI agents and users to query Perplexity AI's premium models (GPT-5.4, Claude 4.6 Opus, Gemini 3.1 Pro, etc.) via MCP tools, CLI, or API, with support for deep research, model council, and multi-turn conversations.34406 PyPI211MIT