Odds De-vig MCP Server

MCP-Server zum Abrufen von Sportquoten von The Odds API und zum Entfernen der Buchmachermarge (vig).

✅ Neueste Verbesserungen (v1.1.0)

• API Usage Tracking: Alle Antworten enthalten jetzt das verbleibende API-Aufruf-Kontingent

• Retry Logic: Automatische Wiederholungen bei Verbindungsproblemen (3 Versuche)

• Better Error Handling: Verbesserte Behandlung von Netzwerkfehlern

• Response Format: Strukturierte Antworten mit summary und apiUsage

Funktionen

Tools

1. get_sports - Liste der unterstützten Sportarten abrufen (ohne API-Anfrage)

2. get_today_mlb - Heutige MLB-Spiele mit verarbeiteten Quoten abrufen (kosteneffizient)

3. get_upcoming_odds - Rohe Quoten abrufen (Standard: heutige MLB-Spiele)

4. get_processed_odds - Verarbeitete Quoten mit entfernter Marge abrufen

5. get_event_consensus - Konsenslinie für ein bestimmtes Ereignis abrufen

6. get_api_usage - API-Nutzungsstatistik abrufen (macht 1 API-Anfrage)

Ressourcen

• odds://sports - Liste der unterstützten Sportarten (ohne API-Anfrage)

• odds://today-mlb - Heutige MLB-Spiele mit verarbeiteten Quoten

• odds://processed - Verarbeitete Quoten ohne Marge (Standard: heutige MLB)

Methoden zur Margenentfernung

1. Proportional - Standard

Die einfachste und am häufigsten verwendete Methode:

fair_probability = implied_probability / total_implied_probability

2. Power (Exponentiell/Shin)

Eine komplexere Methode, die die Anzahl der Ergebnisse berücksichtigt:

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

3. Additive

Verteilt die Marge gleichmäßig auf alle Ergebnisse:

fair_probability = implied_probability - (total_vig / number_of_outcomes)

Installation und Start

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

# Сборка
npm run build

# Запуск
npm start

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

Konfiguration

Setzen Sie die Umgebungsvariable ODDS_API_KEY oder verwenden Sie den Standardschlüssel:

export ODDS_API_KEY=your_api_key_here

⚠️ API-Limits

WICHTIG: The Odds API hat ein Limit von 500 Anfragen pro Monat für den kostenlosen Plan!

Optimierungen zur Einsparung von Anfragen:

• Standardmäßig werden nur heutige MLB-Spiele abgefragt

• get_sports gibt eine fest codierte Liste ohne API-Anfrage zurück

• get_today_mlb - der kosteneffizienteste Weg, um Daten zu erhalten

• Alle Anfragen protokollieren die API-Nutzung

Empfehlungen:

• Verwenden Sie get_today_mlb zum Testen

• Beschränken Sie sich auf 20 Anfragen pro Tag für Tests

• Überwachen Sie die Nutzung über get_api_usage

Verwendung

Abrufen der Sportartenliste (ohne API-Anfrage)

{
  "tool": "get_sports"
}

Abrufen der heutigen MLB-Spiele (kosteneffizient)

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

Abrufen der verarbeiteten Quoten

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

Abrufen der Konsenslinie

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

Datenstruktur

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; // После удаления маржи
}

API-Limits

KRITISCH: Limit von 500 Anfragen/Monat!

Aktuelle Optimierungen:

• Fokus auf MLB (spielt täglich)

• Nur Anfragen für heutige Spiele

• Fest codierte Sportartenliste

• Protokollierung jeder Anfrage

Überwachung:

{
  "tool": "get_api_usage"
}

Gibt zurück:

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

Nächste Schritte

1. Polymarket CLOB API Server - zum Abrufen von Daten aus Polymarket

2. Comparison Server - zum Vergleich von Linien und zur Suche nach Arbitrage

3. News/SERP Server - zum Abrufen von Nachrichten und Kontext