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 "Install 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-serverresearch 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
| Name | Required | Description | Default |
|---|---|---|---|
| include_providers | No | Include provider details from Polza catalog. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Tool has no description.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Tool has no description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has no description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Tool has no description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Tool has no description.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Tool has no description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
perplexity_askD
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | User question or task for Perplexity. | |
| model | No | Polza model id. Default: perplexity/sonar | perplexity/sonar |
| system | No | Optional system instruction. | |
| temperature | No | Sampling temperature. | |
| max_tokens | No | Maximum completion tokens. | |
| search_context_size | No | Perplexity web search depth. | |
| reasoning_effort | No | Reasoning effort for models that support it. | |
| include_reasoning | No | Ask the provider to include reasoning in the response when supported. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Tool has no description.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Tool has no description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has no description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Tool has no description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Tool has no description.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Tool has no description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
perplexity_researchD
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | Research topic or question. | |
| model | No | Research-focused Perplexity model. | perplexity/sonar-deep-research |
| system | No | Optional system instruction. | |
| max_tokens | No | Maximum completion tokens. | |
| search_context_size | No | Search depth for research. | high |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Tool has no description.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Tool has no description.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has no description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Tool has no description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Tool has no description.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Tool has no description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
3 tool updates
v0.1.0- First observed
list_perplexity_models - First observed
perplexity_ask - First observed
perplexity_research
TDQS
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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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.
231
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.132MIT
- AlicenseAqualityAmaintenanceEnables 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.2381MIT
- 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.420MIT
- AlicenseBqualityAmaintenanceEnables 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.30180MIT
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 .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/ivanantigravity-lgtm/perplexity-polza-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server