AwardMath MCP-Server

awardmath-mcp verbindet KI-Assistenten über das Model Context Protocol mit der öffentlichen AwardMath-API.

AwardMath ist der Optimierer für Reisepunkte. Sie geben Ihre Punkteguthaben und ein Reiseziel an. Ein deterministischer Solver durchsucht einen versionierten Graphen aus Transferverhältnissen und Prämiencharts und liefert bis zu drei verifizierte, erklärbare Buchungspläne. Die Methode dahinter ist Aufzählung und Bewertung über veröffentlichte Charts. Ein LLM kann Ihre Frage analysieren und die Ergebnisse erklären, aber es wählt oder optimiert die Pläne niemals.

Dieses Repository enthält den MCP-Server und einen kostenlosen Daten-Snapshot unter data/. Der Server ist schreibgeschützt. Er benötigt keinen API-Schlüssel, kein Login oder keinen AbonnementDienst und betreibt kein Scraping von Fluggesellschafts-Websites.

Werkzeuge

Der Server stellt drei Werkzeuge bereit.

list_programs

list_programs gibt jedes Programm zurück, das AwardMath verfolgt, und zeigt an, welche Programm-IDs eine Suche heute ausgeben kann.

Zu den ausgabefähigen Programmen gehören Prämienprogramme mit bepreisten Charts sowie Bankwährungen, die in eines dieser Programme übertragbar sind. Diese Unterscheidung verhindert, dass ein Assistent den Solver um die Verwendung eines Aliens bittet, das keinen Weg zu einer bepreisten Prämie hat.

solve_award_trip

solve_award_trip sucht nach Plänen, die zu Ihrem Guthaben, den Abflug- und Zielorten, den Kabinen, der Reisendenzahl und einer Barzahlungsobergrenze passen.

Eine erfolgreiche Antwort enthält bis zu drei Pläne mit:

• Exakten Transferschritten

• Gesamtpunkten (required

• Den anfallenden Gebühren

Wenn kein Plan passt, enthält die Antwort no_plan_reasons. Diese benennen die fehlgeschlagene Beschränkung, instead of the Lücke mit einer geschätzten Route oder einem Preis zu füllen.

parse_wallet

parse_wallet wandelt Freitext in strukturierte Guthaben um.

Zum Beispiel:

250k Amex, 80k Chase

Eindeutige Guthaben werden zu Programm-IDs und Beträgen. Mehrdeutige Formulierungen werden zur Klärung angezeigt, statt versehentlich einem Programm zugeordnet zu werden.

Einrichtung

Sie können eine Auswertung des Servers direkt über GitHub oder eine Installation aus einem Clone durchführen.

Claude Code

claude mcp add awardmath -- uvx --from git+https://github.com/DanCastHub/awardmath-mcp awardmath-mcp

Claude Desktop oder einen anderer JSON-configured MCP-Client

{
  "mcpServers": {
    "awardmath": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DanCastHub/awardmath-mcp", "awardmath-mcp"]
    }
  }
}

Aus einem Clone

pip install -e .
awardmath-mcp

Es ist weder API-Key noch AwardMath-Konto erforderlich.

Beispiel

Bitten Sie Ihren KI-Agenten, konkrete Pläne anhand der vorhandenen Guthaben zu suchen.

Sie: Ich habe 60.000 Amex Membership Rewards Punkte. Finde einen bezahlten Economy-Sitzsitz von LAX nach HNL.

Assistent: Stand 2026-08-23 nutzte der preislich beste Plan 16.000 Qatar Avios für den Platz, finanziert durch einen Amex-Transfer bei 1:1. Das Ergebnis enthält die genauen Transferschritte, die erforderlichen Punkte und Gebühren. Weißabgleichbiten? Es bestätigt keine Verfügbarkeit eines Platzes.

Das Ergebnis ist datumsgebunden, da sich Verhältnisse und Preise ändern. Führen Sie eine neue Lösungungsanfrage durch, bestätigen Sie den Prämienplatz und erneut die Transfürkonditionen temperaturef, bevor Sie Punkte übertragen.

Datenmaterial

Das Verzeichnis data/ enthält einen datierten Schnappschuss des Prämien-Netzwerks und von ausgelieferte Solversergebnisse.

data/transfer-ratings-current.csv

Diese Datei enthält 109 Bank-zu-Programm-Transferkanten aus acht Quellwährungen, excepted am 2026-08-23.

Jede Zeile stellt die zuletzt beobachtete Überprüfung dar, die AwardMath gegen eine Programmseite oder über unabhängige Quellen verifiziert hat. Redaktionelle Behauptungen ohne nachvollziebaren Beleg wurden nicht aufgenommen.

Die Spalten umfassen:

• Umrechnungsfaktor

• Gebühren

• Übertragungszeit, falls beobachtet

• Verifizierungsstatus

• Datum der Beobachtung

Verhältnisse ändern sich. Beachten Sie jede Zeile nur für das beobachtete Datum als gültig und prüfen Sie das Programm vor einer Übertragung erneut.

data/sample-solved-plans.json

Diese Datei enthält die fünf Szenarien, die am 2026-08-23 mit inkwilligen Solver ausgeführt wurden.

Vier Szenarien führten zu Pläne. Darunter:

• LAX nach HNLi in der Economy-Klasse mit 60.000 Amex Membership Rewards Punkten

• SFO nach HND in Business-Klasse mit 100.000 Amex Membership Rewards Punkten, über Ana mit 82.500 Punkten

Ein Szenario ist bewusst leer. Die Suche von YVR nach DXB in Business-Klass zeigt, wie der Solver reagiert, wenn der Graph keine Route preislich darstellen kann. Er benennt die fehlende Graph-Abdeckung, PreisWeil ein Plan erfunden werden.

Was nicht enthalten ist

Der Datensatz ist ein Snapshot und nicht das vollständige AwardMath-Produkt.

Die versionierte Historie dahinter bleibt auf awardmath.com verfügbar. Diese Historie erstellt Vorgänge über Zeit und unterstützt Preisverlauf- und Entscheidungen wie Erwerben. Sie ist nicht in diesem Repository enthalten.

Was dieser Server nicht kann

Der Server erkennt keine Live-Verfügbarkeit von Prämienplätzen.

Die Fahrpläne werden anhand veröffentlichter Prämiablashsten und Transferregeln bezogen. Eine Route kann mathematisch valide essen, auch wenn auf den gewünschten Reisedaten keine Plätze frei sind.

Bevor Sie Punkte absenken:

1. Überprüfen Sie die Prämienverfügbarkeit auf Seats.aero, über PointsYeah oder bei der Fluggesellschaft.

2. Prüfen Sie den Punktepreis und die Gebühren beim jeweiligen Buchungsprogramm.

3. Kontrollieren Sie das Übertragungsververhältnis und die Bedingungen erneut.

Transfers sind unumkehrbar. Übertragen Sie nicht nur, weil der Solver einen Punktverlauf angefunden hat. Übertragen Sie erst, wenn Siesichergegangen sind, dass der Platz gebucht werden kann.

AwardMath verifiziert die Mathematik. Sie bestätigen den Platz.

Corporate Governance (Lizenzen)

Der Code steht unter der MIT-Lizenz.

Die Dateien unter data/ stehen unter CC BY-Lizenz. Verwenden Sie die Lizenz mit einem Link:

Quell. Zahlen: AwardMath

Quellen:

• AwardMath

• awardmath-mcp repository