SpellBook Finance

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.

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.

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.

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.

Read one bounded page of price alerts and buylist watches saved in a workspace, with each row's type, asset, direction and threshold when present, status, and trigger fields. Filter by status or alertType. Pass nextCursor back as cursor with the same filters to continue. It reports saved alerts and does not evaluate them or say whether a price would trigger one today.

Read retained Magic card-level high-price detector observations for seven explicit UTC dates and one finish. Use it for which Magic cards hit an all-time high this week. Returns reported USD values, percent-unit changes, catalog-checked Magic labels, publication dates, missing days and coverage limits. Defaults to seven dates ending today and regular finish. Stored ATH state is per oracleId and finish; the reported printing label does not establish which printing supplied the historical price. Read guideResourceUri through MCP for metric, date and identity interpretation. Observations are not independently verified market-wide lifetime highs or trade recommendations.

Read a bounded below-floor discovery summary or one section page with member stages, scheduled minimums, canonical pricing targets, observed asks and source freshness, admission-selection facts, sales facts, and restoration status. Call it to inspect a seller workspace's configured discovery lane or follow a returned cursor. Member admissionSelection explains the factual automatic or manual choice already saved; this tool does not return a ranked recommendation queue. Observed asks are sampled listings, not continuous exposure or evidence of demand; scheduled minimum, canonical target, observed ask, and sold item price are separate facts. Use spellbook_below_floor_discovery_set with dryRun true to preview a requested change, then read this tool again after an apply.

Preview or apply an owner-requested below-floor discovery settings, printing membership, or off change. The default dry run returns exact entering, exiting and rejected rows plus the settings-only restoration effect. Call dryRun true first. If the owner asked only for a preview, stop there. If the owner explicitly authorized saving and the preview matches the requested change, apply with dryRun false and the same opaque expectedRevisionToken, previewId and change without asking for approval again. If apply returns stale, read spellbook_below_floor_discovery_get and request a new preview; never apply a refreshed selection automatically. Read the GET tool after a successful apply to confirm saved state and restoration status.

Read the existing cash-recovery scenario for one exact sealed product and caller-supplied total cost. Use it for modeled after-cost recovery and break-even timing, separately from gross opening EV or a probability of profit. Resolve the numeric product id with spellbook_sealed_product_search first. Returns the supplied assumptions, quantity, model horizon, source coverage, USD results and unknown clocks. Read the returned guideResourceUri for interpreting conditional price ceilings and a missing crossing. This read does not select a purchase price or recommend opening a product.

Read stored daily gross opening-EV observations for one exact sealed product. Use it when asked how a named box's EV changed over time. Resolve the product with spellbook_sealed_product_search first; pass its numeric tcgProductId. Returns product identity, requested dates, USD values per sealed product, dated source rows and explicit model/freshness gaps. Missing dates stay absent. Read guideResourceUri through MCP for date, valuation and model interpretation. An older history point is not today's EV. The response establishes no price-only cause or unchanged methodology.

Read a named sealed product's modeled gross contents EV, or compare ranking rows, with totalEV, evRatio, pack standard deviation (packSD), N0 and breakEvenPct. For a named Collector Booster display, use q and box_type, then match boxId to the exact catalog product; a Collector's Edition Commander deck is a different product. Default order is 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 card value under the selected valuation basis exceeds summed pack cost. It is null when required inputs are absent or matching edge or standard deviation is not positive. Pack cost is the returned packPrice: a separate stored pack reference when available, otherwise box marketPrice divided by packsPerBox. Preserve packPriceSource; a missing or unrecognized label leaves the reference origin unknown. This is not a caller-paid cost. 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). These valuations use their stated basis 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. Optional cardmarketEV carries native EUR retail singles EV, per-finish coverage, quote dates, missingFields and limitations. Its totalEV is null when coverage is incomplete. Existing top-level prices, ratios, filters and order retain their US basis; Cardmarket EV has no local sealed acquisition cost. 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. For valuation, product identity and source-clock context, read guideResourceUri through MCP; guideUrl is the same published page. A catalog entry is not its full guide body. This is modeled research evidence for a caller's decision, not a purchase instruction.

Read dated TCGCSV reference-price observations for one exact sealed box/display and an explicit historical window. Use it for a named box's price change or a retained launch-date baseline. Resolve the numeric product with spellbook_sealed_product_search first. Returns the requested identity, dates, USD Market/Low/Mid when stored, missing dates and unknown clocks. Read guideResourceUri through MCP before interpreting a since-release comparison. Use separate narrow calls for distant endpoints; the read supplies no official release date, price-change cause or realized return.

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.

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. Workspace card performance reports observed sales, sampled available channel-copy-days, uncertainty and coverage across editions/finishes; it changes no source ordering or purchase policy. 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.

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.

