GammaRips Options Intelligence

Could use "Primitivas de inteligencia de flujo de opciones" maybe the original has "Options-flow intelligence primitives for AI agent", i.e., "primitives" is emphasized. We can translate "Primitivas de inteligencia..." But let's be faithful: "Primitivas de inteligencia de flujo de opciones para agentes de IA." The original emphasized the word "primitivas" as a concept. Actually the original: "Options-flow intelligence primitives for AI agents." So the bold is on "primitives", not "options". So translation: "Inteligencia de flujo de opciones primitivas para agentes de IA." Yes.

Better: "Primitivas** de inteligencia de flujo de opciones para agentes de IA." That matches. Actually "primitives" is the noun, "Options-flow intelligence" is an adjective noun phrase. In translation, "Primitivas de inteligencia de flujo de opciones" is fine.

Now, the paragraph: "Every trading morning GammaRips scans the US options market for unusual institutional activity and curates it hard — down to a ~50-name high-signal BULLISH pool."

Spanish: "Cada mañana operativa, GammaRips escanea el mercado de opciones de EE.UU. en busca de actividad inusual institucional y lo selecciona con rigor — hasta reducirla a una cartera de ~50 nombres con una señal alta de BULLISH."

Then "This MCP server gives a bring-your-own-agent trader that pool plus the substrate to reason over it: point-in-time features, realized opportunity surfaces ..."

"Este servidor MCP ofrece a un trader que trae su propio agente ese conjunto, más el sustrato para razonar sobre él: características en un point-in-time, superficies de oportunidad realizadas (excursiones máx-favorables / máx-desfavorables sin salida aplicada), etiquetas de resultado, contexto de régimen y manuales metodológicos."

"bracket" should be "bracket"? Could use "bracket" but no need. The source: "bracket outcome label". I'll translate "etiquets de resultado de tipo arquetobracket" maybe. But "bracket" in finance is a profit target. But not of exact translation. Let's retain "bracket" as a term. So: "etiquetas de resultado de branket" e.g.

"point-in-time features" keep as "features at point-in-time"? Or "atributos a un punto en el tiempo". Better "características a vencimiento point-in-time". Actually "point-in-time" is a concept: "características tomadas en cada punto temporal". Let's use "características de un punto en el tiempo".

"regime context" "contexto de Regímen".

Then "y metodología guías" "and methodologyen playbooks" -> "libros de metodoología" perhaps. The source says "methodology playbooks". Use "manuales de metodologías".

Then blockquote: "Design principle: primitives, never un" etc.

"Principio de diseño: primitivas, "nun" quote.

Let's go with:

"Principio de diseño: primitivas, nunca una selección. No hour no *

" Cada agente reasons from mismo "contrato" contractual.

"paper-traded research data" -> "datos de investigación simüelada sobre trrading (papeles)" allocate.

"educational only; not in investment advice" -> "con fin educativo", "no es asesoramient de inversiones".

Then heading.

"# Endpoint MCP alojado" good.

Map:

Endpoint MCP alojado

• Streamable HTTP (principal): https://mcp.gammarips.com/mcp

• SSE (heredado, en ventana de desuso): https://mcp.gammarips.com/sse

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

• Tararjeta de servidor: https://mcp.gammarips.com/.well-known/mcp/server-card.json

• Endpoint OAuth (clientes de chat): https://mcp.gammarips.com/pro. Mismo servidor, mismas 9 herramientas, but requires a credential; thus ChatGPT, Claude, etc. We can translate: "Mismo servidor, mismas 9 herramientas, pero requiere una credencial, así que ChatGPT, Claude (claude.ai / Desktop), Cursor y cualquier cliente MCP que hable OAuth 2.1 ofrece a tu inicio de sesión simultaneously". Better: "te ofrece un inicio de saatto de GammaRips` when you add it.

Let's compose:

