Tools & limits

The server exposes 32 tools: 17 that read, 13 that write and 2 that remove or delete. Most tools group related operations as actions: one tool reads a deck's cards, its value or what you still need, another adds cards to a deck or sets a count. Your assistant picks the tool and the action from what you ask.

The full interactive reference lives at silvane.app/mcp.

The older tool names

Until October 2026 the server listed 90 tools, one per operation, such as add_deck_cards or card_price_history. Each one is now an action of a newer tool. An assistant that still has the old list keeps working: the old names still answer, without being listed, while assistants move to the new list.

• Claude and Claude Code read the list again when a new conversation starts.
• ChatGPT keeps the list it read when you connected. To load the new one, open the Silvane app in ChatGPT's settings and choose Refresh.

Prices through MCP

Every tool that returns an amount answers in your active price source — and declares which source and currency the numbers are in, so your assistant can say "that's the Cardmarket trend price, in euros" instead of guessing. Amounts stay in the market's currency, USD or EUR; your display currency does not apply here. Two of the exceptions show up here:

• The Ledger answers from its own recorded prices — a sale or purchase line is the record of the deal, not a market quote, so those numbers never move with your source.
• Views with a pinned price filter filter in the view's source, so the assistant sees the same card list you and every other viewer do.

One tool answers in every source at once: comparing prices. Ask "where is this cheapest" or "what would Card Kingdom pay for these" and the assistant gets each card's price in all five sources — TCGplayer, Cardmarket (in euros), Card Kingdom, Mana Pool and Star City Games — plus the Card Kingdom and Star City Games buylists, for up to 100 cards at a time. A store with no price for a card is left out rather than shown as zero.

Adding cards in bulk

Cards go in and out a list at a time, not one at a time — a whole decklist or a whole haul is a single call, so an assistant can finish it in one turn instead of stalling halfway through a hundred cards.

Because most playable cards have dozens of printings, the printing is chosen for you rather than asked about. You can say which rule to use:

• The one you already own, else the cheapest — the default for decks and sales.
• The cheapest — the default for binders, lists and purchases.
• The newest — the most recent reprint.

Just say which you want ("use the cheapest printings") and the assistant passes it through. A card asked for in another language lands on that language's printing of the chosen set and number when one exists, and otherwise on the chosen printing, held in that language. To pin an exact printing, give its set and collector number the way a decklist writes it — 1 Sol Ring (LTC) 284 adds that Sol Ring and no other; if that set and number don't exist, the card is reported back instead of swapped for another printing. Names it cannot match are reported back individually and never stop the rest of the list.

A new deck's commander pins the same way: its set and collector number give that printing. If the number belongs to another card than the one you name, the deck is not made. A commander named alone that has several printings comes back as a list of its printings to choose from.

Precons through MCP

Ask for a preconstructed deck by its name or its commander — "add my Heavenly Inferno precon", "I own the Kaalia deck" — and the assistant copies it from the precon library in one step: every card in the printing, finish and quantity the product shipped with, and its commander. Say you own it and the deck is tracked, so its cards count as yours. When a name fits more than one product (a deck reprinted in an anthology, say), the assistant asks which one. A precon is not added under a deck name you already have unless you ask for a second copy or give another name. The Free plan's deck limit applies.

Deck links

