Rox MCP — Docs

Multi-stage research MCP server. 12-фазный pipeline с поиском, scraping, structured extraction, triangulation, factcheck и сохранением в личный knowledge graph.

Подключение к Claude Code

claude mcp add rox \
  --transport http \
  https://mcp.rox.one/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Получить ключ: signup. Если ты уже зарегистрирован — он в dashboard.

Подключение к любому другому MCP-клиенту

Транспорт: Streamable HTTP. Endpoint: https://mcp.rox.one/mcp. Авторизация: Authorization: Bearer rox_sk_....

Формат запроса: JSON-RPC 2.0. Поддерживаются initialize, tools/list, tools/call, ping.

Tool: rox_research

Запускает 12-фазный pipeline. Возвращает session_id мгновенно, реальная работа идёт в фоне 30-360 секунд.

Параметры

{
  query: string,                       // обязательный
  depth: "shallow"|"medium"|"deep",    // default: medium
  languages: ["en","ru","zh"],         // default: ["en","ru"]
  search_providers: string[],          // default: [serper,brave,tavily]
  max_results_per_search: number,      // default: 10
  max_cost_usd: number,                // default: 5
  auto_enhance_prompt: boolean,        // default: false
  background_enrichment: boolean,      // default: true
  kg_persistence: boolean,             // default: true
  style_refinement: ["mermaid","tables","footnotes","english","tldr"],
  include_images: boolean              // default: false
}

Tool: rox_get_session

Получить состояние сессии и финальный отчёт (когда статус done).

{ session_id: string }

Что внутри: 12 фаз

  1. 00 meta-enhance — классификатор сложности + опциональная enhancement query + KG-хинты по прошлым сессиям
  2. 01 understand — NLU: entities, intent, languages, hidden question
  3. 02 resolve — Wikidata API: канонические QID + neighbors
  4. 03 plan — Multi-language search plan с доменной терминологией
  5. 04 search — Параллельный web search через serper/brave/tavily/exa
  6. 05 crawl — Firecrawl scraping top-K + paywall detection
  7. 06 extract — Per-source structured extraction по строгой JSON-схеме
  8. 07 triangulate — Кластеризация claims, confirmed/likely/disputed
  9. 08 interpret — Domain-specific интерпретация, привязанная к fact_base
  10. 09 synthesize — Финальный отчёт с обязательными citations
  11. 10 factcheck — Post-hoc удаление утверждений без citations
  12. 11 style-refine — Опциональный fan-out: mermaid, EN-версия, exec-summary
  13. 12 kg-persist — Запись entities + facts в Neo4j (per-user namespace)

Пример промпта для агента

Используй tool rox_research с такими параметрами:
- query: "<твоя тема>"
- depth: "deep"
- languages: ["en","ru","zh"]
- style_refinement: ["mermaid","tldr"]

После вызова покажи мне session_id, затем каждые 20-30 секунд вызывай
rox_get_session чтобы показать прогресс. Когда статус done — выдай
финальный отчёт целиком, источники и executive summary.

Сколько стоит

Стоимость считается из реальных LLM + search вызовов. Сейчас free tier: 10 сессий/день.

Background enrichment

Если включён background_enrichment — после выдачи финального отчёта pipeline продолжает крутиться в фоне каждые 5 минут (до 3 раз, в течение 2 часов после окончания) и обнаруживает gap'ы в собранных данных. Результаты gap-анализа видны в Sessions.

Knowledge Graph

Все canonical entities (Wikidata-resolved) и confirmed/likely facts сохраняются в твой персональный namespace в Neo4j. При следующем запросе с похожими entities Rox автоматически инжектит teaser-хинты в контекст модели — она может подтянуть прошлый контекст без раздувания нового запроса.

Лимиты / гарантии