GammaRips MCP 서버

AI 에이전트를 위한 옵션 흐름 인텔리전스 프리미티브.

매일 거래 아침마다 GammaRips는 미국 옵션 시장에서 비정상적인 기관 활동을 스캔하고, 이를 엄선하여 약 50개 종목의 고신호 BULLISH 풀(pool)로 정리합니다. 이 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 및 OAuth 2.1을 지원하는 모든 MCP 클라이언트는 추가할 때 GammaRips 로그인을 제공합니다. 구독 등급은 토큰에 포함됩니다. 검색: /.well-known/oauth-protected-resource/pro; 인증 서버: https://gammarips.com.

• 인증: 두 가지 자격 증명, 하나의 등급 체계. (1) API 키: gr_live_...를 Authorization: Bearer <key>(또는 X-API-Key)로 사용, 헤더를 보낼 수 있는 클라이언트용. (2) OAuth 2.1 액세스 토큰, gammarips.com에서 로그인 후 발급(채팅 클라이언트) 또는 client_credentials를 사용하는 머신 클라이언트(헤드리스 에이전트, 아래 참조)가 발급. 무료 등급 도구는 자격 증명 없이 /mcp에서 작동하며, 4개의 프로 도구는 두 자격 증명 중 하나에 활성 구독이 필요합니다. Enforce가 활성화되어 있습니다. gammarips.com/pricing에서 액세스하세요.

Related MCP server: TickerAPI

사용 가능한 도구(9개)

V4(2026-07-17)는 29개 도구의 V3 표면을 9개로 통합했습니다. 흡수된 도구는 이 9개의 view= / granularity= 모드로 존재합니다. web_search는 제거되었습니다.

무료 등급(키 없음): get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. 프로 등급(Agent Access, $39/월 키): get_signal, get_liquidity, query_outcomes, replay_contract.

• get_pool (무료) — 후보 풀: view="enriched"(엄선된 내러티브/기술적 지표/계약/mom_60, 누출 방지 뷰, 기본값), "raw"(사전 엄선 스캔), "features"(허용 목록 뷰의 시점 특성 벡터), "preview"(공개 티저).

• get_signal (프로) — 단일 티커: view="detail"(전체 강화, 기본값) 또는 view="earnings"(독트린 수익 창구 확인).

• get_liquidity (프로) — 신규 진입일 유동성: 단일 contract(캐시 우선, live=true로 업스트림 강제) 또는 전체 풀 / contracts 단축 목록을 한 번에. 이 데이터 플랜에는 견적 필드가 없습니다.

• query_outcomes (프로) — 결과 + 영수증 기반, 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 (프로) — 자신의 종료 규칙을 위한 원시 가격 테이프: 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 채팅 클라이언트

URL https://mcp.gammarips.com/pro로 사용자 지정 커넥터 / 원격 MCP 서버를 추가하세요. 클라이언트는 인증 서버(gammarips.com)를 발견하고, 자체 등록(Client ID Metadata Document 또는 동적 등록)을 수행한 후 GammaRips 로그인 + 동의 페이지를 엽니다. 키를 붙여넣을 필요가 없습니다. 아직 구독하지 않으셨나요? 연결은 무료 도구에서 계속 작동하며 프로 도구는 구독 단계를 안내합니다. 구독 후 다음 토큰 새로 고침(1시간 이내) 또는 재연결 시 프로 액세스가 적용됩니다.

헤드리스 에이전트(VM, cron, 서버): 머신 클라이언트

브라우저와 사람이 없는 에이전트의 경우 gammarips.com/account에서 머신 클라이언트를 만드세요(Agent Access 필요). client_id + client_secret(한 번만 표시)을 받습니다. client_credentials 권한 부여로 1시간 액세스 토큰을 발급하고 베어러로 보내세요:

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

실행 전에 발급하세요: 머신 클라이언트에는 새로 고침 토큰이 없으며, 발급할 때마다 구독에서 등급을 다시 읽습니다. API 키도 같은 목적으로 작동합니다. 머신 클라이언트는 단기 자격 증명 옵션입니다.

Cursor

가장 쉬운 방법 — 플러그인 설치. 이 저장소는 Open Plugins 표준 플러그인(.cursor-plugin/plugin.json)입니다: 호스팅 MCP 서버와 데이터-아닌-조언 워크플로를 에이전트에게 가르치는 gammarips-options-flow 스킬을 번들합니다. 플러그인 마켓플레이스에서 설치("GammaRips" 검색)하거나 Cursor를 이 저장소로 지정하세요. 기본적으로 무료 등급으로 연결되며, 프로 도구를 위해 gr_live_... 키를 추가하세요.

수동: 설정 → MCP → 새 MCP 서버 추가, 또는 .cursor/mcp.json에 추가:

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

무료 등급은 headers를 생략하세요.

Cline

MCP 서버 → 원격 서버 → 추가, 또는 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. 프로 도구(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}에 바인딩되며, /mcp에서 Streamable HTTP(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 리소스 서버; 기본값은 프로덕션, src/utils/oauth.py 참조)

검증

Python 컴파일 확인

python -m compileall src

Docker 빌드 확인

docker build -t gammarips-mcp:test .

배포

배포는 수동입니다(CD 워크플로 제거됨; .github/workflows/ci.yml는 main에 대한 푸시/PR에서 ruff format --check + ruff check만 실행).

배포 스크립트로 새 개정판을 출시하세요. 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 리소스 서버 모델(이 서비스는 토큰만 검증하며 gammarips.com이 인증 서버입니다).

라이선스

MIT