MCP App Store
by KeenEthics
Matchbook icon

Matchbook MCP Server for ChatGPT

By Sergii Sergieiev

Overview

Keep a personal tournament journal through conversation. Import results, record rounds, correct matches, and explore performance by deck, opponent, and archetype. Matchbook accesses only the connected account’s records. Google sign-in is required; new accounts start with an empty journal.

How to connect

  1. ChatGPT: Open the Matchbook listing in the ChatGPT app directory and choose Connect. ChatGPT listing Matchbook exposes 18 tools here.

Tools

add_match

ChatGPT
Add a round result to the current active tournament. eventId can be supplied explicitly. result is authoritative; game scores are optional and may be null.

delete_match

ChatGPT
Permanently delete one match from the connected account. Identify the exact match and confirm the deletion with the user first. There is no undo tool.

delete_tournament

ChatGPT
Hide a tournament and its matches from all interfaces and statistics. Identify eventId and confirm deletion first. Returns eventId, deletedAt and purgeAt. Can be restored with restore_tournament before purgeAt (one calendar month UTC); then permanently deleted with its matches. Repeating deletion does not extend retention.

get_game_profile

ChatGPT
Get optional opening-hand fields and ordinary rules. Supply eventId to use the tournament's saved game and format, or game for a new tournament. Unknown game has no opening-hand profile. Suggested limits may vary by format.

get_matchup_stats

ChatGPT
Get the user's results grouped by opponent deck archetype, with sample sizes, W/L/D, game totals, win rates and lastPlayed tournament date. Use deckId and format to analyze a specific deck. All-time and all result types by default; use resultTypes=['played'] for played matches only. Archetypes are grouped ignoring case and extra whitespace, including Unknown. Sorted by match count descending. Rates use the same formulas as get_stats; zero denominators return 0.

get_opponent_history

ChatGPT
Get the user's history against an exact named opponent, ignoring Unicode, case and whitespace variations. Requires a known name; use list_opponents to discover names. Returns paginated match items with decks, scores and notes, plus summary and archetypes for ALL filtered matches, not just the page. All-time and all result types by default. Rates follow get_stats. Unknown names are excluded; no matching history returns empty items and zero totals. Pagination/order follow list_matches.

get_stats

ChatGPT
Get the user's tournament and match statistics, optionally grouped by month, deck (ID and tournament format), or venue (name, city, country). All-time and all result types by default. Returns summary and groups, including sample sizes, W/L/D and rates as fractions: matchWinRate=W/(W+L), drawRate=D/(W+L+D), gameWinRate=gamesWon/(gamesWon+gamesLost). Zero denominators return 0. Game counts include only played matches; drawn games are not stored. Explicit tournament W/L/D totals are included unless match-level filters are supplied; those filters only use known matches. Empty tournaments count unless match-level filters are supplied.

get_tournament

ChatGPT
Get one tournament and all of its matches for inspection or editing.

import_tournament

ChatGPT
Create a new tournament, including the deck and all known match results. Repeating this call creates duplicates. If deckNotes is supplied, it overwrites notes on an existing deck with the same name and format. Game scores and matches may be omitted when unknown. Supply wins/losses/draws for an overall tournament record; these totals replace match-derived W/L/D. Use status=active for an ongoing tournament.

list_decks

ChatGPT
List the user's decks with deckId, name, registered format, notes, tournament count and lastPlayed tournament date in the selected period/location. All-time by default. Without date/location filters, includes unused decks with tournaments=0 and lastPlayed=null. Sorted by name and deckId. Use deckId in match and statistics tools.

list_matches

ChatGPT
Find the user's matches across tournaments. All-time by default; filters combine with AND. Returns items with matchId/eventId, tournament name and eventType, deck, opponent, scores and notes, plus total, limit, offset and nextOffset. Ordered by tournament date descending, eventId descending, Swiss rounds first, then playoff stages in elimination order. Items include playoffRound (null for Swiss). Follow nextOffset until null for all results.

list_opponents

ChatGPT
List all named opponents across the user's tournaments, sorted by name. Returns name, matches, wins, losses, draws (match results), gamesPlayed, gamesWon, and gamesLost from the user's perspective. Game counts include only resultType=played; drawn games are not tracked. Names are grouped ignoring case and extra whitespace; unknown names are excluded.

list_tournaments

ChatGPT
List the user's tournaments with summary results.

list_venues

ChatGPT
List the user's venues as venueName, city, country, based on tournament dates. Defaults to the current UTC calendar year. Supply years for selected years or allTime=true for all history; do not combine them. Deduplicates by venue name and location ignoring case and extra whitespace; sorted by venue name, city, country. Missing city/country remain empty strings.

restore_tournament

ChatGPT
Restore a deleted tournament by eventId before its purgeAt deadline (one calendar month UTC after deletion), including its matches and statistics. Expired tournaments cannot be restored.

update_match

ChatGPT
Overwrite only supplied fields of an existing match in the connected account. Discover the exact matchId before correcting it.

update_tournament

ChatGPT
Update tournament details or change its status. Supply only the fields that need to change. Supplied fields overwrite existing values; deckNotes can also overwrite notes on a shared deck.

upsert_game

ChatGPT
Create or update one game in a match. Omitted fields are preserved; null clears a field. Player and opponent refer to the account owner and their opponent. Do not infer unknown details. Returns the saved game and score consistency check.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/matchbook"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/matchbook)