Odds De-vig MCP Server

Servidor MCP para obtener cuotas deportivas de The Odds API y eliminar el margen de la casa de apuestas (vig).

✅ Últimas mejoras (v1.1.0)

• API Usage Tracking: Todas las respuestas ahora incluyen el saldo de llamadas a la API

• Retry Logic: Reintentos automáticos ante problemas de conexión (3 intentos)

• Better Error Handling: Manejo mejorado de errores de red

• Response Format: Respuestas estructuradas con summary y apiUsage

Características

Herramientas (Tools)

1. get_sports - Obtener la lista de deportes compatibles (sin solicitud a la API)

2. get_today_mlb - Obtener los partidos de MLB de hoy con cuotas procesadas (económico)

3. get_upcoming_odds - Obtener cuotas sin procesar (por defecto: partidos de MLB de hoy)

4. get_processed_odds - Obtener cuotas procesadas con margen eliminado

5. get_event_consensus - Obtener la línea de consenso para un evento específico

6. get_api_usage - Obtener estadísticas de uso de la API (realiza 1 solicitud a la API)

Recursos (Resources)

• odds://sports - Lista de deportes compatibles (sin solicitud a la API)

• odds://today-mlb - Partidos de MLB de hoy con cuotas procesadas

• odds://processed - Cuotas procesadas sin margen (por defecto: MLB de hoy)

Métodos de eliminación de margen

1. Proportional (Proporcional) - por defecto

El método más simple y más utilizado:

fair_probability = implied_probability / total_implied_probability

2. Power (Potencia/Shin)

Método más complejo que tiene en cuenta el número de resultados:

fair_probability = implied_probability^n / total_implied_probability^(n-1)

3. Additive (Aditivo)

Distribuye uniformemente el margen entre todos los resultados:

fair_probability = implied_probability - (total_vig / number_of_outcomes)

Instalación y ejecución

# Установка зависимостей
npm install

# Сборка
npm run build

# Запуск
npm start

# Разработка
npm run dev

Configuración

Establezca la variable de entorno ODDS_API_KEY o use la clave por defecto:

export ODDS_API_KEY=your_api_key_here

⚠️ Límites de la API

IMPORTANTE: The Odds API tiene un límite de 500 solicitudes al mes para el plan gratuito.

Optimizaciones para ahorrar solicitudes:

• Por defecto solo se solicitan los partidos de MLB de hoy

• get_sports devuelve una lista codificada sin solicitud a la API

• get_today_mlb - la forma más económica de obtener datos

• Todas las solicitudes registran el uso de la API

Recomendaciones:

• Use get_today_mlb para pruebas

• Limítese a 20 solicitudes al día para pruebas

• Supervise el uso mediante get_api_usage

Uso

Obtener la lista de deportes (sin solicitud a la API)

{
  "tool": "get_sports"
}

Obtener los partidos de MLB de hoy (económico)

{
  "tool": "get_today_mlb",
  "arguments": {
    "deVigMethod": "proportional"
  }
}

Obtener cuotas procesadas

{
  "tool": "get_processed_odds",
  "arguments": {
    "sport": "americanfootball_nfl",
    "deVigMethod": "proportional",
    "removeOutliers": true,
    "minBookmakers": 3
  }
}

Obtener la línea de consenso

{
  "tool": "get_event_consensus",
  "arguments": {
    "eventId": "event_id_from_api",
    "deVigMethod": "power"
  }
}

Estructura de datos

ProcessedEvent

interface ProcessedEvent {
  id: string;
  sportKey: string;
  sportTitle: string;
  commenceTime: string;
  homeTeam: string;
  awayTeam: string;
  bookmakers: ProcessedBookmaker[];
  consensusLine?: {
    homeTeamFairOdds: number;
    awayTeamFairOdds: number;
    averageVig: number;
  };
}

ProcessedOutcome

interface ProcessedOutcome {
  name: string;
  americanOdds: number;
  decimalOdds: number;
  impliedProbability: number;
  fairProbability: number; // После удаления маржи
}

Límites de la API

CRÍTICO: ¡Límite de 500 solicitudes/mes!

Optimizaciones actuales:

• Enfoque en MLB (juega a diario)

• Solicitudes solo para los partidos de hoy

• Lista codificada de deportes

• Registro de cada solicitud

Monitoreo:

{
  "tool": "get_api_usage"
}

Devuelve:

{
  "requestsUsed": "15",
  "requestsRemaining": "485",
  "monthlyLimit": 500,
  "eventsFound": 12
}

Próximos pasos

1. Polymarket CLOB API Server - para obtener datos de Polymarket

2. Comparison Server - para comparar líneas y buscar arbitraje

3. News/SERP Server - para obtener noticias y contexto