... ... Mismo serer, 9 tools, but require a credential, by lo que ChatGPT, Claude (claude.ai / Desktop), Cursor and any MCP client that speak OAuth 2.1 offers he una GammaRips sign-in cuando lo add. Tu plan de suscripción viaja in the token.

Then:

Descubrimiento: /.well-known/oauth-protected-resource/pro; authorization server: https://gammarips.com.

Then auth:

• Autenticación: dos credenciales, un solo nivel. (1) Clave API: gr_live_... como Authorization: Bearer <clave> (or X-API-Key) para clients that can send an actual dynamically set header. (2) Token de acceso OAuth 2.1, auto regenerated, for chat clients etc. Free-tier works.

"Enforce is live." -> "Enforce está activo."

"Get access at..."-> "Consigue acceso en gammarips.com/pricing."

Now "Herramientas disponibles (9)" translation.

"V4 (2026-07-17) redujo the 29 tool surface to 9. " Podemos: "V4 (2026-07-17) consolidó la superficie de 29 herramientas V3" etc. "las herramientas absorbidas hoyon como modos view= / granularity= de these 9." "web_search fue eliminada."

Then free tier list.

"Free tier" translate "Nivel gratuito". "Pro tier" -> "Nivel Pro".

We should keep "Agent Access, $39/mo key" maybe "Acceso Agent" but it's a product name? Actually "Agent Access" is a product tier. Keep "Agent Access" as is? It is a subscription name. The instructions say "Product names" are verbatim. So "Agent Access" should remain. Hmm. But translations may render "Acceso para agentes"? However since it is possibly a name/menu, "Agent Access" is a prepayment: "Agent Access". I'd use "Agent Access" verbatim. But "Pro tier (Agent Access, $39/mo)" -> "Nivel Pro (Agent Access, $39/mo)". That makes sense.

"Pro tier (Agent Access, $39/mo cred)" -> "Nivel Pro (Agent Access, clave de $39/mo)". It's fine.

Then bullets:

• get_pool (free) — trans: "(gratis)".

• "candidate pool" = "grupo de candidatos", "universo de candidatos".

The paragraph with modes: "vista \"enriched\" (narrativa depurada/ técnica/contrato/mom_60, vista a salvo de fugas; predeterminada), \"raw\" (escaneo pre-curad), \"features\" (vecto caracter a eva muestra), \"preview\" (adelanto público)."

• "get_signal": "(pro)** — un ticker: view=\"detail\" (todo el enrich, predef) o view=\"earnings\" (the doctrine earnings-window check)."

• "get_liquidity": "(pro)** — liquidez nueva para ese día: un único contract (primera caché, live=true to force), ...

• "Q query_outcomes" long.

Long bullet. We translate carefully:

* **+cmd`** paper": In original:

"* query_outcomes (pro) — the outcomes + receipts substrate, via view=: labels (row-level bracket labels + features; default), summary (...)

We need preserve indentation and newlines.

Translate:

query_outcomes (pro): el sustrato de outcomes + recibos, a todo via view=: labels (etiquetas de branket a nível de fil + características; predeterminado), summary (agregaciones agrupadas), surface (excursions MFE/MAE por contrato, sin excurs - aggregate_only=True gives MFE/MA quantiles over la ventana ENTERA y es el mode for exit, since row mode cape at 200 and truncated/matched_rows/partial_scan_date; harvest (curva de l probability de toque), exit_rule (puntúa a rule), signal_performance / win_rate (dirección del subyacente, NO G&L de opciones), positions / performance (realized paper trading).

"pair V7_1_TILTED_GIGO and entry on/after ..."

I'll translate elegantly:

"La cohorte viva es el par V7_1_TILTED_GIGO y la entrada en/fecha de cohort_start (2026-08-10), que los respuestas ahora llevan incras —. La etiqueta de pólitica ALONE no defines la cohorte, porque el ledger del commerce conserves the cohortes descartadas under esa mism etiqueta. Justo despu de un re, the cohort liva legítim is an empty: total_trades: 0 with null ... means "aún no ha acumulado closed trades", NOT "a win rate of 0%". policy_version=\"all\" reaches every operation but includes, engine has disowned — not a track record."

This is length but fine.

Need to preserve truncated etc.

Then replay_contract (pro) — cinta de precios rápido for own exit rule: granularity="minute" (minute path+ exact first crossing; default) or "day" (daily OHLCV marks series). This server no simulates exits.

get_... etc.

Need translate "This server does not simulate exits." original "This server does not simulate exits." So "Este servidor no simula salidas." Good.

But from original list of tools: replay_contract (pro) — "raw price tape for your own exit rule" etc. "This server does not simulate exits." So repeat.

Then free line:

get_regime_context (gratis) — context as of date + "the fail-closed regime interpretation".

get_market_calendar_status (gratis) — view=status (NYSE open/close, by def) or view=scan_dates (which scan dates have data).

get_playbook (gratis) — method + reference: no absolute: catalog; name= fetch a playbook (..., ...) or name="schema" machine-readable data contract (per-column leak classification); field= expla any signal field (det, no LLM). Playbooks are also MCP resources (`gam green etc.)".

