Skip to main content
Glama
ivanantigravity-lgtm

perplexity-polza-mcp-server

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 — обычный вопрос в Perplexity

  • perplexity_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_API_KEY

да

Ключ с polza.ai

POLZA_BASE_URL

нет

https://polza.ai/api/v1

Base URL для chat completions (с /v1 — это ожидаемо, endpoint OpenAI-совместим)

PERPLEXITY_MODEL

нет

perplexity/sonar

Модель для perplexity_ask

PERPLEXITY_RESEARCH_MODEL

нет

perplexity/sonar-deep-research

Модель для perplexity_research

LOG_LEVEL

нет

INFO

Локальная разработка

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 points

  • server.json — описание для MCP Registry

  • fastmcp.json — локальная конфигурация FastMCP

  • .github/workflows/publish-pypi.yml — публикация в PyPI через GitHub Actions

Лицензия

MIT.

Available Tools

3 tools
list_perplexity_modelsD
ParametersJSON Schema
NameRequiredDescriptionDefault
include_providersNoInclude provider details from Polza catalog.

TDQS

D1/5.0
Behavior1/5

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.

Conciseness1/5

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.

Completeness1/5

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.

Parameters1/5

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.

Purpose1/5

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.

Usage Guidelines1/5

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
ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesUser question or task for Perplexity.
modelNoPolza model id. Default: perplexity/sonarperplexity/sonar
systemNoOptional system instruction.
temperatureNoSampling temperature.
max_tokensNoMaximum completion tokens.
search_context_sizeNoPerplexity web search depth.
reasoning_effortNoReasoning effort for models that support it.
include_reasoningNoAsk the provider to include reasoning in the response when supported.

TDQS

D1/5.0
Behavior1/5

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.

Conciseness1/5

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.

Completeness1/5

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.

Parameters1/5

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.

Purpose1/5

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.

Usage Guidelines1/5

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
ParametersJSON Schema
NameRequiredDescriptionDefault
topicYesResearch topic or question.
modelNoResearch-focused Perplexity model.perplexity/sonar-deep-research
systemNoOptional system instruction.
max_tokensNoMaximum completion tokens.
search_context_sizeNoSearch depth for research.high

TDQS

D1/5.0
Behavior1/5

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.

Conciseness1/5

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.

Completeness1/5

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.

Parameters1/5

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.

Purpose1/5

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.

Usage Guidelines1/5

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.

  1. 3 tool updatesv0.1.0
    • First observedlist_perplexity_models
    • First observedperplexity_ask
    • First observedperplexity_research

TDQS

D1.6/5.0
Disambiguation4/5

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 Consistency2/5

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.

Tool Count3/5

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.

Completeness3/5

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

ActivityInactive
ResponsivenessNo issues

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

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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.
    13
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables 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.
    2
    38
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables 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.
    4
    20
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Enables 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.
    30
    180
    MIT

Latest Blog Posts

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