com.spellbook-finance/mcp

Est-ce que com.spellbook-finance/mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.spellbook-finance/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 136 outils

• spellbook_agent_gap_report≈ 920 tokens

  After finishing the task, ask the person whether they consent to send one bounded capability-gap report to SpellBook. Call this tool only after an explicit yes for this report and set consentToShare to true. Use it when a needed field was null, you guessed a number because no tool supplied it, you wished a tool existed, or you abandoned a path. It returns no task data and fixes nothing. Generate a fresh ULID submissionId and reuse the exact request for retries within 24 hours. Field paths must be real SpellBook response paths. There is no free-text field: never describe the card, price, customer, or conversation.

  Paramètres, retour & exemple (9)

  Paramètres

  • outcome · string · requis · completed | completed_with_guess | abandoned
    What happened to the task: closed enum. Required.
  • occurredAt · string · requis
    ISO-8601 timestamp of when the gap occurred. Required.
  • neededFields · array · requis
    Real SpellBook response field paths that were null or missing when needed. Omit or send empty when none applied.
  • submissionId · string · requis
    A fresh ULID for this report. Reuse the exact same value and request body to retry within 24 hours; a new value starts a new report.
  • taskCategory · string · requis · valuation | sell_decision | portfolio_review | acquisition | inventory_placement | other
    Which closed task category this gap happened in. Required.
  • abandonReason · string · optionnel · field_was_null | data_too_stale | no_matching_rows | identity_ambiguous | access_denied | tool_error | no_such_capability | too_many_steps
    Why the task was abandoned. Required only when outcome is abandoned.
  • guessedFields · array · optionnel
    Real SpellBook response field paths the agent had to guess a value for because no tool supplied one. Omit when nothing was guessed.
  • consentToShare · boolean · requis
    True only after the person explicitly agreed to send this specific report.
  • wishedCapability · object · optionnel
    A capability the agent wished existed and did not find. Omit when no capability was missing.

  Exemple d'appel

  {"name": "spellbook_agent_gap_report", "arguments": {"outcome": "completed", "occurredAt": "texte", "neededFields": [], "submissionId": "texte", "taskCategory": "valuation", "consentToShare": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_agent_pricing_protection≈ 222 tokens

  Read a workspace's saved-rule pricing authority before an eBay reprice. Returns current and accepted eBay rules, mode, source-change acceptance requirement, unresolved submission evidence, missingFields and limitations. Settling means earlier admitted marketplace writes may still finish. Only the owner can accept rules through the web app.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_agent_pricing_protection", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_alert_create≈ 901 tokens

  Create one alert in a workspace and return the saved alert. alertType buylist_watch watches dealer buy offers for the whole inventory (buylistWatchScope inventory) or for one printing and finish (buylistWatchScope card); buylistWatchCondition crossed also needs direction and threshold in USD. Every other alertType watches one card or box and needs assetType, assetKey, assetName, isFoil, direction and threshold. Sending the same alert twice returns the first one with replayed true and creates nothing. Call spellbook_alerts_list first to see what exists.

  Paramètres, retour & exemple (13)

  Paramètres

  • finish · string · optionnel · nf | fo | etched | surge | rh | 1e | 1e-fo
    The finish to watch, matching the finish codes spellbook_printings_search returns. Required for a buylist_watch with scope card.
  • isFoil · boolean · optionnel
    Whether the watched card is foil. Required for every non-buylist_watch type.
  • assetKey · string · optionnel
    The printing id for a card or the product id for a box. Required for every non-buylist_watch type.
  • alertType · string · requis · price | metagame | supply_signal | eu_spread | buylist_spread | buylist_vs_cost_basis | spread_compression | fair_value_divergence
    The kind of alert. buylist_watch watches dealer buy offers against inventory or one printing. Required.
  • assetName · string · optionnel
    A display name for the watched asset. Required for every non-buylist_watch type. Optional for buylist_watch.
  • assetType · string · optionnel · card | box
    Whether the alert watches a card or a sealed box. Required for every non-buylist_watch type.
  • direction · string · optionnel · above | below
    Whether the alert fires when the price is above or below threshold. Required for crossed and for every non-buylist_watch type.
  • threshold · number · optionnel
    The USD price the alert compares against. Required for crossed and for every non-buylist_watch type.
  • scryfallId · string · optionnel
    The exact printing id from spellbook_printings_search. Required for a buylist_watch with scope card and for a card alert.
  • workspaceId · string · requis
    The workspace the alert belongs to, from spellbook_workspaces_list. Required.
  • buylistVendor · string · optionnel
    For buylist_watch: the dealer to watch, as SpellBook stores the vendor name. Omit to watch Card Kingdom.
  • buylistWatchScope · string · optionnel · inventory | card
    For buylist_watch: inventory watches every sellable item in the workspace, card watches one printing and finish. Required for buylist_watch.
  • buylistWatchCondition · string · optionnel · buying_again | crossed
    For buylist_watch: buying_again or crossed. crossed also needs direction and threshold. Required for buylist_watch.

  Exemple d'appel

  {"name": "spellbook_alert_create", "arguments": {"alertType": "price", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_alert_delete≈ 233 tokens

  Delete one saved alert by exact alertId, taken from spellbook_alerts_list, and return success. The alert stops watching at once. Read the list first and confirm with the person which alert to remove, because this tool cannot restore it.

  Paramètres, retour & exemple (2)

  Paramètres

  • alertId · string · requis
    The alertId of the alert to delete, from spellbook_alerts_list. Required.
  • workspaceId · string · requis
    The workspace the alert belongs to, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_alert_delete", "arguments": {"alertId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_alerts_list≈ 384 tokens

  Read every price alert and buylist watch saved in one workspace, one row per alert with its type, asset, direction and threshold when it has them, status, trigger fields and last matched keys. Filter by status or alertType. Call it before spellbook_alert_create to see what the seller already watches, and use the alertId on a row with spellbook_alert_delete. It reports saved alerts and does not evaluate them or say whether a price would trigger one today.

  Paramètres, retour & exemple (3)

  Paramètres

  • status · string · optionnel · active | triggered | disabled
    Return only alerts in this status. Omit to include every status.
  • alertType · string · optionnel · price | metagame | supply_signal | eu_spread | buylist_spread | buylist_vs_cost_basis | spread_compression | restock
    Return only alerts of this type, such as buylist_watch. Omit to include every type.
  • workspaceId · string · requis
    The workspace whose alerts to read, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_alerts_list", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_box_ev_rankings≈ 1154 tokens

  Read sealed-product EV rankings with each box's modeled total EV, evRatio, pack standard deviation (packSD), N0 and breakEvenPct, defaulting to the highest evRatio first. Call it for "how many packs until opening is likely profitable" (N0), "how swingy is this box" (packSD, and swinginess, which is packSD divided by packEV) and "what share of packs beat the pack price" (breakEvenPct). N0 is the number of packs at which a normal approximation, treating packs as independent and identical, gives about a 97.7% modeled probability that summed gross card market value exceeds summed pack cost. It is null when per-pack edge is zero or negative. Pack cost is packPrice, the box market price divided by packsPerBox. Each N0 variant uses its own valuation basis, with its own pack SD and edge: n0Full uses full market value (packSD, fullEdge), n0LandAdjusted prices cheap lands at bulk rates (landAdjustedPackSD, landAdjustedEdge), and n0Sellable prices cards below a threshold at bulk buylist rates (sellablePackSD, sellableEdge). All values are gross market value before selling fees, shipping and liquidity. breakEvenPct is the share of simulated single packs worth at least packPrice. It is not the probability of profit after N packs. Rows also carry exact product IDs, market prices, the acquirableFloorUsd and evRatioBasis behind the stored EV ratios when present, market-basis ratios, market-price spreads, shipping-aware ratios, per-pack metrics and row timestamps. evRatio is totalEV divided by max(marketPrice, the cheapest captured TCG listing price plus shipping) on rows with a known basis; evRatioMarketBasis preserves the market-price comparison. spreadUsd is totalEV minus marketPrice, so it is a separate comparison. typicalEV is the box EV with every card under typicalEvCutoffPerPack (a pull probability of 0.001 per pack) left out, and typicalEvExcludedCount is how many cards that dropped; typicalEV is null when the model cannot compute it, with typicalEvReason saying why. Sort by n0Full, n0LandAdjusted or n0Sellable to order boxes by packs needed. Call spellbook_sealed_product_offers with a row's boxId for store offers on that product. This is modeled research evidence for a caller's decision, not a purchase instruction.

  Paramètres, retour & exemple (9)

  Paramètres

  • q · string · optionnel
    Free-text filter on product name. Omit to include every product.
  • game · string · optionnel · mtg | riftbound | pokemon
    Restrict rankings to one game. Omit for the mixed supported-game ranking. A registered game without production EV returns an empty ranking plus sealedIntelligence.reason and missingFields.
  • sort · string · optionnel · evRatio | totalEV | spreadUsd | marketPrice | packEV | packEvRatio | packPrice | n0Full
    Which computed field ranks the rows. Defaults to evRatio, the stored totalEV ratio using acquirableFloorUsd when its basis is known; use spreadUsd for totalEV minus marketPrice. n0Full, n0LandAdjusted and n0Sellable rank by packs needed under that valuation basis. A null sort value, a preorder row and an unverified row come after the other rows in either direction.
  • limit · integer · optionnel
    Maximum rows to return, 1 to 150. Omit for the default of 50.
  • cursor · string · optionnel
    Opaque nextCursor from a previous page, passed back unchanged. Omit to start from the first page.
  • box_type · string · optionnel
    Exact box-type name to filter to one sealed product line. Omit to include every box type.
  • sort_dir · string · optionnel · asc | desc
    Sort direction for `sort`. Defaults to desc, highest first. Pass asc with an n0 sort to list the fewest packs first.
  • max_price · number · optionnel
    Maximum market price a row may have to be returned. Omit for no ceiling.
  • min_ev_ratio · number · optionnel
    Minimum stored evRatio a row must have to be returned. Rows with a null ratio are excluded. Omit for no floor.

  Exemple d'appel

  {"name": "spellbook_box_ev_rankings", "arguments": {"q": "texte", "game": "mtg", "sort": "evRatio", "limit": 1, "cursor": "texte", "box_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_buy_outcome_report≈ 210 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspaceId to score, from spellbook_workspaces_list. Required; this scores exactly one workspace.

  Exemple d'appel

  {"name": "spellbook_buy_outcome_report", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_buy_targets≈ 462 tokens

  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 Kingdom condition ladder (NM/EX/VG/G payouts, modeled from the NM quote), timestamps, printingMismatches and missingFields. Call this first when a person says "I have $X to risk", "find me opportunities", "good opportunities", "single cards", "high risk singles", "start with arbitrage" or "what should I buy". Never request more copies of a row than maxCopies. Before handing a person a buy list, record each chosen row as a consideration with spellbook_customer_evidence_record, because spellbook_buy_outcome_report scores only recorded considerations. No profit, ranking, selection, reserves or cost defaults. Exact listing links and fee amounts are null when unavailable. Customer agent supplies all policy and executes purchases.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum buy-target rows to return, 1 to 200. Omit for the default of 200.
  • cursor · string · optionnel
    Opaque nextCursor from a previous page, passed back unchanged to continue traversal. Omit to start from the first page.

  Exemple d'appel

  {"name": "spellbook_buy_targets", "arguments": {"limit": 1, "cursor": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_buylist_compare≈ 367 tokens

  Read one page of a workspace's sellable inventory, one group per printing, finish and condition, with the per-unit net at each of seven destinations: Card Kingdom cash, Card Kingdom credit, Star City Games cash, ManaPool, TCGplayer, TCGplayer Direct and eBay. Each destination carries gross, fees, net, price source, observation time, vendor minimum, quantity the vendor is buying and a skip reason when it has no usable price. Pass nextCursor back to read the next page. It lists every destination in a fixed order and does not rank them, name a best one or say what to sell.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum groups to return, 1 to 500. Omit for the server default.
  • cursor · string · optionnel
    Opaque nextCursor from a previous page, passed back unchanged. Omit to start from the first page.
  • workspaceId · string · requis
    The workspace whose inventory to compare, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_buylist_compare", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_card_buylist≈ 250 tokens

  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 returns facts and does not choose a vendor or sell cards.

  Paramètres, retour & exemple (1)

  Paramètres

  • cardId · string · requis
    The exact printing or catalog product id from spellbook_printings_search. Required.

  Exemple d'appel

  {"name": "spellbook_card_buylist", "arguments": {"cardId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_card_buylist_history≈ 296 tokens

  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 reads. This read returns facts; it does not choose a vendor, judge a price or sell cards.

  Paramètres, retour & exemple (2)

  Paramètres

  • days · integer · optionnel
    How many days back to read, 1 to 180. Omit for the longest window SpellBook returns.
  • cardId · string · requis
    The exact printing id from spellbook_printings_search. Required.

  Exemple d'appel

  {"name": "spellbook_card_buylist_history", "arguments": {"cardId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_card_prices≈ 390 tokens

  Read every price source SpellBook Finance holds for ONE printing, one row per source, each with its own label, price and timestamp. 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, or a catalog product id for Riftbound or Pokemon. Rows come back in source order with their own timestamps; nothing is averaged, ranked, or chosen for you, and no listing link is returned.

  Paramètres, retour & exemple (2)

  Paramètres

  • cardId · string · requis
    The exact printing id from spellbook_printings_search: a UUID for Magic, or the namespaced catalog product id for Riftbound or Pokemon. Required.
  • finish · string · optionnel · nonfoil | foil | etched
    Which finish of a Magic printing to price. Omit for nonfoil. Pass foil or etched when the copy in question is foil or etched, because a foil copy often sells at a different price. Riftbound and Pokemon ignore it and return every finish as its own rows.

  Exemple d'appel

  {"name": "spellbook_card_prices", "arguments": {"cardId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_channel_lane_set≈ 395 tokens

  Set one workspace's lane mode for one channel-lane marketplace, the switch that decides whether SpellBook reads the marketplace or changes listings there. This changes public marketplace behavior for the workspace, only the workspace owner may call it, and the agent sets a mode only after the seller chose one. It returns the same lane state as spellbook_marketplace_onboarding. The modes: off: the lane is disabled and SpellBook neither reads nor changes the marketplace. observe: SpellBook reads the marketplace and records whether it matches SpellBook's desired state, and never changes a listing there. push: SpellBook creates, updates, and removes listings on the marketplace to match its desired state.

  Paramètres, retour & exemple (3)

  Paramètres

  • mode · string · requis · off | observe | push
    The mode the seller chose: off, observe, or push. Required.
  • marketplace · string · requis · cardtrader | ebay | manapool | misprint | shopify
    The channel-lane marketplace whose mode to set. Required.
  • workspaceId · string · requis
    The workspace whose lane to set. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_channel_lane_set", "arguments": {"mode": "off", "marketplace": "cardtrader", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_channel_pricing_profile_set≈ 412 tokens

  Pin one of the workspace's saved pricing profiles to one marketplace channel, or clear the pin with a null profileId. It is the same choice as the channel defaults card on the SpellBook pricing settings page. Read spellbook_channel_pricing_profiles first, and pin only a profile the seller named. Returns the full channel pricing read after the write, plus the channel's previous pin, so the change can be reverted by setting the previous value back. It changes which profile prices future automatic listings and reprices; it edits no profile and publishes nothing.

  Paramètres, retour & exemple (3)

  Paramètres

  • channel · string · requis · ebay | tcg | manapool | shopify | cardtrader
    The marketplace channel to pin: ebay, tcg (TCGplayer), manapool, shopify or cardtrader. Required.
  • profileId · ? · requis
    A profileId from spellbook_channel_pricing_profiles, or null to clear the pin so the channel falls back to the workspace's active profile. Required.
  • workspaceId · string · requis
    The workspace to change, from spellbook_workspaces_list. The signed-in customer must own it. Required.

  Exemple d'appel

  {"name": "spellbook_channel_pricing_profile_set", "arguments": {"channel": "ebay", "profileId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_channel_pricing_profiles≈ 257 tokens

  Read which saved pricing profile each marketplace channel prices from in one workspace. Automatic eBay listing and repricing price every card from the eBay channel's profile, so read this before a seller turns on automatic eBay listing. Returns the workspace's saved profiles by name with the active one marked, and for each channel the pinned profile, the profile automation actually prices from, and which SpellBook jobs read that pin. It reports the setting and recommends no profile.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace to read, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_channel_pricing_profiles", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_collection_buying_get≈ 275 tokens

  Read the current snapshot or one immutable revision of a collection deal owned by the selected workspace. The response includes the selected revision's command and receiptId so submitted terms and corrections can be audited. Read the collection-buying skill before interpreting lifecycle state.

  Paramètres, retour & exemple (3)

  Paramètres

  • dealId · string · requis
    Exact dealId from a record or list response. Required.
  • revision · integer · optionnel
    One immutable revision number. Omit for the latest snapshot.
  • workspaceId · string · requis
    The seller-owned workspace. Required.

  Exemple d'appel

  {"name": "spellbook_collection_buying_get", "arguments": {"dealId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_collection_buying_list≈ 254 tokens

  List a bounded page of collection deals in the selected seller workspace. Follow nextCursor to enumerate the full set, then read a deal for its latest or historical revision and source command.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum deals on this page, 1 to 50. Omit for the default of 20.
  • cursor · string · optionnel
    Opaque nextCursor from the previous page. Pass unchanged to continue; omit for the first page.
  • workspaceId · string · requis
    The seller-owned workspace. Required.

  Exemple d'appel

  {"name": "spellbook_collection_buying_list", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_collection_buying_record≈ 11023 tokens

  Record one seller-agreed collection deal or a later receipt, count correction, evaluation, seller response, reported payment/refund, return/title disposition, dispute, closure, or evidence-backed reopening. Read spellbook_skill(name: collection-buying) first. A submission is an immutable, owner-scoped receipt; retry its exact submissionId and payload after an uncertain result. It records evidence only: it does not contact a seller, send money, verify a reported payment, transfer title, receive inventory, or publish cards.

  Paramètres, retour & exemple (2)

  Paramètres

  • command · ? · requis
    One lifecycle command with a fresh submissionId and occurredAt. After open, supply dealId and expectedRevision.
  • workspaceId · string · requis
    The seller-owned workspace to record this deal in. Required.

  Exemple d'appel

  {"name": "spellbook_collection_buying_record", "arguments": {"command": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_collection_receipt≈ 340 tokens

  Read one receipt for the cards a workspace holds: total copies, distinct printings, printings held two or more times, copies with a market price and their market USD total, copies and market USD in each value band, copies and market USD at one dollar and up, the market USD of the most valuable copies up to topUnitsCap, and the top rows by market value with card name, set, collector number, finish, condition, copies, unit market and the Intelligent Pricing TCGplayer ask when one was computed. Call it to answer what a collection holds and what it is worth in one read; it works for a free collection-only workspace and for a store. Call spellbook_inventory_holdings next for every row, or spellbook_buylist_compare for per-destination nets. It reports facts; it does not rank, score or pick what to sell.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace whose held cards to total, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_collection_receipt", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_credit_conversion_candidates≈ 190 tokens

  Read CK credit-funded sealed acquisition candidates ranked by opening EV. Cash/credit opening multiples do NOT rank intact sealed resale cash profit. Credit is restricted purchasing power.

  Paramètres, retour & exemple (1)

  Paramètres

  • boxType · string · optionnel · all | play | draft | jumpstart | commander | precon
    Restrict candidates to one box type. Defaults to all, covering every type.

  Exemple d'appel

  {"name": "spellbook_credit_conversion_candidates", "arguments": {"boxType": "all"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_credit_resale_assessment≈ 1746 tokens

  Assess up to ten exact sealed product lines as a CK-credit-funded intact resale scenario. Supply starting credit and explicit cost assumptions; omit unknown costs. EV judgment is permitted. Returns labeled cash estimates, credit allocation, capacity and missing evidence. Research only, no purchase.

  Paramètres, retour & exemple (5)

  Paramètres

  • costs · object · requis
    Explicit cost assumptions for the resale scenario. Every field is optional; omit any cost that is unknown rather than guessing zero.
  • lines · array · requis
    Up to 10 exact sealed product lines to assess. Required, at least one.
  • exitChannel · string · requis
    Name of the channel the intact resale would exit through. Required, up to 30 characters.
  • startingCreditUsd · number · requis
    Card Kingdom store credit available to spend in this scenario, in USD. Required.
  • maxSnapshotAgeHours · number · requis
    Maximum age in hours of price snapshots this assessment may use. Required.

  Exemple d'appel

  {"name": "spellbook_credit_resale_assessment", "arguments": {"costs": {}, "lines": [], "exitChannel": "texte", "startingCreditUsd": 1, "maxSnapshotAgeHours": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_customer_evidence_get≈ 233 tokens

  Read one private immutable evidence receipt from the selected workspace. Returned observations and source fields remain submitted evidence.

  Paramètres, retour & exemple (2)

  Paramètres

  • receiptId · string · requis
    The receipt's receiptId from the record response, or the submissionId you chose when recording it. Either one resolves the same receipt inside the workspace. Required.
  • workspaceId · string · requis
    The workspace the receipt belongs to. Required.

  Exemple d'appel

  {"name": "spellbook_customer_evidence_get", "arguments": {"receiptId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_customer_evidence_list≈ 389 tokens

  List a bounded page of private evidence receipts from the selected workspace, optionally filtered by receipt kind, parent, or item ID.

  Paramètres, retour & exemple (6)

  Paramètres

  • kind · string · optionnel · consideration | work_observation | realized_outcome
    Restrict the list to one receipt kind. Omit to include every kind.
  • limit · integer · optionnel
    Maximum receipts to return, 1 to 50. Omit for the default of 20.
  • cursor · string · optionnel
    Opaque cursor from a previous page, passed back unchanged. Omit to start from the first page.
  • itemId · string · optionnel
    Restrict the list to receipts referencing this exact item id. Omit for no item filter.
  • workspaceId · string · requis
    The workspace to list receipts from. Required.
  • parentReceiptId · string · optionnel
    Restrict the list to receipts linked to this parent receipt's receiptId from the record response. Omit for no parent filter.

  Exemple d'appel

  {"name": "spellbook_customer_evidence_list", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_customer_evidence_record≈ 5105 tokens

  Append one immutable consideration, realized outcome, or work observation to the selected workspace. A receipt proves storage only. It does not verify source providers, inspected card truth, profit, or completed work.

  Paramètres, retour & exemple (2)

  Paramètres

  • request · ? · requis
    The evidence envelope: a submissionId, occurredAt, a kind (realized_outcome, consideration or work_observation), and that kind's payload. Required.
  • workspaceId · string · requis
    The workspace to append this evidence to. Required.

  Exemple d'appel

  {"name": "spellbook_customer_evidence_record", "arguments": {"request": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_deck_contents≈ 208 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • deckId · string · requis
    The exact deck id returned by the deck workflow. Required.

  Exemple d'appel

  {"name": "spellbook_deck_contents", "arguments": {"deckId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_deck_import_limitless≈ 425 tokens

  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 deck.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
    Optional deck name.
  • format · string · optionnel · Standard | Expanded | Unlimited
    Deck format. Defaults to Standard.
  • eventId · string · requis
    The Limitless tournament event id. Required.
  • playerId · string · requis
    The exact player name or id as shown by the selected event. Required.
  • workspaceId · string · requis
    The workspace to import into. The caller must be its owner. Required.
  • idempotencyKey · string · requis
    A caller-generated retry key. Reuse it unchanged after an uncertain result. Required.

  Exemple d'appel

  {"name": "spellbook_deck_import_limitless", "arguments": {"eventId": "texte", "playerId": "texte", "workspaceId": "texte", "idempotencyKey": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_automation_set≈ 550 tokens

  Set one workspace's eBay automation mode, which decides whether SpellBook lists and reprices on eBay by itself, whether that automation lists basic lands, and how many copies one listing may carry. This changes public eBay behavior for the workspace, only the workspace owner may call it, and the agent sets a mode only after the seller chose one. The modes: manual: Nothing lists or reprices on eBay automatically; you publish from the eBay preview when you choose. auto_list: New eligible inventory lists on eBay automatically at your saved eBay pricing strategy's prices, and existing eBay listings are never repriced automatically. full: New inventory lists on eBay automatically, and existing eBay listings reprice from your saved eBay pricing strategy. With variation packages on (the default), new inventory groups into one listing per set with each card as a variation; with them off, each card lists on its own.

  Paramètres, retour & exemple (4)

  Paramètres

  • mode · string · optionnel · manual | auto_list | full
    The mode the seller chose: manual, auto_list, or full. Send mode, basicLandsEnabled, maxQuantityPerListing, or any mix.
  • workspaceId · string · requis
    The workspace whose eBay automation mode to set. The caller must own it. Required.
  • basicLandsEnabled · boolean · optionnel
    true lets auto_list and full list basic lands (Plains, Island, Swamp, Mountain, Forest, Wastes, and their Snow-Covered printings). false skips them. The saved value defaults to false.
  • maxQuantityPerListing · ? · optionnel
    The most available copies one eBay listing may advertise, such as 3. null removes the cap. Omit it to keep the saved value, which defaults to null.

  Exemple d'appel

  {"name": "spellbook_ebay_automation_set", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_combined_shipping_get≈ 239 tokens

  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 one item.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_combined_shipping_get", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_combined_shipping_set≈ 696 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • profileName · string · optionnel
    Seller-selected eBay rule name. Defaults to SpellBook Finance Combined Shipping.
  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.
  • combinedDuration · string · optionnel · Days_1 | Days_3 | Days_4 | Days_5 | Days_7 | Days_30
    Optional buyer accumulation window. Omit to preserve the existing eBay window; a new account without one falls back to Days_7.
  • eachAdditionalAmountUsd · number · optionnel
    Seller-selected shipping charge for each additional item in USD. Defaults to 0.
  • promotionalShippingRule · ? · optionnel
    Optional shipping promotion. Use {orderAmountUsd, shippingCostUsd} for the existing amount-threshold offer or {ruleType: maximum_shipping_cost_per_order, maximumShippingCostPerOrderUsd} to cap shipping per order. Omit it to preserve the existing promotion.

  Exemple d'appel

  {"name": "spellbook_ebay_combined_shipping_set", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_connect_link≈ 196 tokens

  Get a one-click link the seller opens to connect their eBay account to SpellBook Finance. Call spellbook_ebay_connection_status first. The link is signed for this customer and expires, so fetch a fresh one when you hand it over. Give them the link and tell them eBay will ask them to sign in and approve the connection. Once they finish, call spellbook_ebay_connection_status again; the agent never needs to open a SpellBook browser.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_ebay_connect_link", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_connection_status≈ 199 tokens

  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 is revoked, fetch a fresh connect link.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_ebay_connection_status", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_job_status≈ 302 tokens

  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 per-card reason: relay that reason to the person. A job with dryRun true is a reprice preview: it changed no eBay price, and totalItems counts the listings a live run would reprice. Returns state, counts, per-card items, failures and missingFields.

  Paramètres, retour & exemple (1)

  Paramètres

  • jobId · string · requis
    The jobId returned by spellbook_ebay_publish or spellbook_ebay_reprice. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_job_status", "arguments": {"jobId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_lot_publish≈ 862 tokens

  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 legal in that format. ALWAYS call it once with dryRun true and show the person the preview, the per-card counts and the refusals before calling it again with dryRun false, because a live run creates a real listing a real buyer can buy. A live run returns the eBay listingId and listingUrl, or the refusals. It does not reserve the copies, and it does not know whether another channel sells them first.

  Paramètres, retour & exemple (9)

  Paramètres

  • cards · array · requis
    The deck list, at most 100 rows and 500 cards in total. Rows that share a card name are merged. Required.
  • title · string · requis
    The eBay listing title, at most 80 characters. Required.
  • dryRun · boolean · optionnel
    True previews the listing with no eBay call. False publishes for real. Defaults to true; a live run needs an explicit false.
  • summary · string · requis
    A short description of the deck for the listing body, at most 1000 characters. Required.
  • priceUsd · number · requis
    The listing price in USD for the whole deck, from 0.99 to 2000. Required. The person decides it.
  • archetype · string · optionnel
    An archetype label for the listing, such as Burn. Omit when the deck has none.
  • deckFormat · string · optionnel
    A Scryfall legality format key such as pauper or commander. When set, a card that is not legal or restricted in it blocks a live run. Omit to skip the legality check.
  • shippingUsd · number · requis
    The flat shipping charge in USD the buyer pays, from 0 to 50. Use 0 for free shipping. Required.
  • workspaceId · string · requis
    The workspace whose copies make up the deck. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_lot_publish", "arguments": {"cards": [], "title": "texte", "summary": "texte", "priceUsd": 1, "shippingUsd": 1, "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_order_discount_disable≈ 187 tokens

  Disable the caller's tracked eBay order-discount promotion after reading spellbook_ebay_order_discount_get. This ends the tracked promotion and requires agent_marketplace_publish authorization.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_order_discount_disable", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_order_discount_get≈ 195 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_order_discount_get", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_order_discount_set≈ 270 tokens

  Set a store-wide eBay order discount based on a seller-selected minimum quantity and percentage. Call spellbook_ebay_order_discount_get first; only one tracked order-discount promotion is supported, so this may replace the existing one.

  Paramètres, retour & exemple (3)

  Paramètres

  • minQuantity · integer · requis
    Seller-selected minimum item count. Required.
  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.
  • percentageOff · integer · requis
    Seller-selected discount percentage. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_order_discount_set", "arguments": {"minQuantity": 1, "workspaceId": "texte", "percentageOff": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_price_limit_enrollment_continue≈ 301 tokens

  Advance one bounded discovery step of an existing eBay enrollment and return its header. Read spellbook_ebay_price_limit_enrollment_get first for the current state version. The server chooses each discovery page; repeat from fresh readback while building, then ask the owner to review in the web app.

  Paramètres, retour & exemple (3)

  Paramètres

  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • enrollmentId · string · requis
    Enrollment ID returned by preparation. Required.
  • expectedStateVersion · integer · requis
    Current stateVersion from enrollment readback. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_price_limit_enrollment_continue", "arguments": {"workspaceId": "texte", "enrollmentId": "texte", "expectedStateVersion": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_price_limit_enrollment_get≈ 246 tokens

  Read one eBay price-limit enrollment's state, coverage counts, fingerprint and original expiry. Call after preparation or continuation. Read stored baselines with spellbook_ebay_price_limit_enrollment_pages; continue building with spellbook_ebay_price_limit_enrollment_continue.

  Paramètres, retour & exemple (2)

  Paramètres

  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • enrollmentId · string · requis
    Enrollment ID returned by preparation. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_price_limit_enrollment_get", "arguments": {"workspaceId": "texte", "enrollmentId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_price_limit_enrollment_pages≈ 286 tokens

  Read bounded stored pages of eBay enrollment identities, observed baselines, absolute bounds and exclusions. Call after spellbook_ebay_price_limit_enrollment_get. Follow nextCursor until null to inspect all stored pages; read the header again for overall completion.

  Paramètres, retour & exemple (3)

  Paramètres

  • cursor · string · optionnel
    Opaque nextCursor from the preceding stored-page response. Omit for the first page.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • enrollmentId · string · requis
    Enrollment ID returned by preparation. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_price_limit_enrollment_pages", "arguments": {"workspaceId": "texte", "enrollmentId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_price_limit_enrollment_prepare≈ 656 tokens

  Prepare an account-wide enrollment proposal from explicit owner-selected bounds and times. Returns a durable header and coverage counts. Explain the quiet interval prerequisite before calling: controlled price admissions and relevant membership changes can invalidate discovery. Continue with spellbook_ebay_price_limit_enrollment_continue; the owner reviews and activates in the web app.

  Paramètres, retour & exemple (7)

  Paramètres

  • scope · string · requis
    Known ordinary live USD listings for the verified eBay account. Required.
  • endsAt · string · requis
    Owner-selected exclusive admission-window end as a UTC timestamp. Required.
  • startsAt · string · requis
    Owner-selected inclusive admission-window start as a UTC timestamp. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • decreaseCents · integer · requis
    Owner-selected absolute USD cents below each observed baseline. Required; no default.
  • increaseCents · integer · requis
    Owner-selected absolute USD cents above each observed baseline. Required; no default.
  • expectedPolicyRevision · integer · requis
    Policy revision from spellbook_ebay_price_limits_get. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_price_limit_enrollment_prepare", "arguments": {"scope": "texte", "endsAt": "texte", "startsAt": "texte", "workspaceId": "texte", "decreaseCents": 1, "increaseCents": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_price_limits_get≈ 200 tokens

  Read active and pending eBay fixed-baseline price limits, enforcement status and missing evidence. Call before preparing a new enrollment with spellbook_ebay_price_limit_enrollment_prepare. Expiry stops new admissions; earlier admitted writes may still finish.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_price_limits_get", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_pricing_approval_execute≈ 258 tokens

  Execute the frozen targets of an owner-approved exact eBay pricing batch. First prepare with spellbook_ebay_pricing_approval_prepare and read owner approval with spellbook_ebay_pricing_approval_get. Returns durable execution and per-listing outcome evidence; read the same operation again to inspect progress.

  Paramètres, retour & exemple (2)

  Paramètres

  • operationId · string · requis
    Exact operation ID of the owner-approved prepared batch. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_pricing_approval_execute", "arguments": {"operationId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_pricing_approval_get≈ 249 tokens

  Read one exact eBay pricing batch's immutable targets, owner approval state and per-listing submission and readback evidence. Call after preparation or execution. Use spellbook_ebay_pricing_approval_execute only after owner approval; keep unknown submissions distinct from observed prices.

  Paramètres, retour & exemple (2)

  Paramètres

  • operationId · string · requis
    Exact operation ID returned by preparation. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_pricing_approval_get", "arguments": {"operationId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_pricing_approval_prepare≈ 289 tokens

  Prepare an immutable eBay pricing batch from selected inventory items. Returns exact listing identities, executable USD cents, complete physical membership and approval state. Ask the owner to review the batch in the web app, then call spellbook_ebay_pricing_approval_get before execution.

  Paramètres, retour & exemple (2)

  Paramètres

  • itemIds · array · requis
    Physical inventory item IDs to resolve into complete active eBay listings. The server refuses selections beyond its bounded listing or membership limit.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_pricing_approval_prepare", "arguments": {"itemIds": [], "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_pricing_restoration_prepare≈ 350 tokens

  Prepare a new exact eBay pricing approval from selected accepted source receipts. Returns eligible listing identities, typed conflicts and missing evidence. First read the source with spellbook_ebay_pricing_approval_get. The owner must choose manual automation and approve the new compensation in the web app; read its approval before spellbook_ebay_pricing_approval_execute.

  Paramètres, retour & exemple (3)

  Paramètres

  • listingIds · array · requis
    Owner-selected canonical eBay listing IDs from the source operation. Required; duplicates are refused.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • sourceOperationId · string · requis
    Source exact pricing operation ID containing retained accepted receipts. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_pricing_restoration_prepare", "arguments": {"listingIds": [], "workspaceId": "texte", "sourceOperationId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_publish≈ 646 tokens

  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 lists at 96% of market, and floorUsd only ever raises a price. A live run returns a queued jobId, or the reason nothing published. A queued job has listed nothing yet, so call spellbook_ebay_job_status with that jobId before telling the person any card is live.

  Paramètres, retour & exemple (8)

  Paramètres

  • binId · string · optionnel
    Restrict publishing to one exact bin. Omit to consider every owned copy.
  • dryRun · boolean · optionnel
    True previews the run with no live listings created. False publishes for real. Defaults to true; a live run needs an explicit false.
  • itemIds · array · optionnel
    Restrict publishing to these exact Item ids, from a prior spellbook_inventory_items_query. Pass one id to list one card. The owned-only rule still applies to each id. Omit to consider every owned copy.
  • floorUsd · number · optionnel
    A price floor in USD that only ever raises a computed price. Omit for no floor.
  • setCodes · array · optionnel
    Restrict publishing to these set codes. Omit to consider every set.
  • batchSize · integer · optionnel
    Maximum copies to submit in this call. Omit for the default batch size.
  • multiplier · number · requis
    Price multiplier applied to each copy's market price, e.g. 0.96 lists at 96% of market. Required.
  • workspaceId · string · requis
    The workspace whose owned copies to publish. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_publish", "arguments": {"multiplier": 1, "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_reprice≈ 804 tokens

  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 pricing profile or durable override. Preview first with the default dryRun true. A preview with itemIds returns its counts at once. Any other preview returns state planning and a jobId, so read its counts with spellbook_ebay_job_status. An explicit dryRun false queues an async reprice job. Read that job with spellbook_ebay_job_status until each affected listing reaches its terminal state.

  Paramètres, retour & exemple (10)

  Paramètres

  • binId · string · optionnel
    Restrict the run to one exact inventory bin. Omit for every live eBay listing in the workspace.
  • dryRun · boolean · optionnel
    True previews the listings and counts with no marketplace change. False queues the reprice job. Defaults to true; applying requires explicit false.
  • itemIds · array · optionnel
    Restrict the run to these exact listed Item ids from spellbook_inventory_items_query. Omit for every live eBay listing in the workspace.
  • pricing · string · optionnel · multiplier | saved_rules
    Use saved_rules to run the owner's accepted eBay strategy without caller pricing overrides. multiplier applies a one-run override where delegated permissions allow it.
  • floorUsd · number · optionnel
    Optional minimum ask in USD. Existing backend floors and locks can still raise the resulting ask.
  • setCodes · array · optionnel
    Restrict the run to these set codes. Omit for every live eBay listing in the workspace.
  • multiplier · number · optionnel
    Market multiplier such as 0.96. Required with pricing multiplier; omit with saved_rules.
  • workspaceId · string · requis
    The workspace whose existing eBay listings to reprice. Required.
  • acquisitionSource · string · optionnel
    Restrict the run to one exact acquisition source. Omit for every live eBay listing in the workspace.
  • skipIfWithinPercent · number · optionnel
    Skip an existing ask already within this percentage of the target. Defaults to 2.

  Exemple d'appel

  {"name": "spellbook_ebay_reprice", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_shipping_mode_get≈ 184 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_shipping_mode_get", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_shipping_mode_set≈ 262 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.
  • shippingMode · string · requis · buyer_pays_flat | free_baked_in
    Seller-selected account preference: buyer_pays_flat or free_baked_in. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_shipping_mode_set", "arguments": {"workspaceId": "texte", "shippingMode": "buyer_pays_flat"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_shipping_policy_get≈ 197 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_shipping_policy_get", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_shipping_policy_set≈ 310 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • workspaceId · string · requis
    Workspace the caller owns; used for delegated authorization. Required.
  • packageFlatRateUsd · number · requis
    Seller-selected flat package shipping charge in USD. Required.
  • envelopeFlatRateUsd · number · optionnel
    Optional seller-selected flat envelope shipping charge in USD. Omit to preserve its current amount.

  Exemple d'appel

  {"name": "spellbook_ebay_shipping_policy_set", "arguments": {"workspaceId": "texte", "packageFlatRateUsd": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_ebay_unpublish≈ 281 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • itemIds · array · requis
    Up to 25 exact Item ids whose eBay listings to end, from a prior spellbook_inventory_items_query. Required, at least one.
  • workspaceId · string · requis
    The workspace that owns the copies. Required.

  Exemple d'appel

  {"name": "spellbook_ebay_unpublish", "arguments": {"itemIds": [], "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_entitlements≈ 114 tokens

  Read this authenticated customer's current Investor and Seller access. Flags are not proof of payment or enrollment.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_entitlements", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_free_seller_workspace_claim≈ 296 tokens

  Claim the one permanent free Seller allowance for a workspace the seller explicitly chose. Ask the seller to name the workspace from spellbook_workspaces_list and confirm that choice before this call. Never pick a workspace from list order or an active-workspace default. The signed-in person must own it. Re-read spellbook_workspace_plan_status after this call for the actual allowance and entitlement.

  Paramètres, retour & exemple (2)

  Paramètres

  • workspaceId · string · requis
    The exact workspaceId the seller explicitly selected for their one free Seller workspace. Required.
  • choiceConfirmed · boolean · requis
    True only after the seller explicitly confirms this workspace choice in the current conversation. Required.

  Exemple d'appel

  {"name": "spellbook_free_seller_workspace_claim", "arguments": {"workspaceId": "texte", "choiceConfirmed": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_guides≈ 315 tokens

  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 each guide's purpose, supported decision, and URL; read that page for its tool sequence and field meanings. Public search-acquisition articles are excluded. For screening, valuing, or messaging about a Pokémon collection or Marketplace lot, read spellbook_skill with name collection-buying.

  Paramètres, retour & exemple (1)

  Paramètres

  • topic · string · optionnel · sealed-ev | pricing | card-identity | buylist-and-exits | reprint-risk | selling | inventory | portfolio
    Narrow results to one education topic id. Omit to search every published topic.

  Exemple d'appel

  {"name": "spellbook_guides", "arguments": {"topic": "sealed-ev"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_bin_ensure≈ 912 tokens

  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 created item ids plus every candidate it refused and why.

  Paramètres, retour & exemple (4)

  Paramètres

  • binId · string · requis
    The bin these cards physically sit in. A bin id is a container letter plus an incrementing number, like B0001, where the letter names the physical box and the number names the bag inside it. Required.
  • items · array · requis
    Up to 200 exact printing rows to record in this bin. Required, at least one.
  • workspaceId · string · requis
    The workspace to record these cards into. Required; writes only to this workspace.
  • physicallyConfirmed · boolean · requis
    Must be true, asserting a person has physically counted these cards. The call is refused when this is omitted or false.

  Exemple d'appel

  {"name": "spellbook_inventory_bin_ensure", "arguments": {"binId": "texte", "items": [], "workspaceId": "texte", "physicallyConfirmed": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_holdings≈ 349 tokens

  Read one page of what a seller's own workspace holds, aggregated to one row per printing, finish and condition. Each row carries card name, set code, collector number, variant label, quantity owned, quantity available, the current unit market price and the resolved minimum-sell floor with the tier that produced it. Call this to answer what is in the collection, what it is worth, what is already listed versus still available, and which rows sit near their floor. It reports holdings; it does not rank them, pick what to sell, or state a listing's live marketplace status.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum rows to return, 1 to 500. Omit for the default of 100.
  • cursor · string · optionnel
    Opaque cursor from a previous page, passed back unchanged. Omit to start from the first page.
  • workspaceId · string · requis
    The workspace to read holdings for. Required.

  Exemple d'appel

  {"name": "spellbook_inventory_holdings", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_import_csv≈ 860 tokens

  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 identity, finish, condition, and language; incomplete or mismatched rows are skipped with a repair reason and never default to Magic, English, or nonfoil. Sending the identical CSV again returns the first result with duplicate true and creates nothing. Returns the importId, how many copies were written, the bins used, and every row it could not parse or skipped.

  Paramètres, retour & exemple (9)

  Paramètres

  • csv · string · requis
    The full CSV text, header row included, exactly as the export produced it. Required. At most 200,000 characters.
  • source · string · requis · manabox | tcg
    Which export this is: manabox for a ManaBox CSV (needs Scryfall ID, Quantity, Condition and Foil columns), tcg for a TCGplayer seller inventory export (needs the TCGplayer Id column). Required.
  • binName · string · optionnel
    A human name for that one bin, 1 to 48 letters, digits, spaces, dashes or underscores. Honored only when oneBinPerUpload is true. A name another import already holds is refused.
  • binPrefix · string · optionnel
    One capital letter that starts fallback bin codes for copies without a mapped location, e.g. C gives C0001, C0002. Defaults to C.
  • totalCost · number · optionnel
    What the seller paid for the whole file in USD, split equally across every copy. Omit when the seller has not stated it; omitting records zero cost.
  • workspaceId · string · requis
    The workspace to import into. Required; writes only to this workspace.
  • blankLocation · string · optionnel · generate | error
    For a blank cell in a selected location column: generate assigns a fallback bin; error refuses the whole import before writing copies. Defaults to generate. Has no effect without a selected column.
  • locationColumn · ? · optionnel
    Location column: auto detects a single common location or bin header, none ignores source locations, or a zero-based original CSV column index selects it explicitly. Defaults to auto. Multiple matching headers require an explicit choice.
  • oneBinPerUpload · boolean · optionnel
    True puts the whole file in one fresh bin instead of packing 200 cards per bin across the rolling sequence. Defaults to false. Refused when any imported row has a mapped location.

  Exemple d'appel

  {"name": "spellbook_inventory_import_csv", "arguments": {"csv": "texte", "source": "manabox", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_incoming≈ 255 tokens

  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 groups; it does not track a package or say when one will arrive.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace whose incoming inventory to read, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_inventory_incoming", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_incoming_receive≈ 320 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • workspaceId · string · requis
    The workspace that holds the pending copies. Required; writes only to this workspace.
  • acquisitionSources · array · requis
    The acquisitionSource of each order or import to receive, exactly as spellbook_inventory_incoming or spellbook_purchase_incoming_record returned it. Required, at least one.

  Exemple d'appel

  {"name": "spellbook_inventory_incoming_receive", "arguments": {"workspaceId": "texte", "acquisitionSources": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_items_query≈ 558 tokens

  Read one private page of existing physical Items matching an exact acquisition source, exact bins, or printing, finish and condition groups. Coordinate filters narrow source or group results. Each Item carries scanPlacement, its approximate position in its scanned bin as ordinal of total, or null when it was never scanned there.

  Paramètres, retour & exemple (6)

  Paramètres

  • bins · array · optionnel
    Restrict results to these exact bin names, up to 25. Omit to search every bin.
  • limit · integer · optionnel
    Maximum Items to return, 1 to 1000. Omit for the default of 20.
  • cursor · string · optionnel
    Opaque cursor from a previous page, passed back unchanged. Omit to start from the first page.
  • groups · array · optionnel
    Restrict results to these exact printing, finish and condition groups, up to 25. Omit to skip this filter.
  • workspaceId · string · requis
    The workspace to read Items from. Required.
  • acquisitionSource · string · optionnel
    Restrict results to one exact acquisition source, such as a bulk-import ID. Combine with bins or groups to narrow it further.

  Exemple d'appel

  {"name": "spellbook_inventory_items_query", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_location_confirm≈ 448 tokens

  Save up to 25 existing Item bin locations after comparing each expectedBins observation with current state. A fresh Item query is required before and after the save.

  Paramètres, retour & exemple (5)

  Paramètres

  • toBin · string · requis
    The bin these Items are being confirmed into. Required.
  • itemIds · array · requis
    Up to 25 exact Item ids to move, from a prior spellbook_inventory_items_query. Required, at least one.
  • workspaceId · string · requis
    The workspace the Items belong to. Required.
  • expectedBins · array · requis
    One prior-bin observation per itemId in itemIds, up to 25. Required; a missing or changed Item rejects the whole batch.
  • sourceSignalId · string · optionnel
    An id linking this confirmation to its originating signal. Omit when there is none.

  Exemple d'appel

  {"name": "spellbook_inventory_location_confirm", "arguments": {"toBin": "texte", "itemIds": [], "workspaceId": "texte", "expectedBins": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_inventory_precon_import≈ 604 tokens

  Add one or more opened Commander precon decks to inventory as individual cards, the same Add Commander deck flow the SpellBook web app runs. The server reads the cached decklist for that TCGplayer product, creates one inventory copy per card at the exact deck printing, assigns bins, and splits the price paid across the cards. Returns the importId, how many copies were written, and the count placed in each bin.

  Paramètres, retour & exemple (8)

  Paramètres

  • binPrefix · string · requis
    One capital letter that starts the auto-assigned bin codes, e.g. C gives C0001. Required.
  • copyCount · integer · optionnel
    How many identical decks were opened, 1 to 20. Defaults to 1.
  • workspaceId · string · requis
    The workspace to add the cards to, from spellbook_workspaces_list. Required; writes only to this workspace.
  • paidPriceUsd · number · requis
    What the seller paid for ONE deck in USD. Required. Send 0 only when the deck cost nothing. Every copy of the deck is recorded at this price.
  • tcgProductId · integer · requis
    Exact TCGplayer product id of the sealed precon deck, from spellbook_sealed_product_search. Required. A product that is not a single Commander or Riftbound precon deck is refused.
  • oneBinPerDeck · boolean · optionnel
    True puts each deck in its own fresh bin. Defaults to false, which packs the cards into the rolling bin sequence.
  • acquisitionDate · string · requis
    The date the seller bought the deck, as YYYY-MM-DD. Required.
  • overrideDuplicate · boolean · optionnel
    True imports the deck even when this seller already imported the same product. Set it only when the person confirms a second physical deck.

  Exemple d'appel

  {"name": "spellbook_inventory_precon_import", "arguments": {"binPrefix": "texte", "workspaceId": "texte", "paidPriceUsd": 1, "tcgProductId": 1, "acquisitionDate": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_item_photo_upload_link≈ 325 tokens

  Get a link where the seller uploads their own phone photo of one inventory copy, so the next eBay listing shows that photo in place of catalog art. Use it when the seller wants buyers to see the real card, or when catalog art is wrong or missing. Take itemId from spellbook_inventory_items_query or spellbook_inventory_holdings. Give the seller the returned url and tell them to open it on their phone, then take or pick a photo of the card front. No photo passes through you. After they say it is saved, call spellbook_ebay_publish for that copy.

  Paramètres, retour & exemple (2)

  Paramètres

  • itemId · string · requis
    One inventory copy's itemId, from spellbook_inventory_items_query or spellbook_inventory_holdings. Required.
  • workspaceId · string · requis
    The workspace that holds the copy. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_item_photo_upload_link", "arguments": {"itemId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_japan_source_scan≈ 336 tokens

  Read the latest bounded Japan sourcing cohort: English Riftbound cards sold in Japan (riftbound-jp), Japanese-language Magic promos (japanese-promos), or exact-language Pokemon cards (pokemon, pokemon-en, pokemon-ja). Returns every tracked target's actual observation time, verified offers, exact reference prices with price kinds, unresolved listing URLs and recorded blockers, source status and freshness policy. publishedAt is snapshot publication time and does not refresh an older target. Sold and unrelated observations are not purchase candidates. Missing costs remain unknown; no buying recommendation or profit is provided.

  Paramètres, retour & exemple (1)

  Paramètres

  • cohortId · string · optionnel · riftbound-jp | japanese-promos | pokemon | pokemon-en | pokemon-ja
    English Riftbound cards sold in Japan, Japanese-language Magic promos, or one exact-language Pokemon cohort. Use pokemon-en or pokemon-ja to keep source observations isolated. Defaults to riftbound-jp.

  Exemple d'appel

  {"name": "spellbook_japan_source_scan", "arguments": {"cohortId": "riftbound-jp"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_japanese_sourcing≈ 649 tokens

  Read Japanese-market supply offers for the Japanese promo cohort from Mercari, Hareruya and Bigweb, each beside the comparison prices SpellBook holds on TCGplayer, ManaPool and eBay. Every row carries one exact supply offer with its printing identity, the merchant's own condition grade and its normalized equivalent, the native unit price with its currency, quantity, availability, and its own observedAt and staleAfter stamps; then every comparison reference with its kind and typed comparisonBasis, a deterministic selectedReference with the selectionRule that chose it, and a providerStatus row for each comparison source explaining why it is ok, missing, stale, failed or incompatible. grossDifferenceUsd is an asking spread and is null unless printing, language, finish, unit basis and condition equivalence all hold; netDifferenceUsd stays null because this read carries no costs. Rows come back in source order, and nothing is ranked, scored or recommended for you.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Maximum offers in this page. Page with cursor to traverse the rest; a short page is not proof the cohort ended.
  • cursor · string · optionnel
    The opaque nextCursor from the previous page, passed back unchanged. It is signed by the server; never construct, decode or edit one.
  • buySources · array · optionnel
    Which Japanese supply sources to read. Omit for all three. Narrow it only when the person named a merchant; a source you drop is simply absent, never proven empty.
  • includeStale · boolean · optionnel
    True also returns offers whose staleAfter has already passed, with their stamps intact. Default false returns only offers still inside their freshness window.
  • comparisonSources · array · optionnel
    Which comparison price sources to attach to each offer. Omit for all three. Each requested source returns a providerStatus row even when it has no reference.

  Exemple d'appel

  {"name": "spellbook_japanese_sourcing", "arguments": {"limit": 1, "cursor": "texte", "buySources": [], "includeStale": true, "comparisonSources": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_manapool_automation_set≈ 430 tokens

  Set one workspace's ManaPool automation mode, which decides whether SpellBook creates, updates, delists, and reprices ManaPool listings by itself. This changes public ManaPool behavior for the workspace, only the workspace owner may call it, and the agent sets a mode only after the seller chose one. The modes: manual: SpellBook creates no ManaPool listings and sends no quantity changes or delistings, but it keeps repricing your existing ManaPool listings. assisted: SpellBook plans the ManaPool listing changes it would make but sends none of them and offers no approval step, and it keeps repricing your existing ManaPool listings. automatic: SpellBook creates, updates, and delists ManaPool listings as your inventory changes and reprices existing ones, once the workspace passed a ManaPool test publish and while ManaPool reports the account ready to sell. paused: SpellBook sends nothing to ManaPool: no new listings, no quantity changes, no delistings, and no repricing.

  Paramètres, retour & exemple (2)

  Paramètres

  • mode · string · requis · manual | assisted | automatic | paused
    The mode the seller chose: manual, assisted, automatic, or paused. Required.
  • workspaceId · string · requis
    The workspace whose ManaPool automation mode to set. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_manapool_automation_set", "arguments": {"mode": "manual", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_manapool_connect_link≈ 264 tokens

  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 no ManaPool account signs up first and then creates an access token starting mpat_. Tell them the SpellBook page already shows their email and return address, so they paste only the token. Call spellbook_manapool_connection_status after they finish. The agent never receives or submits the credential.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_manapool_connect_link", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_manapool_connection_status≈ 173 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_manapool_connection_status", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_manapool_sync_apply≈ 412 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • floorUsd · number · optionnel
    Must match the floorUsd used to build the preview, or the token is refused.
  • maxActions · integer · optionnel
    Maximum actions to apply in this call, 1 to 250. Omit for the default of 50; call again with the same token to continue.
  • multiplier · number · optionnel
    Must match the multiplier used to build the preview, or the token is refused.
  • workspaceId · string · requis
    The workspace whose previewed changes to apply. Required.
  • previewToken · string · requis
    The previewToken from spellbook_manapool_sync_preview. Must still be valid; a stale token is refused.

  Exemple d'appel

  {"name": "spellbook_manapool_sync_apply", "arguments": {"workspaceId": "texte", "previewToken": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_manapool_sync_preview≈ 327 tokens

  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 previewToken this returns.

  Paramètres, retour & exemple (3)

  Paramètres

  • floorUsd · number · optionnel
    A price floor in USD for this preview. Omit to use the workspace's stored floor.
  • multiplier · number · optionnel
    Price multiplier applied to market price for this preview. Omit to use the workspace's stored pricing.
  • workspaceId · string · requis
    The workspace to compare against live ManaPool state. Required.

  Exemple d'appel

  {"name": "spellbook_manapool_sync_preview", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_marketplace_onboarding≈ 427 tokens

  Read how a seller onboards to one channel-lane marketplace and where this workspace's lane stands. It returns the venue's ordered onboarding steps with who does each step, what each needs, where it happens, and its sources, plus the venue's fees, seller levels, and accepted conditions. It also returns the workspace's lane: whether it exists and is enabled, whether SpellBook Finance holds the seller's key for the venue, whether the venue flag is on, whether SpellBook sync exists for the venue, and live and unconfirmed listing counts. Call it when a seller asks how to start selling on Misprint, or why nothing lists there. Walk the seller through the steps they have not done. While lane.connected is false, hand the seller the url of the step that connects the venue to SpellBook Finance, where the seller pastes the key themselves. Call this tool again after they finish. For eBay or ManaPool, call spellbook_ebay_connection_status or spellbook_manapool_connection_status.

  Paramètres, retour & exemple (2)

  Paramètres

  • marketplace · string · requis · cardtrader | ebay | manapool | misprint | shopify
    The channel-lane marketplace whose onboarding steps and lane state to read.
  • workspaceId · string · requis
    The workspace whose lane to read. Required.

  Exemple d'appel

  {"name": "spellbook_marketplace_onboarding", "arguments": {"marketplace": "cardtrader", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_movers≈ 305 tokens

  Read which card printings changed price the most over one window: daily, weekly, 30d or 90d. Returns gainers and losers with exact game, catalog product, language, finish and marketplace variant when the source provides them, plus current and previous prices, dollar and percent change, a canonical SpellBook Finance cardUrl, and run timestamps. Call this to answer "what is moving this week" instead of guessing, then call spellbook_card_prices for one printing's per-source prices. An unavailable result names why no supported rows can be returned.

  Paramètres, retour & exemple (2)

  Paramètres

  • game · string · optionnel · mtg | riftbound | pokemon
    Restrict card movers to one game. Omit for the default Magic board.
  • window · string · optionnel · daily | weekly | 30d | 90d
    Which price-change window to read: daily, weekly, 30d or 90d. Omit for the default window.

  Exemple d'appel

  {"name": "spellbook_movers", "arguments": {"game": "mtg", "window": "daily"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_order_proof_photos≈ 328 tokens

  Read the packing proof photos for ONE order: a view link for each pull line the packer photographed, with card name, finish, condition and capture time, plus the order's lines that have no photo. Use it to answer whether an order's cards were photographed before shipping, or to gather evidence for a dispute. Photos come from the packer's own camera in the pull flow. This tool only reads them and cannot upload one.

  Paramètres, retour & exemple (3)

  Paramètres

  • orderId · string · requis
    The marketplace's order id exactly as the order lists it. Required.
  • marketplace · string · requis · tcg | manapool | ebay | shopify | cardtrader
    The marketplace the order came from. Required.
  • workspaceId · string · requis
    The workspace that shipped the order, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_order_proof_photos", "arguments": {"orderId": "texte", "marketplace": "tcg", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_arbitrage_spreads≈ 834 tokens

  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.

  Paramètres, retour & exemple (15)

  Paramètres

  • limit · integer · optionnel
    Maximum rows to return, from 1 to 100. Defaults to 25.
  • finish · string · optionnel · nf | fo | rh | 1e | 1e-fo
    Optional exact finish filter.
  • cohortId · string · optionnel · pokemon | pokemon-en | pokemon-ja
    Optional Pokemon cohort. Use pokemon-ja or pokemon-en to keep language evidence isolated.
  • language · string · optionnel · en | ja
    Optional exact language filter.
  • condition · string · optionnel · NM | LP | MP | HP | DMG
    Optional condition filter.
  • productId · string · optionnel
    Optional exact Pokemon catalog product id from spellbook_printings_search.
  • proxyFeeUsd · ? · optionnel
    Optional proxy fee assumption in USD; omitted keeps landed cost incomplete.
  • importDutyRate · ? · optionnel
    Optional import duty rate as a decimal; omitted keeps landed cost incomplete.
  • sellingFeeRate · ? · optionnel
    Optional selling fee rate as a decimal; omitted keeps net proceeds incomplete.
  • otherSellingUsd · ? · optionnel
    Optional other selling cost in USD; omitted keeps net proceeds incomplete.
  • importChargesUsd · ? · optionnel
    Optional import charges assumption in USD; omitted keeps landed cost incomplete.
  • inboundShippingUsd · ? · optionnel
    Optional inbound shipping assumption in USD; omitted keeps landed cost incomplete.
  • sellingFixedFeeUsd · ? · optionnel
    Optional selling fixed fee in USD; omitted keeps net proceeds incomplete.
  • otherAcquisitionUsd · ? · optionnel
    Optional other acquisition cost in USD; omitted keeps landed cost incomplete.
  • outboundShippingUsd · ? · optionnel
    Optional outbound shipping assumption in USD; omitted keeps net proceeds incomplete.

  Exemple d'appel

  {"name": "spellbook_pokemon_arbitrage_spreads", "arguments": {"limit": 1, "finish": "nf", "cohortId": "pokemon", "language": "en", "condition": "NM", "productId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_ath≈ 234 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • date · string · optionnel
    Optional retained snapshot date, YYYY-MM-DD. Omit to read the latest snapshot.
  • game · string · requis
    The game to read. Must be pokemon.

  Exemple d'appel

  {"name": "spellbook_pokemon_ath", "arguments": {"game": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_market_analytics≈ 394 tokens

  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, recommend an action or infer a missing source.

  Paramètres, retour & exemple (4)

  Paramètres

  • cardId · string · requis
    The exact Pokemon catalog product id from spellbook_printings_search, such as pokemon:tcgp:12345. Required.
  • finish · string · requis · nf | fo | rh | 1e | 1e-fo
    Observed finish: nf regular, fo holo, rh reverse holo, 1e first edition, or 1e-fo first edition holo. Required.
  • language · string · requis
    Observed card language, such as en or ja. Required; do not infer from the seller location.
  • condition · string · requis · NM | LP | MP | HP | DMG
    Observed condition: NM, LP, MP, HP, or DMG. Required; do not assume near mint.

  Exemple d'appel

  {"name": "spellbook_pokemon_market_analytics", "arguments": {"cardId": "texte", "finish": "nf", "language": "texte", "condition": "NM"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_metagame_archetype≈ 274 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum cards to return, from 1 to 100. Defaults to 100.
  • format · string · requis · standard | expanded | unlimited
    Pokemon format. Required.
  • archetypeName · string · requis
    Exact observed archetype name. Required.

  Exemple d'appel

  {"name": "spellbook_pokemon_metagame_archetype", "arguments": {"format": "standard", "archetypeName": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_metagame_card≈ 279 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum observations to return, from 1 to 100. Defaults to 20.
  • cardId · string · requis
    Exact Pokemon catalog product id from spellbook_printings_search. Required.
  • format · string · optionnel · standard | expanded | unlimited
    Optional Pokemon format filter.

  Exemple d'appel

  {"name": "spellbook_pokemon_metagame_card", "arguments": {"cardId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_metagame_overview≈ 232 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum archetypes to return, from 1 to 100. Defaults to 50.
  • format · string · requis · standard | expanded | unlimited
    Pokemon format. Required.

  Exemple d'appel

  {"name": "spellbook_pokemon_metagame_overview", "arguments": {"format": "standard"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pokemon_tcg_staged_preview≈ 281 tokens

  Preview the TCGplayer CSV rows for 1 to 25 exact Pokemon physical inventory copies in one workspace. Call this after the seller selects the copies they want to inspect. It returns the existing staged-preview rows and CSV; it queues nothing, publishes nothing, and offers no publish or export follow-up.

  Paramètres, retour & exemple (2)

  Paramètres

  • itemIds · array · requis
    The exact Item ids selected by the seller, 1 to 25 unique non-empty values. Required; each copy must be owned and belong to Pokemon.
  • workspaceId · string · requis
    The workspace that owns every selected Pokemon inventory copy. Required.

  Exemple d'appel

  {"name": "spellbook_pokemon_tcg_staged_preview", "arguments": {"itemIds": [], "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_create≈ 944 tokens

  Create one bounded seller pricing amendment from a selector, marketplace scope, absolute multiplier and optional protected band. Returns saved readback. The server retains its adaptive default internally; this tool has no demand behavior input and does not publish or reprice.

  Paramètres, retour & exemple (8)

  Paramètres

  • mode · object · requis
    Absolute multiplier and optional protected band. Required.
  • name · string · requis
    Seller-selected amendment name. Required.
  • notes · ? · optionnel
    Optional seller notes; null clears notes.
  • enabled · boolean · optionnel
    Whether the amendment starts enabled. Omit for enabled.
  • priority · integer · requis
    Seller-selected precedence priority. Required.
  • selector · object · requis
    The bounded inventory selector. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • marketplaceScope · ? · requis
    Marketplace scope. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_create", "arguments": {"mode": {}, "name": "texte", "priority": 1, "selector": {}, "workspaceId": "texte", "marketplaceScope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_delete≈ 221 tokens

  Delete one saved pricing amendment by exact amendment id and return a deletion readback. This changes saved configuration and does not publish or trigger repricing.

  Paramètres, retour & exemple (2)

  Paramètres

  • amendmentId · string · requis
    The exact saved amendment id from a prior amendment read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_delete", "arguments": {"amendmentId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_get≈ 228 tokens

  Read one saved pricing amendment's selector, marketplace scope, absolute multiplier, optional protected band, enabled state, priority and timestamps. Use it before an update, preview or delete.

  Paramètres, retour & exemple (2)

  Paramètres

  • amendmentId · string · requis
    The exact saved amendment id from a prior amendment read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_get", "arguments": {"amendmentId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_preview≈ 980 tokens

  Start or run a bounded preview for one saved amendment or one seller-selected draft. Returns customer-safe per-channel impact counts and status evidence, with no raw inventory rows or demand telemetry. Preview is not publication.

  Paramètres, retour & exemple (4)

  Paramètres

  • channels · array · optionnel
    Optional marketplace channels to preview.
  • amendment · object · optionnel
    Draft amendment; provide this or amendmentId.
  • amendmentId · string · optionnel
    The exact saved amendment id from a prior amendment read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_preview", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_preview_status≈ 236 tokens

  Read one pricing amendment preview job's bounded status and per-channel customer impacts. It returns counts, quantities, delta totals, timestamps, missing evidence and limitations. It never publishes or reprices.

  Paramètres, retour & exemple (2)

  Paramètres

  • jobId · string · requis
    The preview job id returned by spellbook_pricing_amendment_preview. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_preview_status", "arguments": {"jobId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendment_update≈ 935 tokens

  Update selected fields on one saved pricing amendment and return saved readback. Omitted fields preserve existing values, including server-owned demand behavior. The update does not publish or trigger repricing.

  Paramètres, retour & exemple (9)

  Paramètres

  • mode · object · optionnel
    Replacement absolute multiplier and optional protected band.
  • name · string · optionnel
    Replacement seller-selected name.
  • notes · ? · optionnel
    Replacement notes; null clears notes.
  • enabled · boolean · optionnel
    Replacement enabled state.
  • priority · integer · optionnel
    Replacement precedence priority.
  • selector · object · optionnel
    Replacement bounded selector.
  • amendmentId · string · requis
    The exact saved amendment id from a prior amendment read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • marketplaceScope · ? · optionnel
    Replacement marketplace scope.

  Exemple d'appel

  {"name": "spellbook_pricing_amendment_update", "arguments": {"amendmentId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_amendments_list≈ 262 tokens

  List bounded seller pricing amendments with selector, marketplace scope, absolute multiplier, protected band, enabled state, priority and timestamps. It returns a cursor plus missing evidence and limitations.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum amendments to return, 1 to 100. Omit for 50.
  • cursor · string · optionnel
    Opaque cursor from a prior list response. Omit for the first page.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_amendments_list", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_decision_explain≈ 349 tokens

  Read one seller listing's recorded pricing evidence for one marketplace. Returns the last recorded ask, market anchor, safe price effect, decision timestamps and whether the evidence is observed, recorded, projected or missing. Call this when a seller asks what price was saved or what evidence supports it, then use the seller controls tools when they want to inspect or change a setting. It never claims a remote marketplace ask is current without a remote observation timestamp.

  Paramètres, retour & exemple (3)

  Paramètres

  • itemId · string · requis
    The exact Item id, from a prior spellbook_inventory_items_query. Required.
  • channel · string · requis · tcg | ebay | manapool | cardtrader | shopify
    Which marketplace listing to explain. Required, because the same copy carries a different ask per channel.
  • workspaceId · string · requis
    The workspace that owns the listing. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_decision_explain", "arguments": {"itemId": "texte", "channel": "tcg", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_profile_activate≈ 237 tokens

  Activate one seller-selected pricing profile and return its saved readback plus resulting active profile id. The first profile remains inactive until this explicit call. Activation does not publish or trigger repricing.

  Paramètres, retour & exemple (2)

  Paramètres

  • profileId · string · requis
    The exact saved pricing profile id from a prior pricing profile read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_profile_activate", "arguments": {"profileId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_profile_create≈ 1087 tokens

  Create one seller pricing profile from a seller-selected name and explicit baseline multiplier and floor, with optional dollar offset, ordinary channel overrides, or a fixed equal-probability eBay base-price trial. A trial requires an explicit experiment id, positive allocation epoch and two different seller-selected multipliers. Returns saved profile and pin readback. It does not activate, publish or immediately reprice.

  Paramètres, retour & exemple (6)

  Paramètres

  • mult · number · requis
    Explicit baseline market multiplier. Required.
  • name · string · requis
    Seller-selected profile name. Required.
  • floor · number · requis
    Explicit baseline floor in USD. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • marketOffsetUsd · number · optionnel
    Optional baseline dollar adjustment.
  • channelOverrides · object · optionnel
    Seller-approved overrides by marketplace channel. Omit when none are needed.

  Exemple d'appel

  {"name": "spellbook_pricing_profile_create", "arguments": {"mult": 1, "name": "texte", "floor": 1, "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_profile_get≈ 244 tokens

  Read one seller pricing profile's approved multiplier, floor, dollar offset, ordinary value bands, channel overrides, and any configured fixed eBay base-price trial, then report active state and channel pin facts. Call it before an update or activation.

  Paramètres, retour & exemple (2)

  Paramètres

  • profileId · string · requis
    The exact saved pricing profile id from a prior pricing profile read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_profile_get", "arguments": {"profileId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_profile_update≈ 1124 tokens

  Update selected seller-approved fields on one pricing profile and return saved profile and pin readback. Omitted fields stay unchanged. Null clears one channel override or only its eBay base-price trial.

  Paramètres, retour & exemple (7)

  Paramètres

  • mult · number · optionnel
    Replacement baseline multiplier.
  • name · string · optionnel
    Replacement seller-selected profile name.
  • floor · number · optionnel
    Replacement baseline floor in USD.
  • profileId · string · requis
    The exact saved pricing profile id from a prior pricing profile read. Required.
  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.
  • marketOffsetUsd · number · optionnel
    Replacement baseline dollar adjustment.
  • channelOverrides · object · optionnel
    Selected per-channel overrides; omit to preserve all, null to clear one channel entry.

  Exemple d'appel

  {"name": "spellbook_pricing_profile_update", "arguments": {"profileId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pricing_profiles_list≈ 182 tokens

  List seller-created pricing profiles by name and active state, plus the resulting active profile id. Call it before choosing a profile for detail, update, activation or channel pinning.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace the seller selected. The caller must own it. Required.

  Exemple d'appel

  {"name": "spellbook_pricing_profiles_list", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_printings_search≈ 390 tokens

  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 finishes. Read this first, because a card name alone does not identify a printing, and a wrong printing values the wrong card.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · requis
    Card name to search, optionally narrowed with `set:<code>` plus a collector number in the same string, e.g. "sol ring set:c21 263". Required.
  • game · string · optionnel · mtg | riftbound | pokemon
    Restrict the search to one game. Omit to search all enabled games.
  • page · integer · optionnel
    Page number of results, 1 to 20. Omit for the first page.
  • language · string · optionnel · en | ja
    Restrict Pokemon results to English or Japanese catalog rows. Omit when language is unknown.

  Exemple d'appel

  {"name": "spellbook_printings_search", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_pull_work≈ 402 tokens

  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 before summarizing the full returned workset. Use pending lines for the shared bin walk, then verify and pack each order separately.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum complete order groups to return on this page, from 1 to 50. Omit for 20.
  • cursor · string · optionnel
    Opaque nextCursor from the previous page. Pass it unchanged to continue; omit for the first page.
  • marketplace · string · optionnel · all | tcgplayer | ebay | shopify | manapool | cardtrader
    Filter to one marketplace, or use all for the combined bin walk. Omit for all.
  • workspaceId · string · requis
    The seller-owned workspace to read, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_pull_work", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_purchase_incoming_record≈ 904 tokens

  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. Use it right after the customer completes a marketplace checkout for singles found through spellbook_buy_targets or spellbook_singles_buylist_spreads. It never buys anything and moves no money. A card already in hand goes through spellbook_inventory_bin_ensure instead. When the package arrives, call spellbook_inventory_incoming_receive with the returned acquisitionSource.

  Paramètres, retour & exemple (5)

  Paramètres

  • rows · array · requis
    The order's lines, one per exact printing, condition and finish. Required, at least one.
  • orderRef · string · requis
    The marketplace's order number from the checkout confirmation. Required. The same order number groups every copy for receiving.
  • sellerName · string · optionnel
    The seller's store name on the marketplace, when the checkout shows one. Shown beside the order in the incoming list.
  • marketplace · string · requis · tcgplayer | ebay | manapool | cardtrader | other
    Where the order was placed. Required. Use other for any marketplace not listed.
  • workspaceId · string · requis
    The workspace that bought the cards, from spellbook_workspaces_list. Required; writes only to this workspace.

  Exemple d'appel

  {"name": "spellbook_purchase_incoming_record", "arguments": {"rows": [], "orderRef": "texte", "marketplace": "tcgplayer", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_repeat_buyers≈ 272 tokens

  Read which of the signed-in seller's buyers ordered more than once, across every channel SpellBook syncs orders from, and what happened after a free card shipped in an order. Returns overview counts and shares, weekly returning-order shares overall and per channel, buyerList with each repeat buyer's display name, channels, order count, spend and first and last order dates, and recipients with each free card recipient's prior and later orders and a status of came_back, bought_before or first_order. Call it when a seller asks who their repeat customers are, how many buyers come back, which buyers buy on more than one marketplace, or what free card recipients did next. It reads every workspace the seller belongs to and takes no input.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_repeat_buyers", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_return_address≈ 167 tokens

  Read the signed-in seller's saved return address: the name, street line, and city-state-ZIP line SpellBook prints on shipping labels, plus the other settings stored beside it. profile is null when the seller never saved one. Read it before spellbook_return_address_save, so the agent can show the seller what is on file.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_return_address", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_return_address_save≈ 428 tokens

  Save the return address the seller gave, which SpellBook prints on shipping labels and which store setup counts as returnAddressSaved. It replaces only the name, street, and city-state-ZIP lines and keeps every other saved setting. Only the workspace owner may call it, and only with an address the seller stated. A seller who does not want to share a home address in chat can type it on a SpellBook page, which the limits name, so offer that page before you ask for the address. Call spellbook_store_setup_status afterwards to confirm returnAddressSaved.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
    The name on the return address, such as the seller's name or store name, exactly as the seller gave it. Required.
  • street · string · requis
    One street line, such as a house number and street, exactly as the seller gave it. Required.
  • workspaceId · string · requis
    The workspace whose setup this address completes. The caller must own it. Required.
  • cityStateZip · string · requis
    One line with city, state, and ZIP code, such as Springfield, IL 62701, exactly as the seller gave it. Required.

  Exemple d'appel

  {"name": "spellbook_return_address_save", "arguments": {"name": "texte", "street": "texte", "workspaceId": "texte", "cityStateZip": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_returned_package_lookup≈ 459 tokens

  Find shipped orders by marketplace order id, order label, tracking number, pull session id, or part of a buyer name or street line, and read each order's shipment facts with its newest return case. Use it when a package came back to the seller, such as a USPS return to sender, before calling spellbook_returned_package_record. Each match carries sessionId, marketplace, externalOrderId, buyerName, shippedAt, trackingNumber, destinationSummary, line counts, cardNames and returnCase. returnCase is null when no return was recorded for that shipment. Otherwise it carries caseId, status, returnReason, resolution and reshipExportPrepared. A held case with reshipExportPrepared false goes to spellbook_returned_package_reship_prepare next. A held case with reshipExportPrepared true goes to spellbook_returned_package_reship_tracking. Returns results with one row per identifier and status matched, ambiguous or not_found, plus missingFields.

  Paramètres, retour & exemple (2)

  Paramètres

  • identifiers · array · requis
    Up to 50 values to look up, each a marketplace order id, order label, tracking number, pull session id, or part of a buyer name or street line. Required, at least one.
  • workspaceId · string · requis
    The workspace that shipped the orders, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_returned_package_lookup", "arguments": {"identifiers": [], "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_returned_package_record≈ 632 tokens

  Record that shipped packages came back to the seller unopened, such as a USPS return to sender. Pass the sessionId of each order from spellbook_returned_package_lookup and one returnReason for the batch. Each order gets one return case, held with every line unconfirmed. A reship starts from that held case. It refunds nothing, changes no inventory and touches no marketplace. Returns one row per session with status recorded, already_open or failed, the caseId, and an errorCode when it failed. To reship, call spellbook_returned_package_reship_prepare with the caseId next.

  Paramètres, retour & exemple (5)

  Paramètres

  • sessionIds · array · requis
    Up to 50 sessionId values from spellbook_returned_package_lookup, one per returned envelope. Required, at least one.
  • workspaceId · string · requis
    The workspace that shipped the orders, from spellbook_workspaces_list. Required; writes only to this workspace.
  • returnReason · string · requis · address_issue | insufficient_postage | unclaimed_or_refused | damaged_in_transit | unknown | other
    Why the carrier returned the packages, applied to every session in this call. address_issue means the address was wrong or incomplete, and the reship then requires a corrected address. unclaimed_or_refused covers an unclaimed or refused letter. Use unknown when the return label gives no reason. Required.
  • idempotencyKey · string · requis
    A key you choose for this batch, such as rts- followed by the order id. Required. Send the same key on a retry after a timeout. A new key on a session that already has an open case returns already_open.
  • externalOrderId · string · optionnel
    The marketplace order id of the one returned order, as the marketplace prints it. Send it only with exactly one sessionId, when that pull sheet holds several orders. Omit it otherwise.

  Exemple d'appel

  {"name": "spellbook_returned_package_record", "arguments": {"sessionIds": [], "workspaceId": "texte", "returnReason": "address_issue", "idempotencyKey": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_returned_package_reship_prepare≈ 800 tokens

  Prepare the reship of returned packages recorded with spellbook_returned_package_record. Pass each caseId, with correctedDestination when the address on file is wrong or missing. Returns one row per case with the destination address, card count, computed weight in ounces and shipping bucket (pwe, parcel or international). The seller buys a new label from that row. It buys no label, moves no money and touches no marketplace. After the seller buys the label, call spellbook_returned_package_reship_tracking with the new tracking number.

  Paramètres, retour & exemple (3)

  Paramètres

  • cases · array · requis
    Up to 50 cases to prepare. Required, at least one.
  • workspaceId · string · requis
    The workspace that shipped the orders, from spellbook_workspaces_list. Required; writes only to this workspace.
  • idempotencyKey · string · requis
    A key you choose for this batch. Required. Send the same key and cases on a retry after a timeout to read the first result back.

  Exemple d'appel

  {"name": "spellbook_returned_package_reship_prepare", "arguments": {"cases": [], "workspaceId": "texte", "idempotencyKey": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_returned_package_reship_tracking≈ 444 tokens

  Record the tracking number of the new label for a reshipped return. The case then resolves with resolution reship. Pass each caseId prepared with spellbook_returned_package_reship_prepare and the tracking number of the label the seller bought. Returns one row per case with status recorded, already_recorded or failed, and an errorCode when it failed. It buys no label, sends nothing to a marketplace and notifies no buyer.

  Paramètres, retour & exemple (3)

  Paramètres

  • matches · array · requis
    Up to 50 pairs of caseId and tracking number. Required, at least one.
  • workspaceId · string · requis
    The workspace that shipped the orders, from spellbook_workspaces_list. Required; writes only to this workspace.
  • idempotencyKey · string · requis
    A key you choose for this batch. Required. Send the same key on a retry after a timeout.

  Exemple d'appel

  {"name": "spellbook_returned_package_reship_tracking", "arguments": {"matches": [], "workspaceId": "texte", "idempotencyKey": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_riftbound_japanese_comparables≈ 241 tokens

  Read physical Japanese-language Riftbound observations, separate from English cards sold in Japan. Returns exact SKU language, finish, condition, price kind, source links, actual price capture timestamps, freshness policy, per-source eligible denominators and nullable acceptance rates. ManaPool is unsupported_game. Distinguishes unavailable, stale, completed eligible zero and accepted evidence. TCG Market is a provider statistic, not a completed sale or guaranteed resale proceeds. asOf is query time. An empty result never implies a market price of zero or proves market-wide coverage.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "spellbook_riftbound_japanese_comparables", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sale_record≈ 956 tokens

  Record a sale of cards the seller's workspace holds that happened outside SpellBook's order intake, such as a local game store buy, an in-person trade, or a one-off marketplace sale SpellBook did not import. Names the exact printing, finish, condition, quantity and unit sale price. It marks that many copies sold, oldest first, closes the position so spellbook_inventory_holdings and spellbook_buy_outcome_report reflect it, and pulls those copies off every marketplace where they are still live. Returns the sold item ids and the holding after the sale.

  Paramètres, retour & exemple (13)

  Paramètres

  • qty · integer · requis
    How many copies sold. Required.
  • note · string · optionnel
    A free-text note stored with the sale. Optional.
  • binId · string · optionnel
    Sell only copies from this bin. Omit to take the oldest copies from any bin.
  • finish · string · requis · nf | fo | etched | surge | rh | 1e | 1e-fo
    The finish of the sold copies, matching the finish recorded in inventory. Pokemon supports nf (Normal/Unlimited), fo (Holofoil), rh (Reverse Holofoil), 1e (1st Edition) and 1e-fo (1st Edition Holofoil). Required.
  • orderId · string · requis
    A stable reference for this sale, such as the buyer's order number or a receipt number. Required. A second call with the same orderId for the same printing, finish and condition returns the first sale with replayed true and sells nothing.
  • buyerName · string · optionnel
    The buyer's name as the customer stated it. Optional.
  • condition · string · requis · NM | LP | MP | HP | DMG
    The condition of the sold copies, matching how they were recorded. Required.
  • productId · string · requis
    The exact printing id, from spellbook_printings_search or spellbook_inventory_holdings. Required; a wrong id sells the wrong card.
  • occurredAt · string · optionnel
    When the sale happened, as an ISO-8601 timestamp. Omit to use the time of this call.
  • marketplace · string · requis · tcg | manapool | ebay | in_person | buylist | unknown
    Where the sale happened. in_person covers a store buy or a trade. buylist covers a sale to a dealer's buylist and needs buylistVendor. Required.
  • workspaceId · string · requis
    The workspace that held the sold copies, from spellbook_workspaces_list. Required.
  • buylistVendor · string · optionnel
    The dealer that bought the copies, such as Card Kingdom. Required when marketplace is buylist. Omit for every other marketplace.
  • salePricePerUnit · number · requis
    Price received PER COPY in USD, before any fee. Not the order total. Required.

  Exemple d'appel

  {"name": "spellbook_sale_record", "arguments": {"qty": 1, "finish": "nf", "orderId": "texte", "condition": "NM", "productId": "texte", "marketplace": "tcg"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_deal_board≈ 627 tokens

  Read the Sealed Deal Board: sealed boxes and decks that third-party stores list, one row per product. Each row carries the store, productUrl, retailerPriceUsd, marketPrice (the product's TCGplayer market price, USD), anchorPriceUsd with anchorSource, tcgProductId, shippingPolicy and age stamps: firstSeenAt (the day the board first carried that product), firstSeenBasis, priceBeatenAt with priceBeatenFromUsd (the day its cheapest price fell at least 5% and at least $10 under its own trailing 30-day low), and recencyEventAt, the later of the two, so you can answer "what is new since <date>" without diffing the whole board. Filter by game and productType (for example booster_display); results come in pages of limit rows with nextCursor, which is null on the last page. A caller with no account, or without Investor access, gets the public preview the website shows: a few rows per currency with entitled false. A caller with Investor access gets the full board. Call spellbook_sealed_product_offers with a row's tcgProductId for every store's offer and the sold comparables. Rows arrive in the board's order. Compare retailerPriceUsd with marketPrice yourself; this returns facts and ranks nothing by recency or discount.

  Paramètres, retour & exemple (4)

  Paramètres

  • game · string · optionnel · mtg | riftbound | pokemon
    Restrict rows to one game: mtg, riftbound or pokemon. Omit to include all games.
  • limit · integer · optionnel
    Maximum deal rows per page, 1 to 50. Omit for the default of 15.
  • cursor · string · optionnel
    Opaque nextCursor from the previous page, passed back unchanged with the same game and productType. Omit to start from the first page.
  • productType · string · optionnel · booster_display | collector_box | commander_deck | theme_deck | planeswalker_deck | starter_kit | challenger_deck | precon
    Restrict rows to one sealed product type, for example booster_display for a booster box or collector_box. Omit to include every type.

  Exemple d'appel

  {"name": "spellbook_sealed_deal_board", "arguments": {"game": "mtg", "limit": 1, "cursor": "texte", "productType": "booster_display"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_intent_default_set≈ 351 tokens

  Set a workspace rule for future extension-captured sealed purchases. An exact game and productType wins over wildcard rules. Read spellbook_sealed_intent_defaults before and after; existing units keep their current marks.

  Paramètres, retour & exemple (4)

  Paramètres

  • game · string · requis · mtg | riftbound | pokemon | *
    The game to match, or * for every game. Required.
  • intent · string · requis · open | hold
    The capture intent: open or hold. This does not physically open or list stock. Required.
  • productType · string · requis · booster_display | collector_box | commander_deck | theme_deck | planeswalker_deck | starter_kit | challenger_deck | precon
    The sealed product type to match, or * for every type. Required.
  • workspaceId · string · requis
    The workspace whose rule to set. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_intent_default_set", "arguments": {"game": "mtg", "intent": "open", "productType": "booster_display", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_intent_defaults≈ 192 tokens

  Read a workspace's future sealed-purchase open or hold defaults. Call this before changing how extension-captured products are classified. These rows affect future captures only; spellbook_sealed_portfolio reports marks already on physical units.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace whose defaults to read. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_intent_defaults", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_listing_pause≈ 511 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

  • game · string · optionnel · mtg | riftbound | pokemon
    The product game. Defaults to mtg.
  • kind · string · requis · box | pack | case
    The sealed kind from the same portfolio row. Required.
  • boxId · string · requis
    The exact TCGplayer sealed product id from the portfolio row. Required.
  • channel · string · optionnel · manapool | tcgplayer
    Marketplace whose managed listing should be removed. Defaults to manapool.
  • language · string · optionnel
    The product language code. Defaults to EN.
  • workspaceId · string · requis
    The workspace that owns the listing. Required.
  • idempotencyKey · string · requis
    A unique request key for this removal, such as a new UUID. If the result is uncertain, preview current state before deciding on another pause. Required.
  • expectedIntentRevision · integer · requis
    The non-null intentRevision from a fresh spellbook_sealed_listing_preview. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_listing_pause", "arguments": {"kind": "box", "boxId": "texte", "workspaceId": "texte", "idempotencyKey": "texte", "expectedIntentRevision": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_listing_preview≈ 810 tokens

  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, and removed confirms a zero-quantity removal. Pass this preview's channel, ask, and revisions to spellbook_sealed_listing_submit.

  Paramètres, retour & exemple (12)

  Paramètres

  • cap · integer · optionnel
    The most units to offer at once. Omit to offer every eligible unit.
  • game · string · optionnel · mtg | riftbound | pokemon
    The game of the product. Defaults to mtg.
  • kind · string · requis · box | pack | case
    The sealed kind, the kind on the same spellbook_sealed_portfolio row. Required, because units are counted by kind and boxId together.
  • boxId · string · requis
    The TCGplayer product id of the sealed product, the boxId on a spellbook_sealed_portfolio row. Required.
  • channel · string · optionnel · manapool | tcgplayer
    Marketplace to preview. Defaults to manapool.
  • floorUsd · number · optionnel
    undercut only. The lowest ask in USD the rule may choose. Omit to use catalog market times floorMarketFraction.
  • language · string · optionnel
    The product language code, such as EN or JA. Defaults to EN.
  • takeover · boolean · optionnel
    True adopts a listing on the selected marketplace that SpellBook did not create. Defaults to false; pass true only after the person agrees.
  • priceRule · string · optionnel · market | undercut
    market asks the catalog market price. undercut sets the ask so the item plus the seller's own shipping lands one cent under the cheapest TCGplayer item plus shipping from another seller, never below the floor. Omit for market.
  • workspaceId · string · requis
    The workspace that holds the sealed units, from spellbook_workspaces_list. Required.
  • fixedPriceUsd · number · optionnel
    A fixed ask in USD for every unit. Omit to list at the product's current market price. Cannot be combined with priceRule.
  • floorMarketFraction · number · optionnel
    undercut only. The floor as a fraction of catalog market, used when floorUsd is omitted. Defaults to 0.9.

  Exemple d'appel

  {"name": "spellbook_sealed_listing_preview", "arguments": {"kind": "box", "boxId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_listing_submit≈ 1022 tokens

  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 it.

  Paramètres, retour & exemple (16)

  Paramètres

  • cap · integer · optionnel
    The most units to offer at once. Omit to offer every eligible unit.
  • game · string · optionnel · mtg | riftbound | pokemon
    The game of the product. Defaults to mtg.
  • kind · string · requis · box | pack | case
    The sealed kind, the kind on the same spellbook_sealed_portfolio row. Required, because units are counted by kind and boxId together.
  • boxId · string · requis
    The TCGplayer product id of the sealed product, the boxId on a spellbook_sealed_portfolio row. Required.
  • channel · string · optionnel · manapool | tcgplayer
    Marketplace to submit to. Must match the preview. Defaults to manapool.
  • floorUsd · number · optionnel
    undercut only. The lowest ask in USD the rule may choose. Omit to use catalog market times floorMarketFraction.
  • language · string · optionnel
    The product language code, such as EN or JA. Defaults to EN.
  • takeover · boolean · optionnel
    True adopts a listing on the selected marketplace that SpellBook did not create. Defaults to false; pass true only after the person agrees.
  • priceRule · string · optionnel · market | undercut
    market asks the catalog market price. undercut sets the ask so the item plus the seller's own shipping lands one cent under the cheapest TCGplayer item plus shipping from another seller, never below the floor. Omit for market.
  • workspaceId · string · requis
    The workspace that holds the sealed units, from spellbook_workspaces_list. Required.
  • fixedPriceUsd · number · optionnel
    A fixed ask in USD for every unit. Omit to list at the product's current market price. Cannot be combined with priceRule.
  • expectedAskUsd · number · requis
    proposed.askUsd from the preview. Required; a different value means the market ask changed and the call is refused.
  • idempotencyKey · string · requis
    A unique request key for this publish attempt, such as a new UUID. If the result is uncertain, preview current state before deciding on another submit. Required.
  • floorMarketFraction · number · optionnel
    undercut only. The floor as a fraction of catalog market, used when floorUsd is omitted. Defaults to 0.9.
  • expectedStockRevision · integer · requis
    proposed.stockRevision from the preview. Required; a different value means stock moved and the call is refused.
  • expectedIntentRevision · ? · optionnel
    intentRevision from the preview. Pass it unchanged, null included.

  Exemple d'appel

  {"name": "spellbook_sealed_listing_submit", "arguments": {"kind": "box", "boxId": "texte", "workspaceId": "texte", "expectedAskUsd": 1, "idempotencyKey": "texte", "expectedStockRevision": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio≈ 252 tokens

  Read a seller's sealed boxes, packs and cases, with quantity, cost basis, market price, heldQuantity, openIntentQuantity, acquisitionSource and workspaceId for each purchase entry. Call this to reconcile physical sealed stock before listing or opening it. Recovered components can have unknown allocated cost basis and an approximate recovery date. A hold differs from an actual opening; call spellbook_sealed_portfolio_hold_set to correct a holding mark.

  Paramètres, retour & exemple (1)

  Paramètres

  • workspaceId · string · requis
    The workspace whose sealed positions to read, from spellbook_workspaces_list. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio", "arguments": {"workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio_hold_set≈ 289 tokens

  Mark every still-sealed unit in one purchase entry as a long-term hold, or release that hold. A hold keeps physical inventory and market value but excludes those units from sealed listing. Read spellbook_sealed_portfolio before and after to check heldQuantity.

  Paramètres, retour & exemple (3)

  Paramètres

  • hold · boolean · requis
    True excludes live units from listing; false makes them eligible again. Required.
  • entryId · string · requis
    The exact purchase entryId from spellbook_sealed_portfolio, including the SEALED# prefix when present. Required.
  • workspaceId · string · requis
    The workspace that owns the entry. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio_hold_set", "arguments": {"hold": true, "entryId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio_open≈ 301 tokens

  Record that an exact quantity of sealed boxes or packs has already been physically opened. Use the entryId from spellbook_sealed_portfolio and read the returned counts; the same entryId and quantity safely replay after a timeout. The historical opening date stays unknown, and recordedAt means when SpellBook recorded the status. No singles are created.

  Paramètres, retour & exemple (3)

  Paramètres

  • entryId · string · requis
    The exact sealed purchase entryId from spellbook_sealed_portfolio. Required.
  • quantity · integer · requis
    Exact count of units already opened from this entry. Required.
  • workspaceId · string · requis
    The workspace that owns the sealed entry. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio_open", "arguments": {"entryId": "texte", "quantity": 1, "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio_open_intent_clear≈ 239 tokens

  Clear the plan to open every still-sealed unit in one purchase entry. Call this when spellbook_sealed_portfolio shows openIntentQuantity for stock the seller intends to keep sealed; then read the portfolio again. This preserves the units and any holding mark.

  Paramètres, retour & exemple (2)

  Paramètres

  • entryId · string · requis
    The exact purchase entryId from spellbook_sealed_portfolio. Required.
  • workspaceId · string · requis
    The workspace that owns the entry. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio_open_intent_clear", "arguments": {"entryId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio_receive≈ 244 tokens

  Mark one incoming sealed display purchase entry as physically received after the seller confirms its arrival. Call spellbook_sealed_portfolio first to identify the incoming entry, then read it again to confirm owned status. This preserves its holding mark and opening plan.

  Paramètres, retour & exemple (2)

  Paramètres

  • entryId · string · requis
    The exact incoming display entryId from spellbook_sealed_portfolio. Required.
  • workspaceId · string · requis
    The workspace that owns the incoming entry. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio_receive", "arguments": {"entryId": "texte", "workspaceId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_portfolio_record≈ 541 tokens

  Record one sealed acquisition the customer has already made, so the buy can be scored later against what it cost. Names the catalog boxId, the quantity, the unit price paid as a decimal string, and the acquisition date. Use it after a seller buys a box, pack or case found through spellbook_sealed_deal_board. It records a purchase that happened; it never buys anything and moves no money.

  Paramètres, retour & exemple (7)

  Paramètres

  • boxId · string · requis
    Exact sealed catalog product id, from spellbook_sealed_product_search or spellbook_sealed_deal_board. An id the catalog does not hold is refused. Required.
  • quantity · integer · requis
    How many units of this product were bought. Required.
  • salesTaxUsd · string · optionnel
    Sales tax paid on the whole order in USD, as a decimal string. Optional.
  • workspaceId · string · requis
    The workspace to record this sealed buy in, from spellbook_workspaces_list. Required.
  • acquisitionDate · string · requis
    The date the buy happened, as YYYY-MM-DD. Required, and it sets which day's modeled EV the purchase is scored against.
  • acquisitionPrice · string · requis
    Price paid PER UNIT in USD, as a decimal string such as "114.99". Not the order total. Required.
  • acquisitionChannel · string · optionnel
    Where the product was bought, such as a store name or marketplace. Optional, and it is stored as the customer stated it.

  Exemple d'appel

  {"name": "spellbook_sealed_portfolio_record", "arguments": {"boxId": "texte", "quantity": 1, "workspaceId": "texte", "acquisitionDate": "texte", "acquisitionPrice": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_product_offers≈ 282 tokens

  Inspect one exact TCG product ID's sealed offers and their source times. Each offer includes the exact store listing, its local price, the crawl's actionability observation, and the selected exit comparable with its evidence date. Checkout shipping, tax, and available quantity are explicitly unknown until checked with the store. Opening EV is not intact resale value. Empty title or null computedAt can mean missing snapshot.

  Paramètres, retour & exemple (2)

  Paramètres

  • region · string · optionnel · US | CA | NZ | All
    Restrict retail references to one currency region: US, CA, NZ or All. Omit for all.
  • tcgProductId · string · requis
    Exact TCGplayer product id for this sealed product, digits only. Required.

  Exemple d'appel

  {"name": "spellbook_sealed_product_offers", "arguments": {"tcgProductId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• spellbook_sealed_product_search≈ 736 tokens

  Search sealed catalog identity and available offer records by a third-party listing's name, set and product type. catalogMatches covers boxes, packs and cases, returning exact product IDs, kind, physicalLanguage, form, contentsState, intact marketPrice with marketPriceObservedAt, coverage (priceState, modelState, evState, totalEv, missingInput), and a cached pokemonEvDisplay when available. A Pokemon tier partial gives a numeric priced-component value with valueScope and missingFields; it may include an exact identified promo. It is not full product EV or a lower bound and must not be ranked as one. Its marginal rate sensitivity is not an opening percentile or joint confidence interval. A zero-observation rare-tail gross bound, when present, uses the stated maximum copies per pack, representative independent packs and frozen subtype prices; it ignores displaced card value and is not added to the central partial value. products returns deal rows with modeled totalEV and offer evidence when supported. Call spellbook_sealed_product_offers with a deal row's tcgProductId for retail references, available sold comparables and freshness. This tool carries no per-pack distribution; for how many packs until opening is likely profitable, how swingy a box is, or what share of packs beat the pack price, call spellbook_box_ev_rankings with q set to the product name. The backend chooses the public or entitled response. A public response sets teaser true and returns fewer deal rows.

  Paramètres, retour & exemple (7)

  Paramètres

  • q · string · optionnel
    Free-text product name search. Omit to browse without a name filter.
  • game · string · optionnel · mtg | riftbound | pokemon
    Restrict results to one game: mtg, riftbound or pokemon. Omit for a mixed-game search.
  • limit · integer · optionnel
    Maximum rows to return, 1 to 100. Omit for the default of 20.
  • store · string · optionnel
    Exact store name to filter to. Omit to include every store.
  • cursor · string · optionnel
    Opaque cursor from a previous page, passed back unchanged. Omit to start from the first page.
  • region · string · optionnel · US | CA | NZ | All
    Restrict results to one currency region: US, CA, NZ or All. Omit for all.
  • productType · string · optionnel
    Exact sealed product type to filter to. Omit to include every type.

  Exemple d'appel

  {"name": "spellbook_sealed_product_search", "arguments": {"q": "texte", "game": "mtg", "limit": 1, "store": "texte", "cursor": "texte", "region": "US"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

+ 17 autres outils (affichage limité à 120).

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://api.spellbook-finance.com/mcp