Search the pokemontcg.io card database. query accepts a card name or a raw Lucene query (e.g. 'supertype:trainer subtypes:supporter'). Filters are ANDed. Returns compact card summaries.

Fetch one card with full text, image URL and prices. Provide a pokemontcg.io id (e.g. 'me3-75'), or an exact name plus optional TCG Live set code (e.g. name 'Jacinthe', set 'POR').

Discovery tool: describe an effect in plain words (e.g. 'heal damage from benched pokemon') and get cards whose attack/ability/rules text matches. Keywords are ORed and results ranked by match count.

Validate a TCG Live export decklist (lines like '4 Slowpoke PBL 29'): 60-card total, max 4 copies per name (basic energy exempt), max 1 ACE SPEC, standard legality per card, plus a cardmarket price estimate.

Current top archetypes from Limitless TCG (limitlesstcg.com/decks) with tournament points and meta share. Returns a clear 'source unavailable' message if the live data can't be fetched — never stale guesses.

Cardmarket (EUR) and TCGplayer (USD) prices for every printing of a card, with the cheapest standard-playable version highlighted.

Parsed & resolved view of the local collection file (env POKEMON_COLLECTION_PATH, default ./collection.txt; TCG Live line format, # comments allowed): per-line counts, sets, kinds and standard legality plus summary totals. Unresolvable lines become warnings, never errors.

Append or increment cards in the collection file. Input: lines in TCG Live format ('4 Jacinthe POR 75'), one per line. A name without a set code is looked up; if several printings match, nothing changes and the candidates are listed. Comments in the file are preserved.

Decrement or drop cards in the collection file, matched against the file itself (no API). A bare name matching several printings in the file is ambiguous and changes nothing; over-removal clamps to zero with a note.

Deterministic deck builder over the local collection file: groups Pokémon into evolution-line attacker cores (evolvesFrom), assembles starters (8+ basics for 60 cards), draw supporters, search, switch and matched energy to the exact deck size, and validates with the check_deck rules. With deck_count=2 the pair is rebuilt up to 5 times to minimize a counter-score (weakness exploitation, status vs no-cure, energy denial, snipe vs bench, tempo) and the breakdown is reported.

Resolve raw card identifications transcribed from photos into verified printings. Lines may be messy: 'Slowpoke PBL 29' (quantity optional), '2 Slowpoke PBL 29', 'Mega Slowbro ex 031/084' (set inferred from the printed total), Japanese set codes ('ヤドン m5 028', m5→PBL — JP numbering differs, so mapped lines match by name), or a bare name ('Jacinthe' — newest standard-legal printing preferred, alternatives listed). Returns a resolved table, unresolved lines with reasons, and clean TCG Live lines ready for collection_add, check_deck or build_decks.

Save the session's card lines (TCG Live format) and optionally the built decks as a timestamped JSON record. Name defaults to today's date; a name collision appends -2 rather than overwriting.

All saved kitchen-table sessions: name, save time, card count and deck names, newest first.

Load a saved session by name: card lines come back in TCG Live format (paste into collection_add / check_deck / resolve tools) and decks as named decklists.