GammaRips MCP Server

Примитивы аналитики опционных потоков для ИИ-агентов.

Каждое торговое утро GammaRips сканирует рынок опционов США на предмет необычной институциональной активности и тщательно отбирает её — вплоть до пула из ~50 высокосигнальных BULLISH-имён. Этот MCP-сервер даёт трейдеру, использующему собственного агента, этот пул плюс основу для рассуждений над ним: поканальные признаки на момент времени, реализованные поверхности возможностей (максимально благоприятные / максимально неблагоприятные отклонения без применения выхода), метки исходов по брекетам, контекст режима и методологические плейбуки.

Принцип дизайна: примитивы, никогда не выбор. Здесь нет эндпоинта «что купить». Каждый агент рассуждает на основе одних и тех же данных, приходя к собственному контракту и собственному выходу. Данные бумажного трейдинга; только для образовательных целей; не является инвестиционной рекомендацией.

Хостируемый MCP-эндпоинт

• Streamable HTTP (основной): https://mcp.gammarips.com/mcp

• SSE (устаревший, окно деприкации): https://mcp.gammarips.com/sse

• Stateless JSON-RPC: https://mcp.gammarips.com/jsonrpc

• Карточка сервера: https://mcp.gammarips.com/.well-known/mcp/server-card.json

• OAuth-эндпоинт (чат-клиенты): https://mcp.gammarips.com/pro. Тот же сервер, те же 9 инструментов, но он требует учётные данные, поэтому ChatGPT, Claude (claude.ai / Desktop), Cursor и любой MCP-клиент, поддерживающий OAuth 2.1, предлагает вход GammaRips при добавлении. Ваш тарифный уровень зашит в токене. Обнаружение: /.well-known/oauth-protected-resource/pro; сервер авторизации: https://gammarips.com.

• Аутентификация: два типа учётных данных, один тариф. (1) API-ключ: gr_live_... как Authorization: Bearer <key> (или X-API-Key) для клиентов, которые могут отправлять заголовок. (2) OAuth 2.1 access-токен, выпущенный gammarips.com после входа (чат-клиенты) или машинным клиентом с грантом client_credentials (безголовые агенты, см. ниже). Инструменты бесплатного тарифа работают на /mcp без каких-либо учётных данных; 4 pro-инструмента требуют активной подписки на любом из учётных данных. Enforce активен. Получите доступ на gammarips.com/pricing.

Related MCP server: TickerAPI

Доступные инструменты (9)

V4 (2026-07-17) объединил поверхность из 29 инструментов V3 в 9. Поглощённые инструменты живут как режимы view= / granularity= этих 9. web_search был удалён.

Бесплатный тариф (без ключа): get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Pro-тариф (Agent Access, $39/мес ключ): get_signal, get_liquidity, query_outcomes, replay_contract.

• get_pool (бесплатно) — пул кандидатов: view="enriched" (курируемые нарратив/технические показатели/контракт/mom_60, защищённый от утечек вид; по умолчанию), "raw" (скан до курирования), "features" (поканальные векторы признаков из вида allowlist), "preview" (публичный тизер).

• get_signal (pro) — один тикер: view="detail" (полное обогащение, по умолчанию) или view="earnings" (доктринальная проверка окна доходов).

• get_liquidity (pro) — свежая ликвидность на день входа: один contract (сначала кэш, live=true для принудительного запроса к источнику) или весь пул / короткий список contracts одним вызовом. Нет полей котировок в этом тарифном плане.

• query_outcomes (pro) — подложка исходов + квитанций через view=: labels (построчные метки брекетов + признаки; по умолчанию), summary (сгруппированные агрегаты), surface (по-контрактные MFE/MAE отклонения, без выхода — aggregate_only=True даёт квантили MFE/MAE по ВСЕМУ окну и является режимом для проектирования выхода, поскольку построчный режим ограничен 200 строками и объявляет это через truncated / matched_rows / partial_scan_date), harvest (кривая вероятности касания), exit_rule (оценка ВАШЕГО правила брекета/трейлинга), signal_performance / win_rate (направление БАЗОВОГО актива, не PnL опциона), positions / performance (реализованные квитанции бумажной торговли движка, фильтруемые по когорте). Живая когорта — это пара V7_1_TILTED_GIGO и вход на/после cohort_start (2026-08-10), которую ответы теперь несут — только политическая метка НЕ определяет когорту, потому что реестр сохраняет отозванные когорты под той же меткой. Сразу после сброса живая когорта легитимно пуста: total_trades: 0 с null-агрегатами означает «ещё не накоплено закрытых сделок», а НЕ «0% винрейта». policy_version="all" охватывает все эпохи, но включает когорты, которые движок отозвал — это не послужной список.

