Perplexity Polza Mcp Server

io.github.ivanantigravity-lgtmPublished by GitHub account ivanantigravity-lgtmv0.1.1Updated Oct 24, 2026

Perplexity MCP server backed by the Polza.ai chat completions API.

VerifiedSTDIODesktop onlyWeb Search & ScrapingAI & ML

Overview

AI-generated overview

A local MCP server that lets an assistant query Perplexity Sonar models through the Polza.ai chat completions API for answers, research and model listings.

What you can do
Ask Perplexity a question and get a web-backed answer, with a deeper research mode for longer investigations and reports. List the available Perplexity models in the Polza catalog and get guidance on which model fits a task. Choose default models for asking and research through environment variables.
When to use it
Useful when you want Perplexity's web-search-backed answers and deep research available inside Claude Desktop, Claude Code or another MCP client, routed through the Polza.ai aggregator rather than Perplexity directly.
Requirements
Runs locally as a Python package via uvx or uv; needs Python 3.11+ and uv installed. Requires a Polza.ai API key in the POLZA_AI_API_KEY environment variable, and network access to the Polza.ai API. Optional variables set the base URL, default ask and research models, and log level.
Before you install
The Polza.ai API key is a secret placed in the client configuration file; keep it out of shared repositories. Queries and their content are sent to Polza.ai and onward to Perplexity models, which may incur usage costs on your Polza.ai account. The server only reads and asks; it does not modify local data.

Installation

In SourceWeft

  1. Open Perplexity Polza Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

Что нужно для установки

  • Claude Desktop или Claude Code (или любой другой MCP-клиент)
  • uv (ставится одной командой, см. ниже)
  • Python 3.11+
  • POLZA_AI_API_KEY — ключ берётся на polza.ai/dashboard/api-keys

Поставить uv:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Установка за 2 минуты (через PyPI + uvx)

Это самый простой путь: ничего клонировать не надо, uvx сам скачает пакет из PyPI.

Claude Code / VS Code

Создай файл .mcp.json в корне своего проекта:

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 и добавь:

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/v1Base URL для chat completions (с /v1 — это ожидаемо, endpoint OpenAI-совместим)
PERPLEXITY_MODELнетperplexity/sonarМодель для perplexity_ask
PERPLEXITY_RESEARCH_MODELнетperplexity/sonar-deep-researchМодель для perplexity_research
LOG_LEVELнетINFO—

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

bash
git clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.gitcd perplexity-polza-mcp-serveruv syncPOLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.server

Для локального подключения из source в Claude:

json
{  "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.

Source: README.md at commit 5cf84e5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts