SuperCatch

Apply only the exact card prices explicitly confirmed by the user. Use after a reviewed preparation returns signed tokens for those confirmed prices; confirmed must be true. Fresh recommendations, ongoing repricing and publishing are outside this operation. Returns per-listing applied, skipped or uncertain outcomes and their totals; a batch can partially succeed. Requires OAuth store:prices:write consent. The connected account must own an approved store. Writes approved listing prices and normal pricing history, cache, notifications and marketplace-sync state; no stock, order or automation settings change. Unconfirmed, expired or changed proposals are refused. Uncertain outcomes require checking current prices before retrying.

{"confirmed":true,"tokens":["signed-approval-from-the-reviewed-preparation"]}

Discover SuperCatch's machine-readable API and authentication specifications. Use when configuring an API client or finding OpenAPI, API-catalog and OAuth discovery documents; no arguments are needed. Card searches, account data and answers from help articles are outside this catalog. Returns links for agent access, API catalog, OpenAPI, documentation feeds and REST/MCP OAuth metadata as text. Public; no sign-in required. Read-only; this does not authorize an account connection or call the listed APIs. Transport/server failures remain errors; no marketplace or account lookup is performed. HTTP 429 includes Retry-After.

{}

Resolve a known help topic to its public SuperCatch page. Use when a navigation link is needed for buying, selling, shipping, returns or assistant setup. This returns a page link, not searched documentation excerpts or API schemas. Returns a public help or documentation URL as text; topic uses the advertised enum. Public; no sign-in required. Read-only; no account or order changes. A missing topic returns a tool error; an unrecognized topic resolves to general help.

{"topic":"help"}

Return one owned listing photograph as actual MCP image content for visual inspection. Use when identifying visible card details, checking a pictured label or comparing front/back views. Obtain listingId and image order from list_store_listings; imageIndex defaults to zero. Use list_store_listings for image URLs without loading pixels. Use get_product for public offer facts. Photographs alone do not certify grade or authenticity, and this tool cannot inspect arbitrary URLs or another seller's private listing. Returns one metadata-stripped JPEG image block plus listing ID, source URL, image count/index and actual dimensions. maxEdge defaults to 1024; 768 and 1536 are supported. Images preserve aspect ratio without cropping or enlargement. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; downloads and resizes the selected image without changing listings, source files, prices or inventory. Unowned/deleted listings, missing indexes and unsafe/unsupported images return no image. Download, decoding and size failures remain errors; request maxEdge 768 if the encoded image exceeds the budget. Missing details must not be inferred.

{"listingId":"owned-listing-id"}

{"imageIndex":1,"listingId":"owned-listing-id","maxEdge":1536}

Look up current public offer facts for a known product or listing slug. Use when a product has already been identified and its sale-aware price or availability needs checking. Keyword discovery and seller-private inventory are outside this lookup. Returns title, in-stock USD price range, active-listing count, lowest-price condition and canonical product URL as text. Public; no sign-in required. Read-only; no stock reservation or price changes. Unknown or unpublished products return a no-match message. Out-of-stock products omit prices; missing slugs return a tool error.

{"slug":"1999-pokemon-base-set-charizard-4"}

Summarize the connected seller's store inventory; no arguments are needed. Use for an aggregate stock overview rather than individual listing details. Per-card prices, sales orders and stock adjustments are outside this summary. Returns counts by listing status, totalListings, totalQuantity and totalQuantityAvailable for the owned store. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; no quantities are reserved or changed. An account without an approved store receives a tool error; an empty store returns zero counts.

{}

Find one public seller storefront from its URL username. Use when the seller's username or storefront URL is already known. Private stock, sales and orders are not exposed by this public lookup. Returns the canonical public storefront URL as text. Public; no sign-in required. Read-only; no store settings or inventory changes. Missing usernames and unknown, inactive or private stores return a tool error; a private store's details remain hidden.

{"username":"example-store"}

Read the public MCP support workflow and privacy contract for the connected SuperCatch server. Use to find the central public-directory issue, receipt, reopen, owner, change-feed and voluntary outcome tools, or the manual REST base. This does not submit an issue, record an outcome, read a private case, forward a credential, or subscribe a webhook. Returns a strict public-directory support descriptor; use the canonical endpoint with the central lookup tool when locating this listing. Requires OAuth docs:read consent. Requires existing docs:read consent; does not request a new write grant. Read-only; no network request, report, telemetry, private case access or subscription is performed. Invalid arguments are refused. Central support availability is independent from this local descriptor.

{}

List purchases made by the connected buyer, newest first. Use to review purchase status or totals; status filters purchases and nextCursor continues with the same status and limit. Orders placed with a seller's store and order mutations are outside this purchase history. Returns orders with IDs, status, item counts, totals and dates, plus pagination and generation time. Requires OAuth account:read consent. Read-only; no cancellation, refund or fulfillment changes. No matches return an empty page; malformed continuation cursors return a tool error.

{"limit":3}

List the connected account's saved watched listings. Use to review saved cards and price-alert targets; nextCursor continues the watchlist with the same limit. General marketplace discovery and adding/removing watches or alerts are outside this read. Returns watched items with title, price, condition, listing status, alert target and product URL, plus total and pagination. Requires OAuth account:read consent. Read-only; no watchlist or notification settings change. No matches return an empty page; malformed continuation cursors return a tool error.

{"limit":3}

List individual listings owned by the connected seller's store, newest first. Use to inspect listing-level prices, quantities or status; nextCursor continues with the same status filter and limit. Aggregate stock counts, customer purchases and changing listings are outside this read. Returns listing rows with status, condition, price, quantity and product URL, plus pagination and generation time. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; no repricing, stock reservation or publication. An account without an approved store receives a tool error. No matches return an empty page; malformed continuation cursors return a tool error.

{"limit":3}

List orders placed with the connected seller's store, newest first. Use for seller fulfillment oversight; status filters sales orders and nextCursor continues with the same filters and limit. The buyer's personal purchases, shipping updates and refunds are outside this read. Returns store order numbers, status, totals, tracking and dates, plus pagination and generation time. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; no order, payment or tracking changes. An account without an approved store receives a tool error. No matches return an empty page; malformed continuation cursors return a tool error.

{"limit":3}

Prepare exact one-time card price changes for explicit user confirmation. Use when the user wants an in-chat price update. Supply updates with owned listingId and exact USD price pairs, or a strategy selection; never combine them. Omitted strategy uses the store setting. Recurring pricing, inventory quantities and listing publication are outside this proposal. Returns old/proposed prices, market guidance with timestamp/usability, cached lowest catalog asking price when available, skipped reasons and signed approvals valid ten minutes. Cached catalog asks are not live or grade-matched sold comps. Requires OAuth store:prices:write consent. Write consent is required because this preparation issues price-update approvals. The connected account must own an approved store. Read-only; issuing approvals does not apply prices or enable automation. Unknown/unowned or unavailable custom listings and mixed input modes are refused. Holds, sale prices and seller price bounds prevent custom approvals; strategy proposals also require usable market guidance.

{"cardType":"RAW","direction":"ANY","strategy":"AT_MARKET"}

{"updates":[{"listingId":"owned-listing-id","price":1.13}]}

Preview changes to ongoing repricing for the connected seller's cards. Use to review recurring behavior; automationMode is required and direction must be ANY, independently of one-time price direction. One-time price changes and marketplace exports are outside this action. Returns current listing modes, store cadence, eligible rows and a website review URL; nextCursor continues the same selection. Requires OAuth store:read consent. The connected account must own an approved store. Read-only. Website confirmation can change store-wide strategy and selected-card enrollment; this preview changes neither. Missing automationMode, non-ANY direction and malformed cursors return tool errors; no settings are changed.

{"automationMode":"RECOMMEND_ONLY","cardType":"ALL","direction":"ANY"}

Preview one-time price changes for the connected store's RAW, graded or all cards. Use when researching current, market and cached lowest asking prices, or comparing strategy proposals before website approval. An omitted strategy uses the store setting. Use prepare_card_price_updates for exact custom prices or in-chat approvals. This read does not grant write approval or configure recurring repricing. Returns current/market/proposed prices, market timestamp/usability, any cached lowest eBay catalog ask, skipped reasons, nextCursor and a website review URL, without approval tokens. Catalog asks are not live or grade-matched sold comps. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; no prices, strategy, enrollment or export jobs change. Invalid selections/cursors or unowned integrations fail; unsuitable guidance, checkout holds and sale-priced copies are skipped.

{"cardType":"GRADED","direction":"INCREASE","strategy":"PREMIUM"}

Preview publishing owned listings through a connected marketplace account. Use to review an enabled integrationId from publishing.targets and the cards associated with that destination. This is a publishing review, not a price update or recurring-pricing enrollment. Returns publishing targets, the selected connection, displayed cards and a website review URL; publishing includes all displayed cards regardless of price direction. Requires OAuth store:read consent. The connected account must own an approved store. Read-only; a separate website confirmation is required to queue a normal export job. Missing, disabled or unowned integration IDs return tool errors; marketplace-specific export rules still apply after confirmation.

{"cardType":"ALL","integrationId":"connection-id-from-publishing-targets"}

Search documentation using the connected account's current permissions. Use for account-restricted or staff guidance; omitting query returns the permission-filtered table of contents. Public-only questions do not need account access, and sign-in does not itself grant staff permissions. Returns visible documents and cited passages with versions and review dates; query plus documentId narrows the search to that document. Requires OAuth docs:read consent. Staff guides additionally require current staff permissions. Read-only; access is checked against the current role without modifying documentation. Missing/insufficient consent produces HTTP 401/403; unavailable documents are omitted and invalid queries return a tool error.

{"limit":3,"query":"store pricing"}

{}

Find public trading-card and collectibles listings by keyword. Use when discovering public cards by player, set, year or product words before a product slug is known. Refine query words to narrow results; this tool returns only the first ranked page, with no cursor or page argument. A search summary is not a current offer lookup, private inventory report or repricing proposal. Returns top-ranked titles, slugs, canonical URLs, total matches, listing counts and list-price floors in USD; unlisted catalog matches may have a labeled market value. Use the returned search-page link for more matches. Public; no sign-in required. Read-only; no purchases, watchlist edits or price changes. No matches return a search link and any spelling suggestion; missing search terms return a tool error. HTTP 429 includes Retry-After. Use get_product when a product slug is known or a search match needs its current sale-aware price and availability. Use list_store_listings when the connected seller needs their own listing rows and statuses. Use get_store_inventory when the connected seller needs aggregate stock counts. Use preview_card_prices when the connected seller wants a repricing proposal instead of public discovery.

{"limit":3,"query":"Pikachu"}

Browse or search only publicly readable SuperCatch documentation. Use for public how-to questions: omit query for the table of contents, or select documentId to restrict the document. Account-restricted and staff guides are excluded; API discovery links and help-page navigation are separate resources. Returns documents and cited passages with URLs, versions and review dates; query plus documentId searches only that document. Public; no sign-in required. Read-only; no account connection or content edits. Unknown/invisible documents and unmatched words return empty results; invalid query parameters return a tool error.

{"limit":3,"query":"shipping"}

{}

Commit only the exact plan approved in the native web application, once per stable idempotency key. The local receipt and queued follow-up remain separate outcomes. Use the exact owned listing ID and version from SuperCatch's native listing surface. Inventory changes require a separately approved native plan. No pricing, listing identity/content, order, publication or provider-quantity verification changes. A queued follow-up is not provider acceptance. Returns a strict inventory.adjust plan, durable operation receipt or bounded history page. Approval references, credentials and private follow-up details are never returned. Requires OAuth store:inventory:write consent. Requires separate store:inventory:write consent and current EDIT_LISTINGS permission on an approved owned store. One exact listing per plan; plans expire after nine minutes; execution accepts only plan ID, stable idempotency key and the native approval reference when supplied by the approved flow. Commits one approved native stock adjustment and reason-history receipt, then schedules the reviewed marketplace, merchant, webhook and search follow-ups. Queueing does not establish provider acceptance or live channel inventory. Foreign or stale listings, changed reservations or recipients, revoked consent, mismatched plans and reused keys for another intent fail. After an uncertain response, recover the same operation with its original key before any new adjustment.

{"idempotency_key":"inventory-adjustment-0001","plan_id":"inventory-plan-id"}

Save the exact prepared catalog link, draft seller notes and optional photo permutation or rotation to the same DRAFT once per durable intent. Reuse the original key after a lost response; replays only inspect receipts and never repeat uploads or native saves. Rotation requires verified output bytes, a consumed artifact receipt and the exact committed photo state before reporting success. Save front and back photos through SuperCatch's authenticated /store/listings/new flow, inspect that owned DRAFT and select an exact existing catalog card. Prepare and execute a single frozen update to that same draft. No arbitrary photo URLs, chat-attachment ingestion, new catalog rows, grading or authenticity verification, price, inventory or publication changes. A strict canonical plan or durable operation envelope with exact listing, catalog and version references. Private photo and card-data snapshots stay server-side. Requires OAuth store:listings:drafts:write consent. Requires separate store:listings:drafts:write consent and current EDIT_LISTINGS permission on an approved owned store. Optional photo order additionally requires store:listings:drafts:images:write; existing catalog/copy grants never acquire photo-write authority. Existing read and price grants do not authorize drafts. One draft per plan; nine-minute expiry; execute accepts only the plan and stable idempotency key. Preparation persists an expiring plan. Execution saves an exact catalog link, optional draft seller notes and either a frozen photo permutation or one explicit photo rotation through the native save-drafts owner. Photo changes require additional photo-write consent. Rotation retains its stable base and originals and creates a complete verified artifact set with a durable receipt; ambiguous uploads are never repeated. The listing remains DRAFT; there are no marketplace writes. Missing or foreign drafts, unowned preserved originals, incomplete photo pairs, stale versions, changed catalogs and revoked a…

{"idempotency_key":"draft-update-00000001","plan_id":"draft-plan-id"}

Submit up to five still-queued frozen drafts to PENDING through the native owner. Reuse the same plan and original idempotency key to continue remaining items or recover lost responses. No marketplace publication occurs. Submit an explicit frozen set of existing owned DRAFT listings that already pass SuperCatch's native readiness checks to its internal moderation queue. Does not approve or activate listings, publish to marketplaces, bypass moderation, repair blockers, change prices or stock, or select by a live search filter. A strict listing.draft.submit plan or durable per-item operation receipt. Public pages contain at most five items with whole-selection totals and a bound continuation cursor; private policy fingerprints stay on the server. Requires OAuth store:listings:drafts:submit consent. Requires separate store:listings:drafts:submit consent, an approved owned store and current EDIT_LISTINGS permission. Draft-edit, price and inventory consent do not imply submission authority. Frozen membership is limited to 100 targets; plans expire after nine minutes. Native activity provides inspection and continuation without bypassing the original grant. Preparation persists an expiring frozen manifest. Execution attempts up to five queued items through the native bulk-submit owner. Each DRAFT-to-PENDING commit and item receipt share one transaction; marketplace publication is not requested. Missing drafts, stale versions or readiness changes fail without substituting other targets. After a lost response, recover the original key or operation. A repeated execution continues only queued items; completed items are never submitted again. Unknown outcomes require reconciliation before new intent.

{"idempotency_key":"draft-submission-00000001","plan_id":"submission-plan-id"}

Execute only the persisted exact plan approved in SuperCatch. Supply a stable idempotency key; retries recover the same operation. Recheck current authority and price policy for each unfinished target. Use for an exact, frozen seller price workflow under this connection's separate price-write consent. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a strict baseline plan, durable operation or history envelope with explicit local outcomes. Stored approval tokens and worker lease IDs are never returned. Requires OAuth store:prices:write consent. Requires store:prices:write and current EDIT_LISTINGS permission on an approved owned store. Plans expire in nine minutes and contain up to 125 exact listing IDs. Each execution call processes at most five remaining targets. Reuse the original plan/key until terminal; released leases can continue immediately and abandoned leases wait two minutes. Status reads do not resume work. Plan and item reads are paginated. Applies the trusted-web-approved exact plan once per durable idempotency key. Uses normal price history, notifications, cache and marketplace-sync follow-ups; a local receipt is not provider acceptance. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"idempotency_key":"seller-price-change-0001","plan_id":"price-plan-id"}

Find pricing operations owned by this connection and store, optionally by the original client idempotency key after losing an initial response. Live pages use bound cursors; previous grants and other stores remain inaccessible. Recover or inspect an operation without resuming execution. Omit action for legacy pricing; set action to listing.draft.update for saved photo drafts , inventory.adjust for native stock corrections, or listing.draft.submit for frozen internal review submissions. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a concrete pricing, listing.draft.update , inventory.adjust or listing.draft.submit operation/history envelope selected by the read action. Inventory receipts confirm local stock/history only, not provider inventory. Public; no sign-in required. Pricing reads require store:prices:write, listing.draft.update requires store:listings:drafts:write, inventory.adjust requires store:inventory:write, and listing.draft.submit requires store:listings:drafts:submit. Each rechecks live consent, approved store ownership and EDIT_LISTINGS permission. Records remain isolated by actor, store, grant, environment and action. Reads durable activity and local results without resuming execution. An explicit pricing reconcile_channel may perform the documented read-only provider probe. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"idempotency_key":"seller-price-change-0001"}

Discover installed seller read handlers, required scopes and separate support, configuration, authority and readiness states. Use supercatch_get_capabilities for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth account:read consent. Returns only the current verified connection; discovery cannot grant access. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{}

Check current connection authority and approved-store access; provider health requires the separate integration tool. Use supercatch_get_connection_health for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth account:read consent. Returns only the current verified connection; discovery cannot grant access. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{}

Inspect the authenticated principal, granted scopes, store access, versions and environment. Use supercatch_get_context for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth account:read consent. Returns only the current verified connection; discovery cannot grant access. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{}

Read the canonical integrations dashboard health summary, optionally for its connection_id. Summary connection IDs identify merged dashboard destinations, not every underlying provider account. No live provider auth probe is performed: authorization/availability remain unknown rather than inferred from enabled or connected state. This is not listing-level acceptance or live-price verification. Use supercatch_get_integration_health for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{}

Read an existing exact inventory plan and its native approval state without changing stock. Use the exact owned listing ID and version from SuperCatch's native listing surface. Inventory changes require a separately approved native plan. No pricing, listing identity/content, order, publication or provider-quantity verification changes. A queued follow-up is not provider acceptance. Returns a strict inventory.adjust plan, durable operation receipt or bounded history page. Approval references, credentials and private follow-up details are never returned. Requires OAuth store:inventory:write consent. Requires separate store:inventory:write consent and current EDIT_LISTINGS permission on an approved owned store. One exact listing per plan; plans expire after nine minutes; execution accepts only plan ID, stable idempotency key and the native approval reference when supplied by the approved flow. Read-only; rechecks current inventory-write consent, owned-store access and listing edit authority. Foreign or stale listings, changed reservations or recipients, revoked consent, mismatched plans and reused keys for another intent fail. After an uncertain response, recover the same operation with its original key before any new adjustment.

{"plan_id":"inventory-plan-id"}

Inspect one owned listing ID, version, card identity, certification, asking/effective sale prices, stock and image references. Catalog IDs alone never select a seller copy. Images include at most the first four references; use supercatch_get_listing_images for selected indexes. Lifecycle state does not imply publication eligibility. Use supercatch_get_listing for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"listing_id":"owned-listing-id"}

Resolve saved native draft identity fields into up to five existing catalog candidates. Read compatibility blockers and choose an exact ID and family; matching does not select or verify a card. No visual or paid inference runs. Save front and back photos through SuperCatch's authenticated /store/listings/new flow, inspect that owned DRAFT and select an exact existing catalog card. Prepare and execute a single frozen update to that same draft. No arbitrary photo URLs, chat-attachment ingestion, new catalog rows, grading or authenticity verification, price, inventory or publication changes. A strict canonical plan or durable operation envelope with exact listing, catalog and version references. Private photo and card-data snapshots stay server-side. Requires OAuth store:listings:drafts:write consent. Requires separate store:listings:drafts:write consent and current EDIT_LISTINGS permission on an approved owned store. Optional photo order additionally requires store:listings:drafts:images:write; existing catalog/copy grants never acquire photo-write authority. Existing read and price grants do not authorize drafts. One draft per plan; nine-minute expiry; execute accepts only the plan and stable idempotency key. Read-only native catalog matching of the owned draft's saved identity fields; no visual matching, paid inference or automatic selection. Missing or foreign drafts, unowned preserved originals, incomplete photo pairs, stale versions, changed catalogs and revoked authority fail. After a lost response, inspect the same operation or find it by its original key; unknown outcomes must not be retried as new intent.

{"expected_version":"2026-11-04T16:00:00Z","limit":5,"source_draft_id":"owned-draft-id"}

Inspect the exact frozen draft update without saving or executing it. Save front and back photos through SuperCatch's authenticated /store/listings/new flow, inspect that owned DRAFT and select an exact existing catalog card. Prepare and execute a single frozen update to that same draft. No arbitrary photo URLs, chat-attachment ingestion, new catalog rows, grading or authenticity verification, price, inventory or publication changes. A strict canonical plan or durable operation envelope with exact listing, catalog and version references. Private photo and card-data snapshots stay server-side. Requires OAuth store:listings:drafts:write consent. Requires separate store:listings:drafts:write consent and current EDIT_LISTINGS permission on an approved owned store. Optional photo order additionally requires store:listings:drafts:images:write; existing catalog/copy grants never acquire photo-write authority. Existing read and price grants do not authorize drafts. One draft per plan; nine-minute expiry; execute accepts only the plan and stable idempotency key. Read-only inspection of an existing plan. Missing or foreign drafts, unowned preserved originals, incomplete photo pairs, stale versions, changed catalogs and revoked authority fail. After a lost response, inspect the same operation or find it by its original key; unknown outcomes must not be retried as new intent.

{"plan_id":"draft-plan-id"}

Run the native submission precheck for one exact owned DRAFT and current version. Report blockers and missing fields without changing the listing or authorizing publication. Check whether an actor-owned DRAFT from SuperCatch's native photo workflow passes the current submission precheck. Drafts with zero or one saved photo can be assessed. Use the exact listing ID and version from the seller's draft surface. This does not authorize publication or change the draft. It does not grade cards, verify authenticity, inspect image storage by HEAD request, call paid services or submit the listing. Returns a bounded native blocker assessment, missing fields and a link to the existing DRAFT. Image content is not verified and publication is never authorized. Requires OAuth store:listings:drafts:write consent. Requires separate store:listings:drafts:write consent, current EDIT_LISTINGS permission and a DRAFT owned by this actor through SuperCatch's native photo workflow. Existing read and price grants do not authorize draft access. Read-only native submission precheck; no listing mutation, image-storage HEAD request, paid service call or publication request. Missing or foreign drafts, a changed version or unavailable native readiness checks return an error. The tool never changes the draft to clear a blocker.

{"expected_version":"2026-11-04T16:00:00Z","source_draft_id":"owned-draft-id"}

Read up to four owned image references in persisted order. Omit image_indexes for the first four, or supply exact zero-based positions. No pixels are downloaded; call get_listing_image with listingId and imageIndex for a bounded JPEG. Missing dimensions, media type and byte size stay unknown; images cannot certify authenticity or grade. Use supercatch_get_listing_images for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"image_indexes":[0,1],"listing_id":"owned-listing-id"}

Inspect a page of the exact frozen draft membership and versions. Keep the page size when following next_cursor; this never changes membership or submits drafts. Submit an explicit frozen set of existing owned DRAFT listings that already pass SuperCatch's native readiness checks to its internal moderation queue. Does not approve or activate listings, publish to marketplaces, bypass moderation, repair blockers, change prices or stock, or select by a live search filter. A strict listing.draft.submit plan or durable per-item operation receipt. Public pages contain at most five items with whole-selection totals and a bound continuation cursor; private policy fingerprints stay on the server. Requires OAuth store:listings:drafts:submit consent. Requires separate store:listings:drafts:submit consent, an approved owned store and current EDIT_LISTINGS permission. Draft-edit, price and inventory consent do not imply submission authority. Frozen membership is limited to 100 targets; plans expire after nine minutes. Native activity provides inspection and continuation without bypassing the original grant. Read-only inspection; does not continue submission. Missing drafts, stale versions or readiness changes fail without substituting other targets. After a lost response, recover the original key or operation. A repeated execution continues only queued items; completed items are never submitted again. Unknown outcomes require reconciliation before new intent.

{"limit":5,"plan_id":"submission-plan-id"}

Recover one exact pricing operation and its committed local prices/versions. Optional reconcile_channel performs one live read of a frozen target on this result page. Supports individual eBay fixed-price offers; compares explicit USD against current channel adjustments, separately from local completion. Other providers, auctions, discounts and shared offers remain unavailable. Never submits or repairs prices. Recover or inspect an operation without resuming execution. Omit action for legacy pricing; set action to listing.draft.update for saved photo drafts , inventory.adjust for native stock corrections, or listing.draft.submit for frozen internal review submissions. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a concrete pricing, listing.draft.update , inventory.adjust or listing.draft.submit operation/history envelope selected by the read action. Inventory receipts confirm local stock/history only, not provider inventory. Public; no sign-in required. Pricing reads require store:prices:write, listing.draft.update requires store:listings:drafts:write, inventory.adjust requires store:inventory:write, and listing.draft.submit requires store:listings:drafts:submit. Each rechecks live consent, approved store ownership and EDIT_LISTINGS permission. Records remain isolated by actor, store, grant, environment and action. Reads durable activity and local results without resuming execution. An explicit pricing reconcile_channel may perform the documented read-only provider probe. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"operation_id":"price-operation-id"}

Read a durable result without resuming execution. Omit action for legacy pricing; action listing.draft.update selects draft receipts under the separate draft-write scope. Recover or inspect an operation without resuming execution. Omit action for legacy pricing; set action to listing.draft.update for saved photo drafts , inventory.adjust for native stock corrections, or listing.draft.submit for frozen internal review submissions. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a concrete pricing, listing.draft.update , inventory.adjust or listing.draft.submit operation/history envelope selected by the read action. Inventory receipts confirm local stock/history only, not provider inventory. Public; no sign-in required. Pricing reads require store:prices:write, listing.draft.update requires store:listings:drafts:write, inventory.adjust requires store:inventory:write, and listing.draft.submit requires store:listings:drafts:submit. Each rechecks live consent, approved store ownership and EDIT_LISTINGS permission. Records remain isolated by actor, store, grant, environment and action. Reads durable activity and local results without resuming execution. An explicit pricing reconcile_channel may perform the documented read-only provider probe. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"operation_id":"operation-id"}

Inspect one exact owned order resolved by list_store_orders. Returns recorded totals and separate recorded shipment versus carrier-observation fields. The source does not retain currency or a provider capture timestamp, so those remain unknown; totals are not profit. Buyer addresses, contact details and payment/provider payloads are withheld. Use supercatch_list_order_items for bounded lines and supercatch_get_order_label_rates for current postage estimates. Use supercatch_get_order for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires store:read consent, a currently approved owned store and live MANAGE_ORDERS permission. Buyer addresses, contact details, payment references and raw provider data are withheld. Quotes do not authorize label purchase. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"order_id":"owned-order-id"}

Read current native postage estimates for an exact owned order and its current parcel. Returns USD carrier postage, service fee, reserve and seller share separately; null prices remain unknown during provider outages. No label is purchased or reserved. Rates have no guaranteed expiry and require fresh financial review before purchase. Inspect the order with list_store_orders first. Use supercatch_get_order_label_rates for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires store:read consent, a currently approved owned store and live MANAGE_ORDERS permission. Buyer addresses, contact details, payment references and raw provider data are withheld. Quotes do not authorize label purchase. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"order_id":"owned-order-id"}

Read an owned connection-bound price plan, its expiry and trusted approval state without changing it. Use for an exact, frozen seller price workflow under this connection's separate price-write consent. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a strict baseline plan, durable operation or history envelope with explicit local outcomes. Stored approval tokens and worker lease IDs are never returned. Requires OAuth store:prices:write consent. Requires store:prices:write and current EDIT_LISTINGS permission on an approved owned store. Plans expire in nine minutes and contain up to 125 exact listing IDs. Each execution call processes at most five remaining targets. Reuse the original plan/key until terminal; released leases can continue immediately and abandoned leases wait two minutes. Status reads do not resume work. Plan and item reads are paginated. Read-only; no execution or approval. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"plan_id":"price-plan-id"}

Read direct price evidence for up to five exact owned listing IDs without a repricing plan or write permission. Separates own asks, active sale offers, estimates and cached catalog asks. Guidance follows the shared grade, autograph, confidence and freshness policy. Missing costs mean unknown profit. Use supercatch_get_pricing_context for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"listing_ids":["owned-listing-id"]}

Read at most 90 native daily date buckets of store view events, sold units and new listing counts under live VIEW_ANALYTICS permission. Sales count quantities on PAID, PROCESSING, SHIPPED and DELIVERED orders across native and marketplace sources; views are events, not unique people or attributed conversion. Source snapshot time is preserved, but exact report interval/timezone and provider observation are unknown. Revenue, profit and currency are withheld because source currency and verified costs are absent. Listing creation time is not inventory age. No labels, financial actions or automation are executed. Use supercatch_get_sales_activity for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires store:read consent, a currently approved owned store and live VIEW_ANALYTICS permission. Cached application counts do not establish provider freshness, normalized monetary revenue, profit or inventory age. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"window_days":30}

Traverse at most 20 lines of one exact owned order. Keep the same order, connection, actor and page size; changed order versions expire the cursor. Live pages do not freeze a mutation target set. Recorded unit amounts have unknown currency; listing IDs are present only when the linked copy still belongs to this store. No buyer or payment data is returned. Use supercatch_list_order_items for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires store:read consent, a currently approved owned store and live MANAGE_ORDERS permission. Buyer addresses, contact details, payment references and raw provider data are withheld. Quotes do not authorize label purchase. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"limit":10,"order_id":"owned-order-id"}

Freeze one exact owned listing, expected version, quantity adjustment and seller reason. Inspect its reservation-aware plan and approve it in SuperCatch before execution. Use the exact owned listing ID and version from SuperCatch's native listing surface. Inventory changes require a separately approved native plan. No pricing, listing identity/content, order, publication or provider-quantity verification changes. A queued follow-up is not provider acceptance. Returns a strict inventory.adjust plan, durable operation receipt or bounded history page. Approval references, credentials and private follow-up details are never returned. Requires OAuth store:inventory:write consent. Requires separate store:inventory:write consent and current EDIT_LISTINGS permission on an approved owned store. One exact listing per plan; plans expire after nine minutes; execution accepts only plan ID, stable idempotency key and the native approval reference when supplied by the approved flow. Persists an expiring exact inventory plan for trusted native web approval; does not change stock. Foreign or stale listings, changed reservations or recipients, revoked consent, mismatched plans and reused keys for another intent fail. After an uncertain response, recover the same operation with its original key before any new adjustment.

{"delta":-1,"expected_version":"2026-11-04T16:00:00Z","listing_id":"owned-listing-id","mode":"delta","reason":"Count correction"}

Freeze one exact owned photo draft, an explicit existing catalog card, optional draft seller notes and either a full saved-photo permutation or one explicit quarter/half-turn rotation. Photo edits require additional image-write consent and preserve original archives. Rotation renders once from the stable base into new verified display artifacts; restoring the base, cropping, adding and deleting photos are unavailable. Use the native upload link for new photos before preparing. Save front and back photos through SuperCatch's authenticated /store/listings/new flow, inspect that owned DRAFT and select an exact existing catalog card. Prepare and execute a single frozen update to that same draft. No arbitrary photo URLs, chat-attachment ingestion, new catalog rows, grading or authenticity verification, price, inventory or publication changes. A strict canonical plan or durable operation envelope with exact listing, catalog and version references. Private photo and card-data snapshots stay server-side. Requires OAuth store:listings:drafts:write consent. Requires separate store:listings:drafts:write consent and current EDIT_LISTINGS permission on an approved owned store. Optional photo order additionally requires store:listings:drafts:images:write; existing catalog/copy grants never acquire photo-write authority. Existing read and price grants do not authorize drafts. One draft per plan; nine-minute expiry; execute accepts only the plan and stable idempotency key. Preparation persists an expiring plan. Execution saves an exact catalog link, optional draft seller notes and either a frozen photo permutation or one explicit photo rotation through the native save-drafts owner. Photo changes require additional photo-write consent. Rotation retains its stable base and originals and creates a complete verified artifact set with a durable receipt; ambiguous uploads are never repeated. The listing remains DRAFT; there are no marketplace writes. Missing or foreign drafts, unowned p…

