# research-tooling (Perplexity Pack)

Off-phase слой веб-разведки тулчейна Лидерры — три MCP-сервера для breadth-first
разведки на крупных/абстрактных задачах (актуальные практики, нормативные требования,
фич-разведка конкурентов, deep-research с цитатами). Формализован как 20-я off-phase
подкатегория `research-tooling` (Tooling §4.x #87–#89; ADR-019; границы — см. ниже).

## Серверы и роли

| # | Сервер | Пакет | Роль | Tools (ключевые) |
|---|---|---|---|---|
| 87 | **perplexity** | `@perplexity-ai/mcp-server` | ранжированный ответ-с-источниками + sonar | `perplexity_ask` / `perplexity_search` / `perplexity_research` / `perplexity_reason` |
| 88 | **exa** | `exa-mcp-server` | семантическое/нейро-обнаружение (находит концептуально близкое) | `web_search_exa` / `web_fetch_exa` |
| 89 | **firecrawl** | `firecrawl-mcp` | глубокое чтение страниц + обход + автономный research-агент | `firecrawl_scrape` / `crawl` / `extract` / `firecrawl_agent` |

**Разделение (anti-overlap):** perplexity — готовый ранжированный ответ; exa —
обнаружение источников по смыслу; firecrawl — прочитать/обойти/извлечь целиком.
Границы закреплены ADR-019.

## Ключи (только user env)

`PERPLEXITY_API_KEY` / `EXA_API_KEY` / `FIRECRAWL_API_KEY` — **только в пользовательском
окружении**, никогда в репозиторий (gitleaks/§5.4). Платные API (sonar-*, exa, firecrawl).
При отсутствии ключа сервер падает gracefully (как Sentry MCP), не ломая сессию.

## Риск bulk-load MCP-инструментов

+3 сервера ≈ +15 tools к общему числу MCP-инструментов. Исторически массовая загрузка
схем всех инструментов давала API-ошибку (`tools.110/113`) и роняла субагентов в
`subagent-driven-development` (см. `.mcp.json` нота про отключённый маркетинг 2026-05-31).
Сейчас спасает механизм deferred-tools (схемы грузятся по запросу через ToolSearch), но при
массовых субагент-прогонах это учитывать.

## Провенанс

Вет происхождения всех трёх пакетов (владелец/лицензия/провенанс/что исполняет) —
[research-vet.md](research-vet.md) (IS9, 2026-06-14): все три ПРИНЯТ.

## Связано

- [research-vet.md](research-vet.md) — провенанс-вет (IS9).
- `docs/superpowers/specs/2026-06-14-perplexity-pack-research-tooling-design-v3.md` — дизайн.
- `.mcp.json` — блоки серверов (Plan 1 Task 3).
- `docs/Tooling_v8_3.md` Прил. Н §4.x — реестр узлов (Plan 2).
- `docs/routing-off-phase.md` — связка L17 research chain (Plan 3).