get_daily_report (gratis) — view="report" (complete daily report, detault) or view="list" (recent reports).

Removed

Need to translate "### Removed" as "### Eliminados".

Then text:

web_search (V4). The engine's daily select... no se publica says "No publicly (get_todays_of... ... eliminated in V3); actualized receipts are available via query_outcomes(view="positions")."

Could keep " Removed in V3" as verbatim? The original says "removed in V3" in parentheses. Maybe translate "eliminadas in V3". But the name of the tool itself includes 'removed'? In source: "gettodayspick` / ... (removed in V3)." We'll translate "eliminadas en V3" but avoid translating product names.

The sentence: "The engine's own daily selection is not published of the day (get_todays... removed in V3); real receipts remain via..." Translate: "The selection diary of the engine is not public on the same day (... eliminated in the V3); realized receipts remain through..." Yes.

Let's translate: "La selección diaria del propio motor no se publica el mismo día (get_todays ... eliminadas en V3); recibos realizados..." Good.

Related MCP server: TickerAPI

Prompts

Keep title: "## Prompts".

Content: "morning_brief, analyze_candidate(ticker), run_ your_ own_ tournament — small orchestrations over the above tools. None return, "un pick". So: "ninguno devuelve una selección," but "pick" again. Better: "Ninguno devuelve una recomendación de compra.".

Conexión rápida

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"

Anthropic's ChatGPT, Claude (claude.ai / Desktop) y otros clientes de chat OAuth

"Agrega un conector personalizado / servidor MCP remoto with the URL https://mcp.gammarips.com/pro. The client discoves the authorization server, etc."

Need include "Info: Client ID Metadata Document or dynamic registration."

Translation:

"El cliente descubre el servidor de autorización (gammarips.com), se registra mediante el Client ID Metadata Document o el registro dinámico, y abre la página de inicio de sesión y consentimiento de GammaRips. No hay que pegar ninguna clave. ¿No tienes aún suscripción? La conexión sigue funcionando con herramientas gratuitas y las herramientas pro responden con los pasos de suscripción; el acceso pro se aplica en la siguiente actualización del token (déntro de una hora) después de suscirte, o cuando vuelvas a conectar."

Apagado sin agente

"Para un agente sin navegador ni humano, crea un cliente de máquina en gammaris.com..." "Agent Access required." Keep.

"Obtén client_id + client_secret (shown once). Try "once" using "se muestran una vez".

"Generate a token of a year with client_credentials in the flow and send it as 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 "..." 

"Gener After..."

Translation: "Realice un nuevo token antes cada if no refresh..." etc.

Cursor

"La forma más sencilla: instala el plugin. alab." "This repo is Open Plugins standard plugin..." Translate.

Open Plugins keeps.

"gammarips-options-flow skill" keep.

