# Reliquary MCP server

Source: https://glimind.com/server/mcp-registry%2Fgg.reliquary%2Freliquary
Registry id: `mcp-registry/gg.reliquary/reliquary`
Status: live (checked 2026-11-22T19:12:48.245Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 590
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "reliquary-mcp-server": {
      "type": "http",
      "url": "https://reliquary.gg/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http reliquary-mcp-server https://reliquary.gg/mcp
```

## Tools (74)

- `accept_friend`: Accept a circle request another player sent the current user (my_circle lists them under requests_received). Both become friends at once: each sees what the oth
- `add_friend`: Ask another player into the current user's trade circle by their handle ("@name"). Friends are matched against each other in one call (match_circle). A request 
- `add_holdings`: Add physical cards to the collection (bulk). Each item is a card reference (scryfall_id, or name [+ set_code, collector_number]) plus holding attributes. quanti
- `add_wants`: Add cards to a deck's list (its wantlist), or to the personal deck-independent wantlist when deck is omitted. Send the whole list in ONE call (max 75 items): it
- `allocate`: Allocate copies of a holding (holding_id from search_collection/where_is) to a deck (id or name). shared:false (default) claims free copies exclusively — the su
- `allocation_conflicts`: Decks that cannot be physically assembled at the same time: holdings promised (shared + non-shared) to more decks than copies exist. Use after claim_from_collec
- `answer_swap`: Answer a swap: approve or decline one proposed to the current user, or withdraw one they proposed. Approve moves cards in both collections at once: each copy gi
- `audit_location`: Reconciliation view for a location (id or name): every holding physically there, plus — for deck locations — sleeved allocations that claim to be there, and any
- `cancel_invite`: Take back an invite link the current user made (my_circle lists them, with their code): an open link stops bringing anyone in, and a link a newcomer used has it
- `card_detail`: Everything about one card: oracle data (mana cost, type line, rules text, color identity, legalities — the map includes paupercommander (Pauper EDH: whether the
- `cards_for_commander`: Cards that belong in a commander deck (id or name; Commander, Duel Commander or Pauper Commander, with its commander set), in two lists titled by `title` ("For 
- `check_legality`: Whether a pasted decklist is legal, without saving it: in one format, or in every format when none is given. Takes the list as text ("4 Lightning Bolt" a line; 
- `claim_from_collection`: Auto-match a deck's wants against the collection: free copies become non-shared staged allocations (real cards preferred over proxies). allow_shared:true additi
- `collection_value`: Total collection value in `currency` (default USD), plus gain/loss versus recorded purchase prices (converted through ECB rates). include_proxies defaults to FA
- `compare_trade`: Read-only: compares, and proposes or changes nothing (offer_swap is the tool that proposes a swap to a friend). Both directions of a trade with one player in ON
- `complete_deck_on_budget`: How to finish one deck (id or name) with `budget` to spend, in `currency` (default USD): the missing copies bought cheapest first while the budget lasts (`buy`,
- `crack_pack`: Conversational bulk-add for opening boosters: adds cards with origin preset to "booster" and location defaulting to "Unsorted". Give one item per distinct card 
- `create_deck`: Create a deck. Formats: commander | pdh (Pauper Commander) | dc (Duel Commander) | standard | pioneer | modern | premodern | legacy | vintage | pauper | casual 
- `create_location`: Create a physical location. kind: binder | box | deckbox | shelf | other (deck locations are automatic).
- `create_share_link`: Create (or fetch the existing) public share URL for a wantlist, deck, or tradelist. kind "wantlist": the cards still MISSING from a deck — or from the personal 
- `deallocate`: Release an allocation (fully, or `quantity` copies of it). Sleeved copies physically return to return_location (default "Unsorted"). Identify the allocation by 
- `deallocate_all`: DESTRUCTIVE: release EVERY allocation of a deck (holdings are never deleted; sleeved cards return to return_location, default "Unsorted"). Without confirm:true 
- `deck_combos`: The combos in a deck (id or name), any format, from Commander Spellbook's combo database (a copy refreshed with the card catalogue, not a live search). `in_list
- `deck_health`: Composed deck report: format legality (with per-issue detail: size, copy limits, sideboard, banned and restricted cards, commander and pairing rules, colour ide
- `deck_stats`: What a deck list is, for building: every row with its card facts (type, mana cost, mana value, colour identity, section, is_commander, is_companion), the mana c
- `deck_status`: Per-card status of a deck list (deck id or name). deck.commanders names who leads it (one card, or a pair); deck.companion names its companion, or null; its row
- `delete_deck`: DESTRUCTIVE: delete a deck (id or name). Holdings are NEVER deleted — every allocation is released and sleeved cards physically return to "Unsorted". Without co
- `draft_trade_post`: Read-only: writes the TEXT of a trade list for the user to copy and post themselves (WhatsApp, Discord, anywhere). It posts nothing, sends nothing and publishes
- `export_collection`: Export the whole collection as CSV text. format moxfield_csv (re-importable into Moxfield) or deckbox_csv. Large collections produce large text — offer the REST
- `export_deck`: Export a deck (id or name) as plain decklist text: Commander section first when set (both of a pair), then a Companion section when the deck names one, then the
- `find_substitutes`: Cards that could replace a target card, two ways. `similar`: the cards whose rules text is nearest the target's (precomputed over the whole catalogue, best firs
- `fix_unresolved`: Review imports that need attention. Without row_id: list unresolved rows (optionally for one job_id). With job_id, read_as also lists rows that named their card
- `generate_buylist`: Buylist of missing cards for one deck (id or name) or ALL decks (omit deck), cheapest-first, with a mass-entry friendly text block ("4 Lightning Bolt" per line)
- `import_batch`: Bulk-import collection rows that were parsed client-side from a CSV export: rows = the CSV rows as objects keyed by the file's own column headers. format: auto 
- `import_deck`: Create a deck from pasted decklist text — the reliable path, ask for it first ("4 Lightning Bolt (2XM) 123" per line; Commander/Sideboard sections, "SB:" lines 
- `invite_friend`: An invite link for ONE player who is not on Reliquary yet, to bring them into the current user's trade circle. Relay `url` and `sentence` for the user to send (
- `list_decks`: List all decks with format, card counts and allocation counts. `editable` false: the deck is past the decks the user's plan keeps editable. It still reads, shar
- `list_locations`: All physical locations (binders, boxes, shelves, …) incl. each deck's auto-created location, with holding/card counts.
- `list_sets`: Browse the Magic set catalog (cached from Scryfall, newest release first) with the user's per-set progress: card_count (total printings in the set), owned_print
- `list_share_links`: List every share link this user has minted — kind, what it points at (deck or location name), public URL, whether it is revoked, and for deck links what they sh
- `mark_circle_seen`: Record that the current user has seen their trade circle's matches: the next match_circle (here or on the Trade page) marks as `new` only what came after. Call 
- `match_circle`: Every friend in the current user's trade circle at once, both directions: for each friend, you_send (their published wantlists' missing cards against the user's
- `match_tradelist`: What the CURRENT user could GET from another player: the cards in that player's tradelist that the user's decks or personal wantlist still miss. Takes their tra
- `match_wantlist`: What the CURRENT user could SEND another player: that player's missing cards against the current user's copies. Takes their shared wantlist or deck link (a /s/ 
- `move_holding`: "The card is physically HERE now." Moves a holding (stack) to a location (id or name; unknown names are created). Allocation statuses reconcile automatically: s
- `my_circle`: The current user's trade circle: friends, requests_received (waiting for the user: accept_friend or remove_friend), requests_sent (waiting for the friend), each
- `my_swaps`: The current user's swaps with friends: waiting_for_you (proposed to the user: approve or decline with answer_swap), waiting_for_friend (proposed by the user: th
- `offer_swap`: Propose a swap to a FRIEND in the trade circle, from match_circle's rows with that friend: `send` picks rows of you_send and `get` rows of you_get, each by card
- `personal_wantlist`: The personal wantlist: cards the user wants that belong to no deck (add with add_wants without `deck`, change or cut a row with update_want). Per row: wanted, c
- `price_history`: Price over time, from the nightly snapshots Reliquary keeps of every printing it prices (for every printing since November 2026, before that only for owned ones
- `read_handle`: Without `handle`: the current user's own handle (null when they have none) and its public URL. With `handle` ("@name"): the wantlists and tradelists that player
- `read_share_link`: Read someone else's public Reliquary share link — a /s/ or /w/ URL, or the bare token. Returns the list contents with prices plus next_steps for acting on it. T
- `remove_friend`: Remove a friend from the current user's trade circle, decline a request they received, or cancel one they sent — by the other player's handle. `was` says which 
- `remove_holding`: DESTRUCTIVE: permanently delete a holding (the physical cards leave the collection, e.g. sold or traded away). Without confirm:true this only returns a dry-run 
- `replace_card`: Swap one card of a deck list for another, keeping its count and section: the row want_id is cut and `replacement` is added. Typical use: a missing card and a pi
- `revoke_share_link`: Take a share link offline immediately. Accepts the link id, the bare token, or the full /s/ (or legacy /w/) URL. Privacy-restoring, so it needs no confirmation 
- `search_cards`: Find cards in the catalogue of every paper printing — NOT limited to what the user owns (search_collection is that). query is the start of a name ("lightn"), an
- `search_collection`: Search the user's owned cards (holdings) with rich filters. Returns holdings with printing data, physical location, per-deck allocations, free (unallocated) qua
- `set_completion`: Collection completion for one set, optionally one rarity ("Which uncommons from Ravnica Remastered am I missing?" → set "ravnica remastered", rarity "uncommon")
- `set_handle`: Take, change or give up the current user's handle: the name other players type ("@name") to find the wantlists and tradelists this user has PUBLISHED with creat
- `show_buildable_decks`: Use this when the user asks what they can build or play and a ranked list helps: the decks already in Reliquary, most complete first, each with a picture, the s
- `show_buylist`: Use this when the user asks what to buy for a deck (id or name), or for all decks (omit deck), and a table helps: missing cards with count, cheapest non-foil pr
- `show_card`: Use this when the user asks to see a card ("show me Lightning Bolt", "what does Rhystic Study look like?") or to compare a few: up to 8 cards, each drawn with i
- `show_card_location`: Use this when the user asks where a card is and a picture helps: shows each matching card with its image, every stack (how many, in which place, which printing)
- `show_deck`: Use this when the user asks how a deck (id or name) stands and a summary card helps: claimed (and how many of those sleeved), shared, free to claim and missing,
- `sleeve`: Mark a staged allocation as sleeved: the cards physically move into the deck's location (stack splits if partial). allocation_id comes from allocate/deck_status
- `sleeve_deck`: Sleeve everything a deck (id or name) has claimed for itself, in one call: each staged, non-shared allocation becomes sleeved and its copies physically move int
- `unsleeve`: Take a sleeved allocation back out of the deck: status returns to staged and the cards physically move to return_location (id or name, default "Unsorted").
- `update_deck`: Change a deck (id or name): its name, format (commander | pdh (Pauper Commander) | dc (Duel Commander) | standard | pioneer | modern | premodern | legacy | vint
- `update_holding`: Update attributes of one holding (stack) by holding_id (get ids from search_collection/where_is). Changing location is a physical move and reconciles allocation
- `update_want`: Change a deck-list row (want_id from deck_status): its quantity and/or its section (main | sideboard). quantity 0 cuts the card. Cutting a card or lowering its 
- `what_can_i_build`: Rank decks by how completable they are right now (allocated + shared + claimable free cards vs. the full list), optionally filtered by format. completion_pct 10
- `whats_missing`: Cards missing from a deck (not coverable from the collection) with the cheapest cached printing price per card (`cheapest_price`, non-foil, and `cheapest_printi
- `where_is`: Locate a card by name across all holdings. Returns, per stack: physical location (where it is RIGHT NOW), quantity, free (unallocated) copies, and every allocat

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