Read Magic price-spike observations from SpellBook Finance's buyout detector. Call it when asked which Magic cards are being bought out right now. Returns printing identity, old and new USD prices, fractional pctGain (0.25 means 25%), detection time, secondary-source confirmation, source links and explicit coverage gaps. Read guideResourceUri through MCP for interpretation and stop conditions. If guideUrl fails in a browser, spellbook_guides also discovers the guide's resourceUri. Observations are candidates, not verified buyouts. Call spellbook_card_prices with a row's scryfallId for current per-source price observations.

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.

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.

Read ONE Magic printing's stored daily price series, its recent sales and its current TCGplayer asks. Every caller gets all three, signed in or not. tcgplayerProductId is the exact printing's TCGplayer product id when known. series has one point per stored day, oldest first: priceUsd is the TCGplayer Market price SpellBook stored that day and tcgLow is the TCGplayer Low price. buckets sums Near Mint and Lightly Played sales of the requested finish with English or unspecified language by the exact raw bucketStartDate values returned by TCGplayer. The source response does not establish each bucket's duration or end date. Each row has units, transactions, a units-weighted bucket market and the lowest and highest recorded sale. If qualifying sold rows have unspecified language, limitations says so; known non-English rows are excluded. bucketsState distinguishes no stored fetch from an observed fetch; bucketsCoverage gives the first and last stored bucket dates when available. asks lists the TCGplayer listings of the requested finish from the newest unexpired snapshot, cheapest first, with item price, condition, language when known, listing shipping when known, quantity and seller name. asksTotal and asksTruncated report the source row count and truncation status when known. Each evidence family carries its own captured time. Call it after spellbook_printings_search names the printing, to see how its price moved over weeks or to compare its market series with recent sales and asks. Call spellbook_card_prices for today's price from every other source. It returns observations and limitations; it does not rank or recommend a printing. Compute any band, return or range yourself from series. Each TCGplayer product id carries tcgplayerBuyUrl, a short SpellBook Finance affiliate link to that TCGplayer page. Say it is an affiliate link when you share it.

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. For Market-versus-dealer interpretation, find a guide with spellbook_guides topic buylist-and-exits. EUR rows include the conversion rate and its recorded date/source when available. Read the returned guideResourceUri for currency and source-metric context; MCP resource retrieval is an alternative if guideUrl cannot be fetched. It is discoverable with spellbook_guides topic pricing.

Set one workspace's lane mode for one channel-lane marketplace, the switch that decides whether SpellBook reads the marketplace or changes listings there, and set the Misprint ask floor. This changes public marketplace behavior for the workspace, only the workspace owner may call it, and the agent sets a mode or a floor only after the seller chose it. 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. askFloorUsd is the lowest ask SpellBook Finance sets on Misprint. Each Misprint ask is the TCGplayer ask for the same copies, raised to that floor.

Read the listings SpellBook Finance plans on one channel-lane marketplace for a workspace. It returns the lane's enabled flag, mode, and ask floor, then one target per listing: the card, the copies it holds, the desired quantity and ask, whether the marketplace confirmed both, and what SpellBook last read from the marketplace for it. Pass itemIds to ask about specific scanned copies. Each named copy no target holds comes back in itemsWithoutTarget with a reason. Call it after spellbook_marketplace_onboarding when a seller asks what will list, what is live, or why a card did not list. Call spellbook_channel_lane_set to change the lane's mode or ask floor.

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.

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.

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.

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.

Record an already-bought collection with kind purchase and an unknown expectedQuantity, a 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.

Read one persistent collection purchase's intake counts, pending import blockers, retained intake valuation, exact-item sale/refund observations and paged immutable history. Market value is separate from realized proceeds. Missing selling costs keep net earnings unknown.

Bind an explicitly identified fresh rescan to existing intakeUnitIds without adding stock, finish or reopen intake, record a reported extra cost, preserve a dated snapshot of original intake quotes with quote dates/coverage separate from recorded time, or reconcile an original pending import's exact item IDs. Reuse the same submissionId and payload after an uncertain response. Finishing requires complete disjoint physical accounting and zero pending imports.

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.

Read exact Commander case or deck display membership and USD market-price references for an equivalent set of individual decks. A product named Case or Display, such as Bloomburrow Commander Deck Display, qualifies. Use it to compare that package with its required child quantities. Resolve the numeric case product with spellbook_sealed_product_search first. Returns source-linked recipe counts, case and component price clocks, existing gross EV snapshots, reference arithmetic, missingFields and limitations. A reference difference excludes shipping, stock, taxes and fees; unavailable delivered offers remain explicit. Use spellbook_box_ev_rankings for existing EV alternatives.