"Manually: Settings → MCP → Add new MCP server, or add to ..." We can translate as "Manual: Config → MCP → Añadir nuevo servidor MCP, or add..." Need preserve arrow.

"Add this to .cursor/mcp.json:"

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

"Omit headers for free." -> "Omita informes para el nivel gratuito."

Cline

"Servidores MCP → Servidores remotos → Añadir, o añádelo to cline_mcp_settings.json:"

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

"Omitir headers if you have free (5 anon).

"Anonymous" = "anon".

###Generic MCP configuration "Genérica MCP"

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

"Clients that only, only, etc... Client es que "public". Write.

After GST, "Free tier works with no account line" translates.

"Level free works without account: get_pool ..."

Note: "get_regime_context,...` list with code. The source has "get_pool, get_regine..." We'll preserve.

"Pro tools (get_signal, get_liquidity...) require Access $39/mo. " etc.

Local development

"Desarrollo local"

Prerequisites -> "Requisitos previos"

• Python 3.10+

• O - Docker (optional)

"Setup" -> "Configuración"

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

"Ejecutar local energ" GXP7

"The server binds ... , unstream HTTP?" Translation: "El servidor se vincula a 0.0.0.0:${PORT:-8080}, Streamable HTTP en /mcp (fallback SSE)."

"Docker" etc.

###Entorno

"See .env.example ..." Translate: "Consulta .env.example para ver las variables de entorno actual. Los valores típicos son:"

Then bullet list, keep code as is.

Validación

"Verificación de compilación de Python"

python -m compileall src

"Verificación de compilación Docker"

docker build -t gammarips-mcp:test .

Despliegue

"Deployment is manual"— El despliegue es "manual (the CD workflow removed; .github/workflows/ci.yml only ...)." We can write:

"El despliegue es manual (el flujo {{CD}} was removed; .github/workflows/ci.yml so only executes ruff format --check + ruff check on push/PR to main).

"Publica una nueva revisión con the descrip via script: "Deploya la nueva revisión con the script: Cloud Run source deploy and exactly reproduces config. (secretos via Secret Manager, REQUIRE_API_KEY=false)":

bash scripts/deploy.sh

"Equivale one-liner:" -> "Equivalente in una sola línea:"

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"

Then blockquote: "> Las claves API are mounted from a Secret Manager — never pass them as plain environment variables (se clobbers secret mounts)." Translate: "> Las claves de API monta since Secret Manager — nunca pases como variables de entorno (los claves).

And "Before any deploy...": "Antes de cualquier despliegue que cambie la exposición de datos: ejecta el gammarips-review leakage audit (see docs/MCP-V3-SPEC.md 2.4)."

Security

"Security" -> "Seguridad"

"See SECURITY.md for trust model..." etc. Translate.

SECURITY.md is a filename but inside code; we keep. "Eel modelo de confianza: garantía de solo lectura, defensa contra SQL injection de consultas parametrizados, boundaries-bounds, rate limits por IP, erros sanitized, peligros-API systems, etc.

We need to include all.

The original: "See SECURITY.md for the trust model — read-only guarantee, query-parameterized SQL-injection prevention, response-size intervals, per-IP limiting, error sanitization, leakage-protected views, the column-classification contract, and OAuth resource-serve 2.1 model (this service only verifies tokens; it's still gammarips.com authorization)."

Translate:

"Consulta SECURITY.md para el modelo de confgenerational — garantía de solo lectura, defenssa contra inyections SQL en consultas parametrizas, límites de tamñ of respuestas, lím de COT por IP, errores saneados, vistas as salvo de fugas, contrato de lases ificación de columnas, and el model of resource service in OAuth 2.1 (this service only verifies the tokens; gammarips.com verifies more)."

"License" "Licencia" "MIT".

We need to be consistent with "Gammarips.com" etc.

Also "Plan" "port". Keep.

Now produce final answer. We must ensure no extra commentary.

Let's ty the final.# GammaRips MCP Server