Paste a link to a public deck on Moxfield, Archidekt, MTGTop8, TappedOut, TCGplayer or ManaBox and the assistant reads it without saving anything: the deck's name and format as the site states them, its commanders, every card matched to Silvane's catalog, its value in your price source, and for each card how many copies you own and how many are free to use. It then asks what you want: talk about the deck, save it as a deck (the same import as the app's link import), or add its cards to one of your binders or lists, such as a wishlist. Nothing is saved until you say so, and the Free plan's limits apply to what is saved. A private or deleted deck can't be read.

A silvane.app link works the same way: a binder or list, a deck, a precon or meta deck, a Secret Lair drop, a saved view, a profile or its For Trade and Wants pages. The assistant sees what any visitor sees. For a deck, precon or Secret Lair it also lists what you still need to build it and what that costs; for a binder, list, view or For Trade page it can say which of your decks need the cards there. A private or deleted page answers like a mistyped link.

Folders through MCP

Ask "what folders do I have" and the assistant gets your folders — binder folders, list folders, deck folders, view folders and watchlist folders — with how much each holds, and how many binders, lists, decks, views and watched cards sit in no folder. Binder, list, deck and view folders come as a tree: each one with the folder it is inside, its path (Sealed Precons / Secret Lair), its level, and how much it holds with everything under it.

The whole tree comes as counts, 100 folders to a page. Ask "which binders are in my Secret Lair folder" and the assistant asks for that one folder and what is inside it, with the names of what each holds (up to 100 per folder).

From there it can reorganize:

• Create, rename and delete binder, list, deck and watchlist folders. A binder, list or deck folder can be created inside another one of its kind, three levels deep.
• Move a folder into another folder of its kind, or back to the top, with everything inside it. A move that would pass three levels, put a folder inside itself, or put a list folder in a binder folder is refused with the reason, and nothing changes.
• Move many at once — "put all my Secret Lair binders in the Secret Lair folder" is one request for up to 200 binders, lists or decks. Anything it could not place (a name that matches nothing, or two names alike) is reported back one by one, and the rest still move.
• List what one folder holds, with or without the folders inside it, or what is in none.

A binder, list or deck folder is named by its name, by its path when two share a name (Precons / Commander), or by its id. A folder holds one kind: binders go in binder folders, lists in list folders. A list sent to a binder folder is reported back, not moved. When a name is not found among deck folders but a binder or list folder has it, or the reverse, the answer says which kind has it.

Deleting a binder, list or deck folder keeps what was inside it: its binders, lists or decks and the folders inside it move up one level, into the folder it was in or to the top. Deleting a watchlist folder removes the cards watched in it.

View folders are listed, and one asked for by name comes with its views. Creating, renaming, moving and deleting view folders, and moving views between them, stay in the app and on the web.

On the Free plan the folder limits are the app's: 2 binder folders, 2 list folders, 1 deck folder and 1 view folder, and a folder inside a folder counts toward the limit like any other folder. The assistant sees how many you have used before it tries to create one.

A deck's cover image

Ask to change a deck's image — "use Kaalia's art on my Angels deck" — and the assistant sets the deck's cover to that card's art. The cover is always the art of a card: name the card, or give a set and collector number for one exact printing's art, or ask for the commander's art again. A picture of your own cannot be uploaded. It works on every deck you have, including one added from a precon.

What counts as yours

The assistant counts your cards the way the app does:

• Owned is every copy you have — in binders and in tracked decks, commanders included.
• Available is what is free in your binders; the copies in tracked decks are in use there.
• Missing for a deck is what your binders don't cover. A tracked deck has nothing missing — its cards are already yours. Cards you hold in another tracked deck are reported as in use there, not as cards you lack.

Cards in lists never count. Proxies and cards with Tracked off are never reported missing.

The Ledger through MCP

You can keep both sides of your Ledger from the conversation. On the sell side: record who bought what and for how much, correct a price after the fact, mark a sale paid or delivered, and group an afternoon's sales into a batch. On the buy side: record purchases with their vendor, shipping, fees and discounts, and walk each order through ordered, paid and received. A line keeps the copies' language: Spanish copies of a printing Scryfall lists only in English are recorded as Spanish. And across both, the ledger's summary and top sets answer the money question the app's Overview answers — what came in, what went out, and where it moved.

Every summary follows the hub's rule: only orders marked paid count as money — what you're owed, and what you've committed but not paid, are reported apart, never folded into revenue or spend.

You can also hand a buyer their receipt link from the conversation. Publishing is always an explicit step: asking for a sale's link mints it and leaves it off, so nothing becomes readable until you say to turn it on — and the same call switches it back off.

Sales and purchases, unlike cards and decks, are deleted permanently: deleting one is permanent.

Date added

Ask "what did I add this week" and the assistant lists your cards newest first, or only those added between two dates, in your whole collection or in one binder. A card's date is the day it first went into that binder or tracked deck in that printing, condition and language. More copies added later to a card you already had keep the first date, so they don't show up as new.

Prices on a past date

The assistant can price up to 500 cards, or a whole binder or list, on one past date in the price source you choose: "what was this purchase worth on September 12". A card with no price that day takes the latest price from the 7 days before, and the answer says so; with none in that week it has no price. The answer counts how many cards had a price that day, how many took an earlier one and how many had none. On the Free plan the date can be up to 90 days back.

Moving and editing many copies

In one request the assistant can move or copy cards from one binder or list to another, or change their language, condition or for-trade mark. It picks the copies by name, by the same filters as a collection search ("every card over $20"), or all of them. These are the same changes as the bulk Move and Edit in the app.

• A move keeps each copy's purchase price, notes, for-trade mark, date added and tags. A whole finish moves: to move 2 of 4 copies, set the count first.
• A copy adds the cards to the other binder with their tags, without purchase price, notes or the for-trade mark.
• A language or condition change: a new language moves each copy to that language's printing of the same set and number when there is one, otherwise the copy keeps its printing and records the language. The old entry's notes and date added are not carried over and can't be restored from Recently deleted, so the assistant tells you before it edits copies that have notes.

For a large change the assistant can first show what would change, without changing anything.

Legality and Commander bracket

Ask "is my deck legal" or "what bracket is my deck" and the assistant gets the same verdict the app and the deck Studio show, from the same engine. It checks Commander, Modern, Standard, Pioneer, Legacy and Vintage: deck and sideboard size, copy limits, banned and not-legal cards, and for Commander the commander, partner pairs and color identity. Each problem comes with the card it concerns, when there is one.

For Commander it also gives the bracket shown in Silvane (the higher of the calculated bracket and the one you chose), the Game Changers, mass land denial and extra-turn cards it found, and why the deck can't be in a lower bracket. It can check a deck against another format ("would this be legal in Modern?") or a list that isn't a deck yet, such as one read from a link.

Test hands and draw odds

The assistant can deal games from one of your decks with Silvane's playtest engine: the opening seven, what you draw each turn, and London mulligans (the first is free in Commander). Each game has a seed, so it can show the same game again or the next hand after one more mulligan. It only deals and draws; nothing is played. On the Free plan a game stops at turn 2.

It can also work out a deck's odds exactly: how many lands in the opening seven, hitting each land drop, enough sources of each color by each turn, and drawing a card you name by a given turn. How often the deck keeps 7, 6 or 5 cards is simulated, and the answer says which figures are exact and which are simulated. The deck is the mainboard; the commander starts in the command zone, and the sideboard and Considering stay out.

The Tray

The Tray is the staging basket the app and the web share. The assistant can read it, stage cards in it, change a staged card's count, finish, condition, language or printing, remove rows, and file the whole Tray into one binder, list, deck, sale or purchase, the way the Tray's Add button does. What could not be filed stays in the Tray with the reason. A deck keeps each card's printing, finish and count, not its condition or language. A Tray row holds up to 999 copies, and the Tray up to 10,000 rows.

How much one call may carry

A tool call is capped so a single request cannot run away:

Larger jobs are split across calls, and a longer list comes in pages; the assistant does both on its own. It can ask for decks, binders or lists by name.

Quotas and Pro through MCP

MCP follows the same rules as the app:

• Free quotas apply — if your free account has 3 binders, asking for a 4th is rejected with a clear message, exactly like in the app.
• Pro gates apply — Pro-only data (for example price-history ranges beyond 90 days) stays Pro through MCP.
• The Ledger is Pro — the Ledger tools are listed for every account, and reading or recording sales and purchases requires Silvane Pro, exactly as the Ledger hub is in the app.
• Free limits on the newer reads — test games stop at turn 2, and prices on a past date reach back 90 days.
• Reading your collection is always free — loading your cards into Claude or ChatGPT is never paywalled.