ProxyAPI-Perplexity
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PPLX_PRICES | No | JSON с ценами для оценки стоимости в рублях за 1 млн токенов. По умолчанию — цены каталога на 03.11.2026. | |
| PPLX_WAIT_MS | No | Сколько ждать ответ до статуса «ещё выполняется», в миллисекундах. | 60000 |
| PROXYAPI_KEY | No | Ключ ProxyAPI напрямую. | |
| PPLX_LOG_FILE | No | Путь к файлу лога. По умолчанию — рядом с index.js. | |
| PROXYAPI_BASE | No | Адрес API ProxyAPI. | https://api.proxyapi.ru |
| PPLX_MODEL_PRO | No | Модель для режима pro. По умолчанию — модель Sonar. | |
| PPLX_SPEND_FILE | No | Путь к файлу учёта расходов. По умолчанию — рядом с index.js. | |
| PPLX_TIMEOUT_MS | No | Таймаут одного запроса в миллисекундах. | 900000 |
| PPLX_MODEL_QUICK | No | Модель для режима quick. По умолчанию — модель Sonar. | |
| PPLX_DAILY_BUDGET | No | Лимит расходов за сутки в рублях. 0 — без лимита. | 200 |
| PPLX_MODEL_REASON | No | Модель для режима reason. По умолчанию — модель Sonar. | |
| PROXYAPI_KEY_FILE | No | Путь к файлу key.env, содержащему ключ ProxyAPI. | |
| PPLX_MODEL_RESEARCH | No | Модель для режима research. По умолчанию — модель Sonar. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| perplexity_searchA | Ищет ответ в интернете через Perplexity и возвращает текст со ссылками на источники и стоимость запроса. Режимы: quick — быстрый факт, новость, проверка «так ли это» (perplexity/sonar, обычно меньше 1 ₽); pro — нужно больше источников и подробностей, сравнение вариантов (perplexity/sonar-pro, ~2–10 ₽); reason — нужен вывод из нескольких источников, «почему», «что выбрать» (perplexity/sonar-reasoning-pro, ~2–10 ₽). Для большого обзора темы используй perplexity_research. По умолчанию quick. Используй, когда нужна свежая или проверяемая информация из сети, а не общие знания. ВАЖНО: каждый вызов платный (списывается с баланса ProxyAPI пользователя). Перед вызовом обязательно спроси разрешение, показав вопрос, режим и примерную цену, и вызывай только после явного согласия. В конце ответа инструмент сам пишет фактическую стоимость — передай её пользователю. |
| perplexity_researchA | Глубокое исследование темы через Perplexity Deep Research (perplexity/sonar-deep-research): десятки источников, развёрнутый отчёт со ссылками. Идёт от одной до нескольких минут и стоит ~15–70 ₽. Если не уложится в 60 с, вернёт job_id — тогда проверяй через perplexity_check, не запуская заново. Используй только для больших обзоров (литература, рынок, сравнение множества вариантов), для простых вопросов — perplexity_search. ВАЖНО: каждый вызов платный (списывается с баланса ProxyAPI пользователя). Перед вызовом обязательно спроси разрешение, показав вопрос, режим и примерную цену, и вызывай только после явного согласия. В конце ответа инструмент сам пишет фактическую стоимость — передай её пользователю. |
| perplexity_checkA | Бесплатно (без обращения к модели) показывает статус запроса по job_id: идёт, готово (с ответом) или ошибка. Без job_id — список последних запросов, расходы за сегодня и остаток баланса. Разрешение пользователя не нужно. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool targets a clearly distinct action: web search with quality tiers (perplexity_search), long-form deep research (perplexity_research), and free job/balance status (perplexity_check). The descriptions explicitly route between them, telling the agent to use search for simple questions and research for large reviews, and to poll slow jobs via check rather than re-running.
All three names follow the same perplexity_<verb> snake_case pattern (check, search, research). The shared prefix makes the tool family immediately recognizable and the verbs map cleanly onto the actions.
Three tools is a tight, well-scoped surface for a paid search proxy: one query tool with modes, one heavy-research tool, and one free status/balance tool. Nothing appears redundant and no obvious capability is served by a missing tool.
The lifecycle is covered: submit a query, get tiered depth options, poll async jobs by job_id, and inspect spend/balance via the free check tool. Minor gaps remain — no cancel/abandon job operation and no conversational follow-up on a prior result — but agents can work around these by re-querying.