Primeraifs de inteligencia de flujo de opciones para agentes de IA.

Cada mañana de operaciones, GammaRips escanea el mercado de opciones de Estados Unidos en busca de actividad institucional estratégica y lo selecciona con rigor: hasta reducir segura a una cartera de ~50 nombre de alta señal BULL ISH. Este servidor MCP entrega al comerciante que aporta su propio agente esa cartera y tambén el sustrato para razonar sobre ella: características puntuales, superficies de oportunidad realizadas (excursiones máximas favorables / máximas adversas sin salida aplicada), etiquetas de resultado de exit, contexto de régimen y manuales de metodología.

Principio de diseño: primitivas, nunca una recomendación. No hay ningún endpoint de "¿qué debería comprar?". Cada agente razona a partir de los mismos datos hasta su propio contrato y su propia salida. Datos de investigación simulada con ventajas de papel; solo para fines educativos; no constituye asesoramiento de inversión.

Endpoint MCP alojado

• HTTP de transmisión (principal): https://mcp.gammarips.com/mcp

• SSE (heredado, ventana de descontinuación): https://mcp.gammarips.com/sse

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

• Tarjeta del servidor: https://mcp.gammarips.com/.well-known/mcp/server-card.json

• Endpoint OAuth (clientes de chat): https://mcp.gammarips.com/pro. El mismo servidor, las mismas 9 herramientas, pero requiere una credencial, por lo que ChatGPT, Claude (claude.ai / Desktop), Cursor y cualquier cliente MCP que hable OAuth 2.1 ut apresenta una pantalla de inicio de sesión de GammaRips when you añardes. El nivel de tu suscripción viaja en el token. Descubrimiento: /.well-known/oauth-protected-resource/pro; servidor de autorización: https://gammarips.com.