Read stored facts for one to four exact Commander case or deck products on one shared source-date window. Resolve numeric IDs with spellbook_sealed_product_search first. Returns per-product kind, market price and clock, publication revision and readiness, plus contributor rows with finish, quantity, USD Full EV contribution, aligned source-recorded units and missing-versus-zero state, a comparisonRevision, missingFields and limitations. A stale or absent input, empty window intersection, invalid mapping, missing exact card price or oversized input leaves a product not ready and the response names the gap. A missing catalog market price or clock appears in missingFields and leaves readiness unchanged, because the caller supplies the purchase price. Page with offset, limit and nextOffset; a changed revision requires restarting at offset 0.

Read cached exact Commander contents with USD Full EV contributions and source-recorded TCGplayer units. Resolve a numeric product ID with spellbook_sealed_product_search. Returns exact printing/finish, quantities, child membership, baseline 100-unit categories, compatible source-date windows, coverage, revisions, expiry, missingFields and limitations. An EV-weighted mean30d uses only value with a complete compatible 30-date observation. Partial and 29-date observations remain labeled. Market units are source-relative observations, not personal sell time. Returns no purchase verdict or ranking.

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.

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.

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

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

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.

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.

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.

Set one workspace's eBay automation mode, basic-land preference, copy cap, or month-end allowance policy after the owner chooses the setting. Month-end defaults to off with a 1,000-insertion reserve. Optional stale-single refreshes run in the final 48 hours and stop new ends two hours before the Pacific month resets. Read spellbook_ebay_month_end_status first for capacity and recovery facts. Only the workspace owner may change public listing behavior. The modes: manual: New listings and repricing stay manual. Recovery of listings already ended by month-end management can finish. 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.

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.

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.

Get the SpellBook Finance page where the seller connects their eBay account. Call spellbook_ebay_connection_status first. Hand the seller only this one link and tell them to sign in to SpellBook Finance, press Connect eBay, then sign in at eBay and approve the connection. Once they finish, call spellbook_ebay_connection_status again. The agent never receives the eBay consent URL, a password, or a token.

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.

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.

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.

Read an owner's eBay month-end policy, estimated remaining insertions, reserve, usable capacity, Pacific execution window, and current recovery counts. Remaining already includes reserved active renewals and the existing margin. It returns facts, missingFields, and limitations; it does not establish eBay's exact billing balance or a sales benefit from refreshing.

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.

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.

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.

Read one workspace's saved eBay price bands. A band is a market price range in USD for one game. Automatic eBay listing lists a copy only when its market price falls in one of its game's bands, and it ends a live copy that falls outside them. The response lists, per game, the saved bands and how many live eBay copies and live listings sit inside, outside, or without a market price. Call spellbook_ebay_price_bands_set with dryRun true to preview a different set of bands.

Preview or save per-game eBay price bands, each a market price range in USD. With dryRun true it saves nothing and returns, per game, how many live eBay copies and listings the bands would keep, end, or leave because they have no market price. With dryRun false it saves the bands and returns the same counts: SpellBook Finance then ends live eBay copies whose market price falls outside their game's bands, in the background and again in a daily sweep, and keeps out-of-band copies off eBay. A live save needs no dry run first. Only the workspace owner may call it, and the agent saves bands only after the seller chose them.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Save the seller-selected shipping mode for the caller's connected eBay account, then return the saved preference. Read spellbook_ebay_shipping_mode_get first; call spellbook_ebay_shipping_policy_set separately to configure charges. This can affect future listing and repricing work across the account's workspaces.

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

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.

End the live eBay listings for up to 25 exact copies, and keep each copy in inventory so it can be published again. Take Item ids from spellbook_inventory_items_query. Show the person which cards will come down and get a yes before calling, because a live listing ends at once. Returns one result per copy: unpublished, kept, no_listing, or failed.

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

Select one workspace for free Seller access. 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 access state and observed usage.

Read one workspace's saved giveaway config. targetMeanUsd is a budget on the band-midpoint estimate of the tier table, not the average value of the cards given. The top band's maxUsd must reach maxDrawUsd for cards near maxDrawUsd to be drawable. targetMeanUsd must stay below the per-channel marketplace price floor, or every roll refuses with target_not_below_ceiling.

