{"id":"com.spellbook-finance/mcp","slug":"com-spellbook-finance-mcp","title":"SpellBook Finance","description":"Magic: The Gathering card prices, movers, arbitrage, sealed box EV, and seller inventory tools.","version":"1.0.0","publisher":{"kind":"domain","id":"spellbook-finance.com","label":"spellbook-finance.com","url":"https://spellbook-finance.com"},"website":"https://spellbook-finance.com/agent/mcp.md","repository":"","remotes":[{"type":"streamable-http","url":"https://api.spellbook-finance.com/mcp"}],"packages":[],"published":"2026-09-24","updated":"2026-09-24","status":"online","auth":"","latency_ms":916,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"spellbook_tcg_buyer_driver_status","title":"Read TCGplayer buyer support readiness","description":"Read a seller workspace's paired TCGplayer driver connection, command compatibility, seller binding and independent reply/refund permissions. Call before inspecting a buyer order. A successful inspection establishes portal access at its observation time.","read_only":true},{"name":"spellbook_tcg_buyer_inspect","title":"Inspect a TCGplayer buyer order or thread","description":"Queue an exact TCGplayer order inspection with products, total, refunds and thread summaries. Add a returned threadId to read its messages and prepare a reply. Read spellbook_tcg_buyer_action_status for the verified preview before a write.","read_only":false},{"name":"spellbook_tcg_buyer_reply","title":"Reply to one TCGplayer buyer","description":"Send the seller-authorized exact text to one TCGplayer buyer thread. Requires a verified thread inspection and reply permission. Read spellbook_tcg_buyer_action_status afterward; delivery requires a verified seller message with its provider message ID.","read_only":false},{"name":"spellbook_tcg_buyer_refund_full","title":"Fully refund one TCGplayer order","description":"Issue a seller-authorized full refund for one previously unrefunded TCGplayer order. Requires a verified order inspection and independent full-refund permission. Read spellbook_tcg_buyer_action_status for matching provider refund evidence. This operation sends no separate thread reply.","read_only":false},{"name":"spellbook_tcg_buyer_action_status","title":"Read a TCGplayer buyer action receipt","description":"Read one exact TCGplayer buyer-support command's queue state, provider verification, evidence and missing fields. Call after inspection, reply or refund. Preserve an unknown outcome for reconciliation; an HTTP success or queued state is not delivery.","read_only":true},{"name":"spellbook_riftbound_catalog","title":"Read the Riftbound card catalog","description":"Read up to 20 exact Riftbound printings with collector identity, art-series variant, regular and foil TCGCSV market references, stored price dates and known catalogued sets. Use it for a Riftbound card checklist or set list. Follow nextAfter to page through results. A catalogued count is the number of SpellBook Finance rows, not a publisher total; completeness is unknown. Prices are stored market ","read_only":true},{"name":"spellbook_sealed_shopping_list","title":"Read sealed shopping list","description":"Read a saved sealed shopping list page with exact products, quantities and context. Call before editing; null list means uncreated, while a saved empty list has a header. Follow nextCursor or call spellbook_sealed_shopping_offers for observed offer facts.","read_only":true},{"name":"spellbook_sealed_shopping_list_upsert","title":"Save a sealed shopping line","description":"Save one exact product and its requested quantity, returning the saved line. Call after resolving product identity; an existing line is replaced. Read spellbook_sealed_shopping_list first, then spellbook_sealed_shopping_offers for offer facts.","read_only":false},{"name":"spellbook_sealed_shopping_list_context","title":"Set sealed shopping context","description":"Save destination, market and currency context and return a list header. Call after reading spellbook_sealed_shopping_list; null clears a field and omission preserves it. Call spellbook_sealed_shopping_offers next; destination context does not prove shipping eligibility.","read_only":false},{"name":"spellbook_sealed_shopping_list_quantity","title":"Set sealed shopping quantity","description":"Change one existing sealed shopping line quantity and return the saved line. Read spellbook_sealed_shopping_list first to confirm identity; a missing line returns an error. Call spellbook_sealed_shopping_offers next to read quantity fit.","read_only":false},{"name":"spellbook_sealed_shopping_list_remove","title":"Remove sealed shopping line","description":"Remove one saved sealed shopping line and return a removal receipt. Read spellbook_sealed_shopping_list first to confirm the exact product. A missing line returns an error; read the list again to inspect remaining lines.","read_only":false},{"name":"spellbook_sealed_shopping_list_delete","title":"Delete sealed shopping list","description":"Delete a saved sealed shopping list and return a removal receipt. Read spellbook_sealed_shopping_list first to confirm its contents. A missing list returns an error; a later list read returns null until a list is created again.","read_only":false},{"name":"spellbook_sealed_shopping_offers","title":"Read sealed shopping offer facts","description":"Read a bounded saved-list page with qualified observed offers for each exact product and requested quantity. Call after saving products and context; follow nextCursor for remaining lines. Read quantity fit, destinationStatus, missingFields and limitations before interpreting any subtotal.","read_only":true},{"name":"spellbook_sealed_price_target_create","title":"Create sealed price target","description":"Create a local sealed retailer price target and return its saved status and observed match facts. Call with an exact product and explicit native-currency threshold. Read spellbook_sealed_price_target next; a target records observations without reserving or purchasing products.","read_only":false},{"name":"spellbook_sealed_price_target","title":"Read sealed price target","description":"Read one saved sealed retailer price target, its activation status and observed match facts. Call after creating or changing a target. Use spellbook_sealed_price_target_update to change terms; matching facts do not establish delivery, stock or checkout completion.","read_only":true},{"name":"spellbook_sealed_price_target_update","title":"Update sealed price target","description":"Change a sealed retailer price target's terms and return saved status and match facts. Read spellbook_sealed_price_target first; changing terms rearms observation. Read the target again for current evidence, which can remain unknown until a snapshot is observed.","read_only":false},{"name":"spellbook_sealed_price_target_disable","title":"Disable sealed price target","description":"Disable a sealed retailer price target and return saved status and match facts. Read spellbook_sealed_price_target first to confirm identity. Use spellbook_sealed_price_target_rearm to observe again; disabling never cancels an external purchase.","read_only":false},{"name":"spellbook_sealed_price_target_rearm","title":"Rearm sealed price target","description":"Rearm a sealed retailer price target and return active status with reset match evidence. Read spellbook_sealed_price_target first to confirm identity. Read it again for new observations; rearming does not verify delivery eligibility or purchase anything.","read_only":false},{"name":"spellbook_mtg_pack_simulator","title":"Open a modeled Magic booster pack","description":"Open one reproducible modeled Magic booster pack from an exact parent booster box ID. Omit boxId to discover current candidates for setCode (default fdn). A chosen product returns only the sampled exact printings, modeled finish, nullable USD references, seed, retained model date, missingFields and limitations. Seed is an unsigned 32-bit integer with deterministic default 0. Reusing a seed and unc","read_only":true},{"name":"spellbook_ath_observations","title":"Read Magic ATH observations for seven dates","description":"Read retained Magic card-level high-price detector observations for seven explicit UTC dates and one finish. Use it for which Magic cards hit an all-time high this week. Returns reported USD values, percent-unit changes, catalog-checked Magic labels, publication dates, missing days and coverage limits. Defaults to seven dates ending today and regular finish. Stored ATH state is per oracleId and fi","read_only":true},{"name":"spellbook_guides","title":"Find a task guide","description":"Find a cataloged SpellBook Finance customer-agent guide for seller setup and onboarding, selling, pricing, sealed EV, or choosing a card or sealed-product strategy for a budget and workload. Use it when a customer asks how to make money with Magic, what to do with a bankroll or store credit, whether to open or resell sealed product, or which research route fits their goal. Returns catalog entries,","read_only":true},{"name":"spellbook_skill","title":"Read a task procedure","description":"Read the step-by-step procedure SpellBook Finance wrote for a whole customer task, in full. getting-started takes a new seller from sign-in through supplies, bin labels, a first tracked card, and connected marketplaces. buy-loop covers inspecting buy facts for cards or sealed product and recording what happened. collection-buying covers screening a Marketplace or local Pokémon lot, seller question","read_only":true},{"name":"spellbook_pull_work","title":"Read current pull work","description":"Read a page of SpellBook's current fulfillment work, grouped by marketplace order. Each order carries its tray slot and card lines with bin, printing, condition, and state, including blocked reasons and ship-by evidence when available. Use when a seller asks what to pull or pack. Read spellbook_skill for fulfilling-orders before coaching the workflow; follow nextCursor until hasMore is false befor","read_only":true},{"name":"spellbook_buy_targets","title":"List buy targets","description":"Return a bounded source-order page of materialized TCGplayer-to-Card-Kingdom rows with an opaque nextCursor for complete traversal. Rows include printing identity, observed acquisition and cash quote prices, listed shipping, seller/quantity evidence, exit.quantityBuying (the copies Card Kingdom buys at the quoted price), maxCopies (the smaller of listed stock and exit.quantityBuying), the Card Kin","read_only":true},{"name":"spellbook_buy_outcome_report","title":"Score past buys","description":"Score every closed buy decision in one workspace against its immutable prediction and a fixed equal-weight printing basket. Includes unscored and abandoned counts, missing baseline evidence and small-sample limits. Uses submitted receipts; does not verify merchant orders or money.","read_only":true},{"name":"spellbook_printings_search","title":"Find an exact printing","description":"Find an exact card printing before recording a physical copy or forming a price. Searches by name, and narrows with `set:<code>` plus a collector number in the same query string, for example \"Pikachu set:sv2a 025/165\". Pokemon searches can filter English or Japanese catalog rows. Returns each printing with its product identity, game, language, set code, collector number, rarity and available finis","read_only":true},{"name":"spellbook_movers","title":"Read what is moving","description":"Read published daily/weekly card price movers or supported 30d/90d sealed reports. Returns gainers/losers, reported game/printing/finish when supplied, current and previous USD prices, stored pctChange, swing30d, cardUrl and run/publication dates. Daily/weekly reported percentages and direction lists have producer caps over covered source candidates; read the limits. Capped ties do not identify th","read_only":true},{"name":"spellbook_screener","title":"Screen card prices","description":"Screen Magic card printings by recorded US sales activity, native Cardmarket EUR, regular or foil price, foil/nonfoil premium, consecutive weekly price gains, price change and 20 day band statistics in one call. For unusually high foil premiums, use mode=both and sort=premium with a declared regular-price floor. Premium sorts the dimensionless foilPrice/price multiple; the response retains both US","read_only":true},{"name":"spellbook_buyouts","title":"Read recent buyout observations","description":"Read Magic price-spike observations from SpellBook Finance's buyout detector. Call it when asked which Magic cards are being bought out right now. Returns printing identity, old and new USD prices, fractional pctGain (0.25 means 25%), detection time, secondary-source confirmation, source links and explicit coverage gaps. Read guideResourceUri through MCP for interpretation and stop conditions. If ","read_only":true},{"name":"spellbook_contents_demand","title":"Read recorded demand for exact sealed contents","description":"Read cached exact Commander contents with USD Full EV contributions and source-recorded TCGplayer units. Resolve a numeric product ID with spellbook_sealed_product_search. Returns exact printing/finish, quantities, child membership, baseline 100-unit categories, compatible source-date windows, coverage, revisions, expiry, missingFields and limitations. An EV-weighted mean30d uses only value with a","read_only":true},{"name":"spellbook_commander_case_comparison","title":"Compare a Commander case or display with its decks","description":"Read exact Commander case or deck display membership and USD market-price references for an equivalent set of individual decks. A product named Case or Display, such as Bloomburrow Commander Deck Display, qualifies. Use it to compare that package with its required child quantities. Resolve the numeric case product with spellbook_sealed_product_search first. Returns source-linked recipe counts, cas","read_only":true},{"name":"spellbook_commander_comparison_facts","title":"Read aligned Commander comparison facts","description":"Read stored facts for one to four exact Commander case or deck products on one shared source-date window. Resolve numeric IDs with spellbook_sealed_product_search first. Returns per-product kind, market price and clock, publication revision and readiness, plus contributor rows with finish, quantity, USD Full EV contribution, aligned source-recorded units and missing-versus-zero state, a comparison","read_only":true},{"name":"spellbook_box_ev_history","title":"Read a sealed product's EV history","description":"Read stored daily gross opening-EV observations for one exact sealed product. Use it when asked how a named box's EV changed over time. Resolve the product with spellbook_sealed_product_search first; pass its numeric tcgProductId. Returns product identity, requested dates, USD values per sealed product, dated source rows and explicit model/freshness gaps. Missing dates stay absent. Read guideResou","read_only":true},{"name":"spellbook_box_price_history","title":"Read a box's stored price history","description":"Read dated TCGCSV reference-price observations for one exact sealed box/display and an explicit historical window. Use it for a named box's price change or a retained launch-date baseline. Resolve the numeric product with spellbook_sealed_product_search first. Returns the requested identity, dates, USD Market/Low/Mid when stored, missing dates and unknown clocks. Read guideResourceUri through MCP ","read_only":true},{"name":"spellbook_box_breakeven","title":"Model a sealed product's cash recovery","description":"Read the existing cash-recovery scenario for one exact sealed product and caller-supplied total cost. Use it for modeled after-cost recovery and break-even timing, separately from gross opening EV or a probability of profit. Resolve the numeric product id with spellbook_sealed_product_search first. Returns the supplied assumptions, quantity, model horizon, source coverage, USD results and unknown ","read_only":true},{"name":"spellbook_box_ev_rankings","title":"Read sealed product EV and pack risk","description":"Read a named sealed product's modeled gross contents EV, or compare ranking rows, with totalEV, evRatio, pack standard deviation (packSD), N0 and breakEvenPct. For a named Collector Booster display, use q and box_type, then match boxId to the exact catalog product; a Collector's Edition Commander deck is a different product. Call it for \"how many packs until opening is likely profitable\" (N0), \"ho","read_only":true},{"name":"spellbook_card_prices","title":"Read one card's prices","description":"Read held price snapshots for one printing, each with its own source label, amount and date. Sources can include TCGplayer Market, TCGplayer Low, Card Kingdom retail and buylist, CoolStuff, an eBay 90-day sold median, Cardmarket, ManaPool and CardTrader. Pokemon TCGplayer finish subtypes stay in separate rows. cardId is the exact printing id returned by spellbook_printings_search: a UUID for Magic","read_only":true},{"name":"spellbook_card_buylist","title":"Read one card's dealer offers","description":"Read dealer buy offers for ONE exact card product, preserving each offer's game, finish, subtype, language, condition, source product, source timestamp, cash and credit fields, quantity and missingFields. Use the catalog product id from spellbook_printings_search. Pokemon offers are English NM/New CoolStuffInc observations when present; no offer or missing field proves a dealer has no stock. This ","read_only":true},{"name":"spellbook_card_buylist_history","title":"Read one card's dealer buylist history","description":"Read the stored daily dealer buylist price series for ONE exact printing: one point per day with the Card Kingdom and Cardhoarder buylist price when SpellBook stored one, oldest day first, plus earliestDay, the first day SpellBook holds any stored row for that printing. Use the printing id from spellbook_printings_search. Call spellbook_card_buylist for current offers from every dealer SpellBook r","read_only":true},{"name":"spellbook_card_desk","title":"Read one card's price series, sales and asks","description":"Read one exact Magic printing and finish. Pass treatmentAsks with foil for an etched or special-treatment snapshot. asksTcgplayerProductId identifies its source product. series holds stored TCGplayer Market and Low (tcgLow): daily for the last 90 days, and up to 365 days back. Past 90 days a printing that no seller holds can have one point per ISO week, and limitations says so. buckets holds NM/LP","read_only":true},{"name":"spellbook_pokemon_market_analytics","title":"Read Pokemon market analytics","description":"Read exact identity scoped Pokemon market facts for ONE catalog product: language, finish, condition, independent retail fair value, observed supply depth, versioned SCORE factors and Limitless demand coverage. The response keeps qualified values null when source count or comparable history is missing, and names missingFields and limitations. It reports facts only; it does not rank cards, recommen","read_only":true},{"name":"spellbook_pokemon_ath","title":"Read Pokemon ATH facts","description":"Read the latest Pokemon all-time-high facts for the retained daily snapshot. Rows preserve exact product identity, language, finish, variant, source date, previous ATH and history coverage. This is a facts-only read; unavailable or partial history stays explicit in availability, missingFields and limitations.","read_only":true},{"name":"spellbook_pokemon_arbitrage_spreads","title":"Read Pokemon arbitrage spreads","description":"Read bounded Pokemon acquisition and exit quote facts for exact product identity, preserving quote basis, currency, observation time, source reference, source URLs, comparisons, missingFields and limitations. This read compares observed sources; it does not rank opportunities, recommend a purchase, or execute a transaction.","read_only":true},{"name":"spellbook_deck_contents","title":"Read owned deck cards","description":"Read one authenticated customer's exact owned and draft card contents for a deck. The response preserves game identity, entry ids, matched catalog identity, quantities, membership recovery count and Pokemon readiness checks. It reports facts only and does not edit a deck or infer missing cards.","read_only":true},{"name":"spellbook_deck_import_limitless","title":"Import a Limitless Pokemon deck","description":"Import one player's Pokemon decklist from one fixed Limitless tournament standings record into the seller's workspace. The workspace owner chooses the event, player, format and idempotency key; retries with the same key replay the first result or report an in-progress import. The tool does not accept URLs or credentials and returns source identity, matched and unmatched counts, and the imported de","read_only":false},{"name":"spellbook_pokemon_metagame_overview","title":"Read Pokemon metagame overview","description":"Read observed Pokemon archetype coverage for one format from recent Limitless tournament decklists. The response preserves archetype facts, sample coverage, truncation, missingFields and limitations. It does not measure the whole player population or predict demand.","read_only":true},{"name":"spellbook_pokemon_metagame_archetype","title":"Read a Pokemon archetype","description":"Read observed Pokemon archetype and card facts for one format and exact archetype name from recent Limitless tournament decklists. The response preserves source coverage, card prices, truncation, missingFields and limitations. It reports observations and does not recommend a deck or purchase.","read_only":true},{"name":"spellbook_pokemon_metagame_card","title":"Read Pokemon card metagame facts","description":"Read observed Pokemon card demand facts for one exact catalog product, optionally narrowed to one format. The response preserves exact card identity, sample windows, counts, prices, coverage, missingFields and limitations. It reports observations and does not rank or recommend a card.","read_only":true},{"name":"spellbook_inventory_bin_ensure","title":"Record cards in a bin","description":"Record physically confirmed cards into one inventory bin, by stating the DESIRED TOTAL quantity of each exact printing that belongs in that bin. Existing live copies count toward that total, so only a missing difference is created. Calling it twice with the same numbers creates nothing the second time. Use it for the first cards a seller enters by hand, with no CSV and no scanner. Returns the crea","read_only":false},{"name":"spellbook_inventory_import_csv","title":"Import a ManaBox or TCGplayer CSV","description":"Import a seller's own ManaBox export or TCGplayer inventory export into one workspace, the same import the SpellBook Finance web app runs. The server parses the CSV, resolves each row to an exact printing, preserves mapped location labels or assigns fallback bins, and creates one inventory copy per card. TCGplayer Pokémon and Riftbound rows require the catalog's exact game, provider product identi","read_only":false},{"name":"spellbook_inventory_precon_import","title":"Add a Commander precon, display or case","description":"Add opened Commander precon decks, displays or cases to inventory as individual cards, the same Add Commander deck flow the web app runs. The server reads the cached decklist for that TCGplayer product, splits a display or case into its decks, creates one inventory copy per card at the exact printing, assigns bins, and splits the price paid across the cards. Returns importId, copy count, and bin c","read_only":false},{"name":"spellbook_purchase_incoming_record","title":"Record purchased singles on the way","description":"Record single cards the customer bought on a marketplace that have not arrived yet, one row per exact printing with the quantity and the price paid per copy. Each copy is written as pending receipt under one order, so it counts as incoming and cannot be listed or sold until it is received. Returns the order's acquisitionSource, the copy count, the total cost and the bins the copies will go into. U","read_only":false},{"name":"spellbook_inventory_incoming","title":"Read incoming inventory","description":"Read what a workspace has bought or saved that has not arrived yet, one group per marketplace order or precon deck import. Each group carries its acquisitionSource, a readable title, the copy and card counts, the total cost, the date it was recorded and the bins its copies are assigned to. Call this to answer what is still on the way, or to find the acquisitionSource to receive. It reports pending","read_only":true},{"name":"spellbook_inventory_incoming_receive","title":"Receive incoming inventory","description":"Mark every pending copy in the named orders or precon imports as received, which makes them owned inventory that can be listed and sold. Returns how many copies were received, their total cost and the bins they belong in. Call it when the customer says the package arrived and they counted the cards. Read spellbook_inventory_incoming first to get each acquisitionSource.","read_only":false},{"name":"spellbook_ebay_publish","title":"Publish cards to eBay","description":"Publish owned copies from one workspace as live eBay listings, priced by a stated rule. Pass itemIds to publish one exact card. ALWAYS call it once with dryRun true and show the person the counts and the preflight before calling it again with dryRun false, because a live run creates real listings a real buyer can buy. Pricing anchors on market price, never on what the seller paid: multiplier 0.96 ","read_only":false},{"name":"spellbook_ebay_lot_publish","title":"Publish a deck to eBay","description":"Publish a player-built deck from one workspace as ONE live eBay listing in eBay's player-built decks category. You choose the cards, the title, the summary, the ask and the shipping charge. This tool never suggests a price, ranks cards or picks a deck for you. It reports, per card, how many free near-mint copies the workspace holds and, when deckFormat is set, whether Scryfall lists the card as le","read_only":false},{"name":"spellbook_ebay_reprice","title":"Reprice eBay listings","description":"Preview or reprice existing live eBay listings in one seller workspace using owner-accepted saved rules or a market multiplier and optional floor. Read spellbook_agent_pricing_protection first. A workspace in saved_rules_only mode requires pricing saved_rules; the server uses its accepted rules. This is a one-run marketplace override: it changes current eBay asks, creates no listing, and saves no ","read_only":false},{"name":"spellbook_ebay_unpublish","title":"End eBay listings","description":"End the live eBay listings for up to 25 exact copies, and keep each copy in inventory so it can be published again. Take Item ids from spellbook_inventory_items_query. Show the person which cards will come down and get a yes before calling, because a live listing ends at once. Returns one result per copy: unpublished, kept, no_listing, or failed.","read_only":false},{"name":"spellbook_ebay_job_status","title":"Read an eBay bulk job","description":"Read one eBay bulk job by the jobId returned from spellbook_ebay_publish or spellbook_ebay_reprice. Both operations queue work, so call this before telling the person a listing was created or its ask changed. State planning, pending, uploading, processing or ingesting means the job is still running: call again after about a minute. State failed carries errorMessage, and each failures row carries a","read_only":true},{"name":"spellbook_manapool_sync_preview","title":"Preview a ManaPool sync","description":"Compare one workspace's inventory against what is live on ManaPool, and return the exact changes a sync would make. Every action is listed with its kind: upsert to create or change a listing, delist to remove one, blocked where a cross-channel check refused it. Nothing is sent to ManaPool by this call. Show the person the summary and the counts, then call spellbook_manapool_sync_apply with the pre","read_only":true},{"name":"spellbook_manapool_sync_apply","title":"Apply a ManaPool sync","description":"Send a previewed batch of changes to ManaPool, creating, repricing and removing real listings. Takes the previewToken from spellbook_manapool_sync_preview, which must still be valid. Applies at most maxActions in one call and returns remainingActionCount with nextActionCursor, so a full book takes several calls. Show the person the preview before the first call, not after.","read_only":false},{"name":"spellbook_marketplace_listings_adopt_preview","title":"Preview marketplace listing adoption","description":"Read the live listings on the workspace's connected eBay, TCGplayer or ManaPool account and preview how each one maps to an exact printing, without changing the marketplace or inventory. Omit previewId to start a read. The read runs in the background, so the first answer has status queued or reading. Call again with previewId latest until status is ready. A ready preview lists adoptable listings w","read_only":false},{"name":"spellbook_marketplace_listings_adopt_apply","title":"Adopt marketplace listings","description":"Adopt the listings in a ready preview from spellbook_marketplace_listings_adopt_preview. Each remote copy is linked to an owned item or gets a new item in the channel's import bin (EBAY-IMPORT, TCG-IMPORT or MANAPOOL-IMPORT), and the listing is recorded as managed by SpellBook. Each adopted printing gets an exact price lock at its live price. Nothing on the marketplace is edited, ended or relisted","read_only":false},{"name":"spellbook_sealed_listing_preview","title":"Preview a sealed listing","description":"Preview one sealed listing on ManaPool or TCGplayer without publishing. Returns the proposed quantity and ask, any current offer, TCG publisher readback state, stock and intent revisions, and blockers. For TCGplayer, the first call may queue an exact seller-grid SKU read; call again after the paired extension finishes. After submitting, call preview again: publisher.state live confirms an offer, a","read_only":true},{"name":"spellbook_sealed_listing_submit","title":"List sealed product","description":"Submit one sealed product listing to ManaPool or TCGplayer at the exact quantity and ask shown by spellbook_sealed_listing_preview. Pass the same channel and product arguments, plus proposed.stockRevision, proposed.askUsd, and intentRevision unchanged. ManaPool submits directly. TCGplayer queues the paired browser writer. A queued TCG write is pending until an exact seller-grid readback confirms i","read_only":false},{"name":"spellbook_sealed_listing_pause","title":"Remove a sealed listing","description":"Remove one SpellBook-managed sealed listing from ManaPool or set its TCGplayer quantity to zero through the paired browser. Call spellbook_sealed_listing_preview first and pass its channel and intentRevision unchanged. A product with no saved SpellBook intent cannot be removed by this tool.","read_only":false},{"name":"spellbook_tcg_listing_preview","title":"Preview a TCGplayer listing run","description":"Show which cards in one workspace would be listed on TCGplayer, and at what price, without changing anything. TCGplayer has no server-side publish, so the real path is a CSV a person uploads to the TCGplayer portal. Call this first and show the person the candidates and the totals, then call spellbook_tcg_listing_export only once they have agreed to upload the file.","read_only":true},{"name":"spellbook_pokemon_tcg_staged_preview","title":"Preview exact Pokemon TCG rows","description":"Preview the TCGplayer CSV rows for 1 to 25 exact Pokemon inventory copies. Call this after the seller selects the copies. Returns staged-preview rows and CSV, plus excludedCount and excluded for copies left out. It queues nothing, publishes nothing, and offers no export follow-up.","read_only":true},{"name":"spellbook_tcg_listing_export","title":"Export a TCGplayer upload CSV","description":"Produce the CSV a person uploads to the TCGplayer portal, and mark those copies as listed in SpellBook. Call it only after spellbook_tcg_listing_preview and only once the person has said they will upload the file. Hand them the CSV and tell them plainly that SpellBook now believes these copies are listed, so the upload has to happen.","read_only":false},{"name":"spellbook_manapool_connection_status","title":"Check your ManaPool connection","description":"Check whether this signed-in customer's ManaPool seller account is connected to SpellBook Finance. Call this before requesting a setup link and again after the seller finishes the setup form. It returns a masked account identifier and stored connection timestamps. If connected is false, call spellbook_manapool_connect_link.","read_only":true},{"name":"spellbook_manapool_connect_link","title":"Get a ManaPool setup link","description":"Get the SpellBook Finance page where the seller connects ManaPool, and guide them through it. Call spellbook_manapool_connection_status first. Save the seller's return address with spellbook_return_address_save before you hand over the link, because the page fills ManaPool's tax address from it. Hand the seller only this one link. The page itself links to ManaPool's token page, where a seller with","read_only":true},{"name":"spellbook_item_photo_upload_link","title":"Get a photo upload link for one card","description":"Get a link where the seller uploads their own phone photos of the front and the back of one inventory copy, so the next eBay listing shows that exact card beside catalog art. Use it when the seller wants buyers to see the real card, when a buyer asks to see the back, or when catalog art is wrong or missing. Take itemId from spellbook_inventory_items_query or spellbook_inventory_holdings. Give the ","read_only":true},{"name":"spellbook_ebay_connection_status","title":"Check your eBay connection","description":"Check whether this signed-in customer's eBay seller account is connected to SpellBook Finance. Call this before requesting a connect link and call it again after the seller approves eBay consent. It returns the stored account identity and token state plus current eBay seller-registration and selling-limit facts. If connected is false and account is null, call spellbook_ebay_connect_link. If status","read_only":true},{"name":"spellbook_ebay_shipping_policy_get","title":"Read eBay shipping policy","description":"Read the caller's connected eBay shipping charges and provider readback. workspaceId proves the caller owns a SpellBook workspace; eBay settings remain scoped to that caller's connected eBay account. Read this before changing shipping charges.","read_only":true},{"name":"spellbook_ebay_shipping_mode_get","title":"Read eBay shipping mode","description":"Read the shipping-mode preference saved for the caller's connected eBay account and whether a delegated agent last set it. workspaceId proves owner access only; the preference is account-scoped.","read_only":true},{"name":"spellbook_ebay_shipping_mode_set","title":"Set eBay shipping mode","description":"Save the seller-selected shipping mode for the caller's connected eBay account, then return the saved preference. Read spellbook_ebay_shipping_mode_get first; call spellbook_ebay_shipping_policy_set separately to configure charges. This can affect future listing and repricing work across the account's workspaces.","read_only":false},{"name":"spellbook_ebay_shipping_policy_set","title":"Set eBay shipping charges","description":"Set a package flat shipping charge and optionally an envelope charge on the caller's connected eBay account, then return provider readback. Read spellbook_ebay_shipping_policy_get first; omitting the envelope amount preserves its current charge. workspaceId is checked for owner access; the connected account belongs to the caller.","read_only":false},{"name":"spellbook_ebay_combined_shipping_get","title":"Read eBay combined shipping","description":"Read the caller's connected eBay combined-shipping profile and promotional shipping rule, including its provider type, amount threshold or maximum order cost, and configuration status. Call spellbook_ebay_combined_shipping_set after reviewing it. eBay checkout may still require multiple items for an amount-threshold offer; use eBay Seller Hub Shipping discounts when a minimum amount must qualify o","read_only":true},{"name":"spellbook_ebay_combined_shipping_set","title":"Set eBay combined shipping","description":"Set the caller's connected eBay combined-shipping charge and optional amount-threshold offer or maximum shipping cost per order, then return Account API readback. Read spellbook_ebay_combined_shipping_get first. Configure an amount-only single-item Shipping discount separately in Seller Hub.","read_only":false},{"name":"spellbook_ebay_order_discount_get","title":"Read eBay order discount","description":"Read the caller's tracked eBay order-discount promotion, including store or lot scope, quantity threshold, percentage, status and dates. workspaceId is checked for owner access; the promotion belongs to the caller's connected eBay account.","read_only":true}],"server_info":{"name":"spellbook-finance","title":"SpellBook Finance","version":"0.1.0"},"category":"ecommerce","tags":["finance","analytics","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-24","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-spellbook-finance-mcp/"}