• replay_contract (pro) — сырая лента цен для вашего собственного правила выхода: granularity="minute" (внутридневной путь + точное первое пересечение; по умолчанию) или "day" (дневная серия OHLCV-меток). Этот сервер не симулирует выходы.

• get_regime_context (бесплатно) — VIX/VIX3M/SPY-тренд на дату скана + рельс режима с отказом в закрытом состоянии.

• get_market_calendar_status (бесплатно) — view="status" (открытие/закрытие NYSE, по умолчанию) или view="scan_dates" (какие даты сканов имеют данные).

• get_playbook (бесплатно) — методология + справочник: без аргументов выводит каталог; name= загружает плейбук (start-here, daily-workflow, run-your-own-tournament, exit-lab, leakage-and-data-contract, changelog) или name="schema" — машиночитаемый контракт данных (по-колоночная классификация утечек); field= объясняет любое поле сигнала (детерминированно, без LLM). Плейбуки также являются MCP-ресурсами (gammarips://playbooks/{name}).

• get_daily_report (бесплатно) — view="report" (полный ежедневный отчёт, по умолчанию) или view="list" (недавние отчёты).

Удалено

web_search (V4). Собственный ежедневный выбор движка не публикуется в тот же день (get_todays_pick / list_todays_picks / get_open_position удалены в V3); реализованные квитанции остаются через query_outcomes(view="positions").

Промпты

morning_brief, analyze_candidate(ticker), run_your_own_tournament — тонкие оркестрации поверх вышеуказанных инструментов. Ни один не возвращает выбор.

Быстрое подключение

Claude Code

# Free tier (no key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp

# Pro (with your key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp \
  --header "Authorization: Bearer gr_live_your_key"

# Pro with OAuth instead of a key (sign in once in the browser, tokens refresh):
claude mcp add --transport http gammarips https://mcp.gammarips.com/pro
# then run /mcp inside Claude Code and choose "Authenticate"

ChatGPT, Claude (claude.ai / Desktop) и другие OAuth-чат-клиенты

Добавьте пользовательский коннектор / удалённый MCP-сервер с URL https://mcp.gammarips.com/pro. Клиент обнаруживает сервер авторизации (gammarips.com), регистрируется (Client ID Metadata Document или динамическая регистрация) и открывает страницу входа + согласия GammaRips. Никаких ключей вставлять не нужно. Ещё не подписаны? Подключение всё равно работает на бесплатных инструментах, а pro-инструменты отвечают шагами подписки; pro-доступ применяется при следующем обновлении токена (в течение часа) после подписки или при повторном подключении.

Безголовые агенты (VM, cron, сервер): машинные клиенты

Для агента без браузера и без человека создайте машинный клиент на gammarips.com/account (требуется Agent Access). Вы получите client_id + client_secret (показываются один раз). Выпустите часовой access-токен с грантом client_credentials и отправьте его как bearer:

TOKEN=$(curl -s -u "$GR_CLIENT_ID:$GR_CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d resource=https://mcp.gammarips.com/pro \
  https://gammarips.com/oauth/token | jq -r .access_token)

# Claude Code headless (claude -p), with the token in .mcp.json:
#   { "mcpServers": { "gammarips": { "type": "http",
#       "url": "https://mcp.gammarips.com/pro",
#       "headers": { "Authorization": "Bearer ${GAMMARIPS_MCP_TOKEN}" } } } }
GAMMARIPS_MCP_TOKEN="$TOKEN" claude -p "..." 

Выпускайте перед каждым запуском: для машинных клиентов нет refresh-токена, и тариф перечитывается из вашей подписки при каждом выпуске. API-ключ по-прежнему работает для той же цели; машинный клиент — это вариант с краткосрочными учётными данными.

Cursor

Самый простой способ — установите плагин. Этот репозиторий — плагин стандарта Open Plugins (.cursor-plugin/plugin.json): он включает хостируемый MCP-сервер плюс навык gammarips-options-flow, который обучает вашего агента рабочему процессу «данные, а не советы». Установите его из маркетплейса плагинов (поиск «GammaRips») или укажите Cursor на этот репозиторий. Он подключается на бесплатном тарифе из коробки; добавьте свой ключ gr_live_... для pro-инструментов.

Вручную: Settings → MCP → Add new MCP server, или добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

Опустите headers для бесплатного тарифа.

Cline

MCP Servers → Remote Servers → Add, или добавьте в cline_mcp_settings.json:

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "type": "streamableHttp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

Опустите headers для бесплатного тарифа (5 анонимных инструментов).

Общая конфигурация MCP

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp"
    }
  }
}