{"catalog_id":"selected-catalog-id","catalog_type":"SPORTS_CARD","expected_version":"2026-11-04T16:00:00Z","source_draft_id":"owned-draft-id"}

Freeze explicit owned DRAFT IDs, their exact versions and native readiness policy for submission to SuperCatch's internal review queue. Readiness is rechecked before every native commit. Submit an explicit frozen set of existing owned DRAFT listings that already pass SuperCatch's native readiness checks to its internal moderation queue. Does not approve or activate listings, publish to marketplaces, bypass moderation, repair blockers, change prices or stock, or select by a live search filter. A strict listing.draft.submit plan or durable per-item operation receipt. Public pages contain at most five items with whole-selection totals and a bound continuation cursor; private policy fingerprints stay on the server. Requires OAuth store:listings:drafts:submit consent. Requires separate store:listings:drafts:submit consent, an approved owned store and current EDIT_LISTINGS permission. Draft-edit, price and inventory consent do not imply submission authority. Frozen membership is limited to 100 targets; plans expire after nine minutes. Native activity provides inspection and continuation without bypassing the original grant. Preparation persists an expiring frozen manifest. Execution attempts up to five queued items through the native bulk-submit owner. Each DRAFT-to-PENDING commit and item receipt share one transaction; marketplace publication is not requested. Missing drafts, stale versions or readiness changes fail without substituting other targets. After a lost response, recover the original key or operation. A repeated execution continues only queued items; completed items are never submitted again. Unknown outcomes require reconciliation before new intent.

{"targets":[{"expected_version":"2026-11-04T16:00:00Z","listing_id":"owned-draft-id"}]}

Freeze up to 125 exact listing IDs, their expected versions and chosen USD decimal amounts. Creates a persisted plan; open its approval URL for trusted web review before execution. Use for an exact, frozen seller price workflow under this connection's separate price-write consent. No inventory, order, automation settings or listing publication changes. Local completion does not establish marketplace prices. Returns a strict baseline plan, durable operation or history envelope with explicit local outcomes. Stored approval tokens and worker lease IDs are never returned. Requires OAuth store:prices:write consent. Requires store:prices:write and current EDIT_LISTINGS permission on an approved owned store. Plans expire in nine minutes and contain up to 125 exact listing IDs. Each execution call processes at most five remaining targets. Reuse the original plan/key until terminal; released leases can continue immediately and abandoned leases wait two minutes. Status reads do not resume work. Plan and item reads are paginated. Persists an exact price plan for review in SuperCatch. It does not change listing prices. Foreign, revoked or expired grants and stale versions fail. Unapproved plans require web review. Idempotency-key reuse for another plan conflicts; a lost response is recovered through supercatch_find_operations or supercatch_get_operation before any new action.

{"updates":[{"amount":"125.50","expected_version":"2026-11-03T16:00:00Z","listing_id":"owned-listing-id"}]}

Find seller-owned card copies by text, exact SKU, catalog ID, grader/grade, status, USD asking-price range and on-hand stock. A stock filter tests unsold on-hand counts before checkout holds; returned availability subtracts holds. Live cursor pages use a stable created-at/ID order and must retain the same filters and page size. Ambiguous matches remain separate candidates. Use supercatch_search_listings for this read in the connected account. Supply only the fields in its strict input schema. No prices, inventory, orders, automation, marketplace publication or provider configuration are changed. Returns a Shared MCP Baseline 1.0.0 envelope with explicit scope, provenance, unknown values, omissions and typed errors. Requires OAuth store:read consent. Requires a currently approved owned store. Prices exclude shipping and tax. Graded and raw copies remain distinct; estimates and asks are not sold transactions. Read-only and unmetered; no persistent plans or provider submissions. Invalid fields, unavailable stores and foreign or deleted targets fail without private records. Expired cursors require a fresh search. Provider failures are explicit errors.

{"grade":"10","grading_company":"PSA","query":"Topps"}