Search Star Wars Unlimited cards using natural text and optional structured filters. Pass query for free-text matching; use filters to constrain by aspect, type, arena, rarity, set, trait, or numeric stats (cost/power/hp). Returns a typed SearchResult.

Look up a specific Star Wars Unlimited card by name or set_code+card_number. Returns the full CardDetail record.

Return a random Star Wars Unlimited card from a search result set.

Return the front or back image URL for a Star Wars Unlimited card.

Upload a Star Wars Unlimited decklist into a named stateful session.

Draw one or more cards from an uploaded deck session.

View the current hand, resources, and core counters for a deck session.

View the current in-play board state, including ground, space, leaders, bases, and resources.

Take a full-hand mulligan in the current deck session.

Swap cards between the main deck and sideboard, then reset playtest zones.

Advance the resource phase by readying resources, optionally resourcing a hand card, and drawing for turn.

Play or deploy a card from hand, discard, or leader zone into ground, space, or resources.

Move an existing in-play card or leader/resource between zones such as ground, space, resource, and discard.

Update a card's ready state and counters while it is in play.

Defeat a card from the board or another in-play zone and move it to discard.

Validate a Star Wars Unlimited deck for Premier or Twin Suns.

Analyze a Star Wars Unlimited deck's curve, aspects, roles, and synergy.

Suggest cards to improve a Star Wars Unlimited deck toward a stated goal. Set only_owned=True to restrict suggestions to cards in your loaded collection.

Generate a first-pass Star Wars Unlimited brew around a theme. Set only_owned=True to build only with cards in your loaded collection (quantities will be capped by ownership). By default the deck is restricted to on-aspect cards (the aspects granted by the two leaders plus the base); set allow_off_aspect=True to permit off-aspect splashes that cost extra resources. Set target_avg_cost to steer the curve (e.g. 2.5 for an aggressive low-curve deck, 3.5 for midrange); lower = cheaper and faster. When omitted, the format default is used.

Twin Suns only — brew a deck for every legal leader pairing in your owned pool and rank them by composite score (synergy + interaction density - off-aspect burden). Use moral='Heroism' or 'Villainy' to narrow. primary_aspects filters leaders whose aspects intersect the given list. include_decks=true returns full holoscan lists for the top_k results. Useful for surfacing leader pairs you wouldn't have considered manually.

Import a Star Wars Unlimited card collection from a SWUDB CSV export (columns: Set, CardNumber, Count, IsFoil). Persists to disk. Set merge=True to add to existing collection instead of replacing it.

Summarize the loaded Star Wars Unlimited collection — total cards, unique printings, per-set breakdown, and storage path.

Profile the loaded collection for combo-package density. Returns per-package enabler/payoff counts (Force engine, Indirect damage, When Defeated, Pilot/Vehicle, Token swarm, Cost reduction, Fortress, Bounty Hunter, Mandalorian) and flags which are 'live' (≥4 enablers + ≥2 payoffs). Pass refresh=true to recompute from scratch.

Return how many copies of a specific Star Wars Unlimited printing the user owns. Use set_code and card_number (e.g. LOF 47).

List owned printings from the loaded collection, optionally filtered by set_code. Pass limit=0 for no limit.

Export a deck session or decklist as plain text or JSON.

Start a two-player Star Wars Unlimited game between you and Claude.

Run a full AI-vs-AI game simulation to completion. Both players must be AI (set player_is_ai=true in start_game). Returns winner, base damage breakdown, MVP cards, and full game log.

Get the current two-player game state, with hidden information filtered by viewer unless reveal_all is true.

Return the currently legal actions for the active player in a game.

Take a game action such as resource, play, resolve_effect, pass_priority, deploy_leader, attack, or end_turn.

Let the AI pilot its side for one turn or until it ends the turn.