Клиенты, поддерживающие только SSE, могут использовать устаревший эндпоинт /sse в течение окна деприкации.

Бесплатный тариф работает без аккаунта: get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Pro-инструменты (get_signal, get_liquidity, query_outcomes, replay_contract) требуют Agent Access ($39/мес) — сгенерируйте ключ на gammarips.com или подключитесь через /pro и войдите.

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

Предварительные требования

• Python 3.10+

• Опционально: Docker

Настройка

git clone https://github.com/DevDizzle/gammarips-mcp.git
cd gammarips-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

Запуск локально

PYTHONPATH=src python src/server.py

Сервер привязывается к 0.0.0.0:${PORT:-8080}, Streamable HTTP на /mcp (SSE-фолбэк).

Docker

docker build -t gammarips-mcp .
docker run --rm -p 8080:8080 --env-file .env gammarips-mcp

Окружение

См. .env.example для текущих переменных окружения. Типичные значения включают:

• GCP_PROJECT_ID

• FIRESTORE_DATABASE

• GCS_BUCKET_NAME

• LOG_LEVEL

• PORT

• REQUIRE_API_KEY / AUTH_SHADOW (режим шлюза API-ключа)

• OAUTH_ENABLED / OAUTH_ISSUER / OAUTH_JWKS_URL / OAUTH_MCP_RESOURCE_ORIGINS (OAuth 2.1 resource server; значения по умолчанию — продакшн, см. src/utils/oauth.py)

Проверка

Проверка компиляции Python

python -m compileall src

Проверка сборки Docker

docker build -t gammarips-mcp:test .

Развёртывание

Развёртывание ручное (рабочий процесс CD удалён; .github/workflows/ci.yml запускает только ruff format --check + ruff check на пушах/PR в main).

Отправьте новую ревизию с помощью скрипта развёртывания, который использует исходное развёртывание Cloud Run и точно воспроизводит живую конфигурацию (секреты через Secret Manager, REQUIRE_API_KEY=false):

bash scripts/deploy.sh

Эквивалентная однострочная команда:

gcloud run deploy gammarips-mcp --source=. \
  --project=profitscout-fida8 --region=us-central1 \
  --set-env-vars="REQUIRE_API_KEY=false" \
  --set-secrets="POLYGON_API_KEY=POLYGON_API_KEY:latest,GOOGLE_API_KEY=GOOGLE_API_KEY:latest,GOOGLE_CSE_ID=GOOGLE_CSE_ID:latest"

API-ключи монтируются из Secret Manager — никогда не передавайте их как обычные переменные окружения (это затирает секретные монтирования).

Перед любым развёртыванием, изменяющим раскрытие данных: запустите аудит утечек gammarips-review (см. docs/MCP-V3-SPEC.md §2.4).

Безопасность

См. SECURITY.md для модели доверия — гарантия только чтения, защита от SQL-инъекций через параметризованные запросы, ограничения размера ответов, лимиты скорости на IP, санитизированные ошибки, защищённые от утечек виды, контракт данных с классификацией колонок и модель OAuth 2.1 resource server (этот сервис только проверяет токены; gammarips.com — сервер авторизации).

Лицензия

MIT