Replace one workspace's saved giveaway config. Resend every field. targetMeanUsd is a budget on the band-midpoint estimate of the tier table, not the average value of the cards given. The top band's maxUsd must reach maxDrawUsd for cards near maxDrawUsd to be drawable. targetMeanUsd must stay below the per-channel marketplace price floor, or every roll refuses with target_not_below_ceiling.

Find a cataloged SpellBook Finance customer-agent guide for seller setup and onboarding, selling, pricing, sealed EV, or choosing a card or sealed-product strategy for a budget and workload. Use it when a customer asks how to make money with Magic, what to do with a bankroll or store credit, whether to open or resell sealed product, or which research route fits their goal. Returns catalog entries, not guide bodies. After a purpose and decision match the customer's question, read that entry's resourceUri through MCP before applying its rules or drafting the answer. The resource supplies the full guide, including domain conditions and missing-data stop rules. Use its URL only as a fallback. 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.

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.

Read recorded channel state, asks and saved timestamps for exact inventory copies after a listing or sync action. Returns missing evidence alongside saved facts. A saved live row does not establish completion of a new write. Use the returned job's status tool to check that job's completion.

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.

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.

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.

Mark every pending copy in the named orders or precon imports as received, which makes them owned inventory that can be listed and sold. Returns how many copies were received, their total cost and the bins they belong in. Call it when the customer says the package arrived and they counted the cards. Read spellbook_inventory_incoming first to get each acquisitionSource.

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

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.

Read the connected TCGplayer or ManaPool account's saved listing scope, server-reported legacy full-account restore eligibility, managed-copy count, and selected-policy membership-key count. The selected key count does not total legacy all-mode remote listings. Supply candidateIds only from SpellBook Finance's existing named listing rows or holdings. Results report saved facts and unresolved identities; they do not choose which rows to manage. New accounts start with no managed listings. A backfilled legacy account may restore full-account management after switching to named listings.

Change one seller-owned channel's saved listing scope. Read spellbook_inventory_management_get first. Switching legacy all mode to selected mode clears management for all current listings. On an eligible backfilled account, restore_legacy_all explicitly manages every current and future listing on that connected seller account; saved automation settings remain unchanged. In selected mode, use a named candidateId from current SpellBook Finance rows to manage or stop managing a complete listing. Stopping management leaves its live listing and order history intact. These actions save permission for existing automation and do not enable automation or publish a listing.

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.

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

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.

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.

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.

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.

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.

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.

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.

Adopt the listings in a ready preview from spellbook_marketplace_listings_adopt_preview. Each remote copy is linked to an owned item or gets a new item in the channel's import bin (EBAY-IMPORT, TCG-IMPORT or MANAPOOL-IMPORT), and the listing is recorded as managed by SpellBook. Each adopted printing gets an exact price lock at its live price. Nothing on the marketplace is edited, ended or relisted, and nothing is published. Applying runs in the background. The first answer has applyStatus applying. Call spellbook_marketplace_listings_adopt_preview with previewId latest until applyStatus is applied. Show the person the preview before the first call.

Read the live listings on the workspace's connected eBay, TCGplayer or ManaPool account and preview how each one maps to an exact printing, without changing the marketplace or inventory. Omit previewId to start a read. The read runs in the background, so the first answer has status queued or reading. Call again with previewId latest until status is ready. A ready preview lists adoptable listings with the printing, finish and condition read from each one, the facts that named it (matchSource), and how many copies link to owned items or need a new item. Unmatched listings carry one reason each. Show the person the counts and cap, then call spellbook_marketplace_listings_adopt_apply with the previewId.

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.

Read published daily/weekly card price movers or supported 30d/90d sealed reports. Returns gainers/losers, reported game/printing/finish when supplied, current and previous USD prices, stored pctChange, swing30d, cardUrl and run/publication dates. Daily/weekly reported percentages and direction lists have producer caps over covered source candidates; read the limits. Capped ties do not identify the largest uncapped market move. For what increased this week, use window=weekly, then read the pricing guide through spellbook_guides and its returned resource URI for window, cap and clock interpretation. A printing price read qualifies one reported candidate; missing source dates remain unknown.

Open one reproducible modeled Magic booster pack from an exact parent booster box ID. Omit boxId to discover current candidates for setCode (default fdn). A chosen product returns only the sampled exact printings, modeled finish, nullable USD references, seed, retained model date, missingFields and limitations. Seed is an unsigned 32-bit integer with deterministic default 0. Reusing a seed and unchanged retained model reproduces the draw. Independent weighted draws can repeat cards; factory collation and original-source completeness are unverified. Unavailable returns a concrete reason without substituting another booster. This is read-only play, not a purchase recommendation or physical inventory opening.

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.

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.