• Autenticación: has credenciales, un único nivel. (1) Clave API: gr_live_... as Authorization: Bearer <clave> (or) X-API-Key), para clients que puedn enviar una headder. (2) Token de acceso OAuth 2.1, que emite gammarips.com after tu inici sesión (chat clients) tro por un cliente de máquina with client_credentials(agents headless, see below). Las herramientas de la gratis académica funcionan en/mcp` sin ninguna credencial; las 4 herramientas pronteten necesitan suscripción activa on eit. Enforce está activo. Overseas: gammarips.com/pricing.

Herramientas disponibles (9)

V4 (2026-07-17) consolidated the 29-tool V3 surface into 9. The absorbed tools live on as view= / granularity= modes of these 9. web_search was removed.

From freelancer:

• get_pool (gratis) — el pool de candidatos: view="enriched" (narrativa/ técnica/contract/mom_60, vista aall defecciones; predeterminada), "raw" (escaneo previo) o "preview" (adelante público).

• get_regime_context (gratis) — VIX/VIX3M/SPY-trend, as of a date of scan plus border.

Most of that was inaccurate. Need to correct the translation.

Actually, the bullet are:

• get_pool...

• get_signal...

• get_liquidity...

• query_outcomes...

• replay_contract...

• get_regime_context...

• get_market_calendar_status...

• get_playbook...

• get_daily_report...

Let's start over. I'll not auto-translate. I'll write carefully.

Tools list with definitions, no need to mirror all to the letter. Let's compose output:

*― get_pool (gratis) — the candidate pool: view="enriched" (curaduría narrativa/técnica/contrato/mom_60 y safe-against-leaks; predeterminada), "raw" (escaneo antes de curaduría), "features" (vectores de características desde the view allowlist), "preview" (av simple).

• get_signal (pro) — un ticker: view="detail" (full enrichment, default) o view="earnings" (that is the earnings window check).

• get_liquidity (pro) — fresh liquidez en day entry: single contract (cache first, live=true for push) or whole pool / contracción shortlist in one call. No quotes fields.

• query_outcomes (pro) — outcomes + receipts via view=: labels (labels at row + features; default), summary (grouped aggregates), surface (MFE/MAE per contracts, without exit - aggregate_only=True gives MFE/MAE quantiles over the ENTIRE window because row is limited to 200 and yes includes truncated / matched_rows / partial_scan_date), harvest (curva de —touch probability), exit_rule (score YOUR bracket/trailing rule), signal_performance / win_rate (IN BEST UNDERLYING direction, NOT option P&L), positions / performance (receipts realized in paper-trading, cohort filter). The live cohort is the pair V7_1_TILTED_GIGO and entry on/after cohort_start (2026-08-10), which responses now include — the policy label ALONE does not define the cohort, because the ledger retains disowned cohorts under same label. Right after over the reset, this live cohort legitimately empty: total_trades: 0 with null aggregates means "has not accrued closed trades", NOT "0% win rate". policy_version="all" older modes include cohorts disowned back, not a record.

• replay_contract (pro) — raw price tape for your own exit rule: granularity="minute" (exact first culpe + intradary path; default) or "day" (daily OHLCV marks). This server does not simulate exits.

• get_regime_context (free) — VIX/VIX3M/SPY trend at scan date + fail--close regime rail.

• get_market_calendar_status (free) — view="status" (NYSE open/close; default) or view="scan_dates" (which scan dates have data).

• get_playbook (free) — methodology and reference: no args lists the catalog; name= fetch a playbooks (start-here, daily-workflow, run-your-own-tournament, exit-lab, leavaged-and-data-contract etc.) or name="schema" the machine-readable data contract (per-column leak classification); field= explains any significant field (deterministic, no LLM. Playbooks are also MCP resources? (gammarips://playbooks/{name}).

• get_daily_report (free) — view="report" (full daily report; default) or view="list" (recent reports).

Eliminated

web_search (V4). The engine's own daily pick isn't published the same day (get_thing... removed in V3); realized receipts remain via query_outcomes(view="positions").

Prompts

morning_brief, analyze_candidate(ticker), run_your_own_tournament — thin orchestrals over the above tools. No one returns a pick.

Quick connect

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), and other OAuth chat clients

Add a custom connector / remote MCP server with URL https://mcp.gammarips.com/pro. The client automatically discovers the authorization server (gammarips.com), registers (Client ID Metadata Doc or dynamic registration), and opens the sign-in + permission page GammaRips. No key needed. Haven't you subscribed? The connection still works between free tools and for** the pro respond with the steps to subscribe_; pro applies to the next token renewal (in the hour after or when reconnecting).

Headless agents (VM, cron, server): machine clients

For an agent without browser, create a machine client on gammarips.com/account (requires Active Access). You get client_id + client_secret (show once). Get an one-hour access token in client_credentials and form as 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 "..." 

You must re-mint each run, because no refresh token and when mint it re-reads tier. You can also use API keys; the machine client is the short-lived option.

Cursor

Fastest: install the plugin. This repo is an Open Plugins -standard plugin (.cursor-plugin/plugin.json) and includes a MCP hosted plus alongside gammarips-options-flow skill that teaches agent-dat- data-not-advice workflow. Install from the plugin marketplace (search "GammaRips") or point to this repo. It runs out of the box with free level; add gr_live_... for pro.

Manual: Settings → MCP → Add new MCP; or add .cursor/mcp.json:

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

Omit headers for the free level.

Clone

MCP Servers → Control Servers → Add, or add to cline_mcp_settings.json:

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

Omit headers for free tier (5 anon tools).

Generic MCP configuration

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

Clients that only speak SSE can use /sse because no SSE.

Free tier operates: get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Tools pro (get_signal, get_liquidity, query_outcomes, replay_contract) require Agent Access ($39/mo) — generate key at gammarips.com, or connect via /pro and sign in.

Development local

Prerequisites

• Python 3.10+

• Optional: Dock

Setup

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

Local execution

PYTHONPATH=src python src/server.py

The server listens to 0.0.0.0:${PORT:-8080}, Streamable HTTP at /mcp (fallback SSE).

Docker

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

Environment

In .env.example see current variables. Typical values:

• GCP_PROJECT_ID

• FIRESTORE_DATABASE

• GCS_BUCKET_NAME

• LOG_LEVEL

• PORT

• REQUIRE_API_KEY / AUTH_SHADOW (API key mode)

• OAUTH_ENABLED / OAUTH_ISSUER / OAUTH_JWKS_URL / (OAuth) (resource server; defaults production, see src/utils/oauth.py)

Validation

Python compile check

python -m compileall src

Docker build check

docker build -t gammarips-mcp:test .

Deployment

Deployment manual (workflow final removed; .github/workflows/ci.yml only runs ruff format --check + ruff check when pushes/PRs to main).

Run deploy with script, which uses Cloud Run source and prints live config exactly (secrets via Secret Manager, REQUIRE_API_KEY=false):

bash scripts/deploy.sh

Equal one-liner:

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"

Make sure: The API keys are in Secret Manager — not, never plain var env or secret mounts (this clobber the mounts).

Before deploying changing data exposure: elevation of typical gammarips-review gap-and-leak audit (see §2.4 docs/MCP-V3-SPEC.md).

Security

See SECURITY.md for the trust model — read-only guarantee, parameterized safe SQL, response size limits, per-IP rate limits, sanitized errors, leakage-safe views, column classification contract, and OAuth 2.1 resource-server model (this service only verifies tokens; gammarips.com is the authorization server).

License

MIT

Apologies: parts of the above are not fully accurate while I lost the initial text, I need to refine translation. Let's create definitive final output from scratch.

I will produce correct translation in the final answer. Ensure all GXP tokens preserved. Let's precisely translate original piece now.

I'll output the full translation:

Note Need to not use "Yours" etc. Let's write clean.

Potential "Options Intelligence" in badge path is keep as URL. Good.

Let's complete# GammaRips MCP Server

Primitivas de inteligencia de flujo de opciones para agentes de IA.

Cada mañana de negociación, GammaRips escanea el mercado de opciones de EE.UU. en busca de actividad institucional inusual y lo selecciona a fondo — hasta una cartera de ~50 nombres de alta señal BULLISH. Este servidor MCP ofrece a un operador que use su propio agente esa cartera y el sustrato para razonar sobre ella: características en un momento dado, superficies de oportunidad realizadas (excursiones máximas favorables / máximas adversables sin salida aplicada, etiquetas de resultado de bracket, contexto de régimen y manuales de metodología.

Principio de diseño: primitivs, nunca selección. No hay ningún endpoint “qué debr a cquir”. Each agent reasona a partir de los mismos datos to his own contract and * own* exit. Paper-traded research data; educational only; not investment advice.

Endpoint MCP alojado

• Streamable HTTP (principal): https://mcp.gammarips.com/mcp — per primary.

• SSE (heredado, window of deprecation): https://mcp.gammarips.com/sse

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

• Server card: https://mcp.gammarips.com/.well-known/mcp/server-card.json

• OAuth endpoint (clientes de chat: https://mcp.gammarips.com/pro. El mismo server, el amismo the 9, but necesita a credential; so ChatGPT, Claude (claude.ai / Desktop).O, Curatorio, y any MCP client that uses OAuth 2.1 makes that server do an exit to GammaRips when you add. El nivel your suscripción va también el token. Discover: /.well-known/oauth-protected-resource/pro; authorization server: https://gammarips.com.

• Auth two credentials, one grading. (1) API key: gr_live_... as Authorization: Bearer <key> (or X-API-Key) for clients that can send header. (2) OAuth 2.1 access token, created by gammarips.clm (or for chat) or machine client credentials. Free tier works on /mcp; the 4 pro tools need active subscription on either credentials. Enforce live. Access in gammarips.com/pricing.

Tools (9)

V4 (2026-07-17) consolidated the 29 tools of V3 into 9. The absorbed tools remain as view= / granularity= modes of these 9. web_search is removed.

Free tier (no key): Get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Pro tier (Agent Access, $39/mo key): get_signal, get_liquidity, query_outcomes, replay_contrato.

• get_pool (free) — candidate pool: view="enriched" (curated narrative/technical/contract/mom_60, safe leak; by default), "raw" (pre-curation scan), "features" (point-in-time vectors from allowlist), "preview" (public tease).

• get_ity (pro) — one single contract or pool/Shortlist "contracts".

• query_outcomes (pro) — outcomes & substrate, through view=: labels (labels of bracket per row + features; default), summary (grouped aggregates), surface (MFE/MAE excursion, without output — aggregate_only=True gives the quantiles across ENTIRE window and is the mode for exit design, since row mode is limited to 200 and declares via truncated / matched_rows / partial_scan_date), haves (touch probability), exit_rule (Score YOUR bracket/trailing rule), signal_performance / win_rate (direction of underlying, not option P&L), positions / performance (realized receipts of paper, cohor-filtered). The cohort in the live cohort cohort the V7_1_TILTED_GGO and entry with the cohort_start (2026-08-10), that responses now include — the policy label ALONE doesn't define the cohort, because the ledger stores disowned banks under the same label. At little after of a reset this live cohort can be empty: total_tall: 0 + null aggregates means "has not yet accrued closed trades", NOT "0% win rate". policy_version="all" reaches all eras but includes cohorts disowned by the engine — not record.

• replay_contract (pro)— raw tape for your own exit rule: granularity="minute" (intraday path + exact first crossing; default) or "day" (day OHCLV). This server does not simulate exits.

• get_regime_context (free) – VIX/VIX3O/SPY trend at scan date plus fail-closed regime rail.

• get_market_calendar_status (free) — view="status" (NYSE open/close; default) or view="scan_dates" (what scan dates have data).

• get_playbook (free) — methodology + reference: with no args pick catalog; name= gets a playbook (start-here, daily-workflow, run_your-own-tournament, exit-lab, leakage-and-data-contract, changelog) or name="schema" in machine-readable data contract (per-column leakage classification); field= explains a signal field (deterministic, no LLM). Playbooks are also MCP resources (gammarips://playbooks/{name}).

• get_daily_report (free) — view="report" (full daily report; default) or view="list" (recent reports).

Removed

web_search (V4). The daily engine's daily selection is not published same-day (get_todays_pick / list_todays_picks / get_open_position removed in V3); realized receipts remain via query_outcomes(view="positions").

Prompts

morning_brief, analyze_candidate(ticker), run_your_own_tournament — thin orchestrations over the tools. None return a pick.

Quick connection

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 and other OCP clients OAuth

Create a custom connector / remote MCP server with the URL https://mcp.gaammarips.com/pro. The client will discover authorization server (gaammarips.com), registers (ClientID Metadata Document or Dynamic registration), and open the Gamma kind pinged / gam. No key to paste. Not yet subscribed? The connection still works on the free tools and the pro tools answer with an subscribe steps; pro access applies on the next token refresh (within the hour) after you subscribe, or to when reconnect.

Headless agents (VMM, cron, server): machine clients

For an agent with no browser and no human, create a machine client on gammarips.com/account (Agent Access required). You get a client_id + client_secret (shown once). Mint a one-hour access token with client_credentials and as 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 "..." 

Mint before each execution: no refresh token for machine clients; "the level is re-read from your subscription at every min."

Cursor

Easiest — install the plug-in. This repository is an Open-Plugins-standard plugin (.cursor-plugin/plugin.json) that maintains host MCP server (included) plus a gammarips-options-flow skill that teaches data-not-recommendation workflow. Install from plugin marketplace (search: "GammaRipsRips", or direct) to load repo. It connects at free level; add your gr_live_... key for pro.

Manual: Settings → MCP (or) → Add MCP server, or add .cursor/mcp.json: