Documentation
MCP and AI Assistants
Connect SuperCatch to an assistant, understand account and store permissions, and review pricing and OAuth safeguards.
Connect an Assistant
Add SuperCatch from Claude's connector directory or use https://supercatch.com/api/mcp in a compatible MCP client. The /ai page has setup instructions for Claude, ChatGPT, Codex, Claude Code, Cursor, and VS Code. Public marketplace searches, product lookups, storefront lookups, and public documentation do not require a SuperCatch account. An OpenAI directory submission does not itself make an app publicly available; use the connection methods your client currently supports.
Your Account and Store
Signing into Claude or Codex does not automatically sign you into SuperCatch. When an assistant needs private data, SuperCatch asks you to sign in and approve OAuth access. The connection belongs to that SuperCatch account. Store tools resolve the approved store owned by that account on every request; an assistant cannot choose another owner's store by supplying a store ID. A private storefront can still be read by its authorized owner. Account orders and watchlists use account:read, store listings, inventory and orders use store:read, and account documentation uses docs:read. Staff documentation also checks your current staff role.
Inspect Listing Images
An assistant with store:read consent can inspect a listing photograph using supercatch_get_listing_image. First obtain an owned listing ID and its imageUrls order from supercatch_list_store_listings, then request one zero-based imageIndex (default 0). The tool returns actual JPEG image content and dimensions rather than only a URL. Ask for another index to inspect a reverse or alternate view; image order alone does not establish which side is pictured. maxEdge defaults to 1024, with 768 and 1536 available. The full frame is preserved without enlargement; metadata is stripped, and oversized images are refused rather than truncated. Only images saved on the connected store's non-deleted listings are eligible, and no caller-supplied URL or store ID is accepted. Inspection does not change images or listings. Client support for MCP image content is required. Images can support identification or pricing research but do not certify a grade, authenticity or details that are not visible.
Card Pricing and Confirmation
An assistant can research prices, prepare exact changes and apply them through MCP after you confirm. Grant store:prices:write separately from store:read. Ask, for example: Show market and lowest observed asking prices for my cards, then propose these listing prices for my approval. supercatch_preview_card_prices is read-only and returns current prices, condition/grade-aware market references with timestamps and usability, and cached lowest eBay catalog asking prices when available. A catalog ask is not a live quote or a grade-matched sold comp; missing references remain unavailable. supercatch_get_product reports current public SuperCatch offer prices, including sales. To choose your own prices, obtain owned listing IDs from supercatch_list_store_listings, then call supercatch_prepare_card_price_updates with updates containing listingId and exact USD price pairs. Do not combine updates with cardType, strategy, direction or cursor. Alternatively, prepare a RAW, GRADED or ALL selection using At Market, Premium or Move Fast. Strategy proposals retain market freshness, grade matching and movement safeguards. Exact custom prices need no market recommendation, but must respect supported amounts, seller floors/ceilings, current state, active-stock eligibility, sale exclusions and checkout holds. Review each old/new price and explicitly confirm before the assistant calls supercatch_apply_card_price_updates with the signed approvals and confirmed true. Preparation never writes. Approvals expire in ten minutes; changed state requires fresh preparation. Batches contain at most 50 distinct listings. Updates use normal price history and marketplace synchronization and do not enroll or change automation. Existing automation can change a price later. With read-only consent, use the returned SuperCatch review URL for strategy proposals and confirm there.
Review Card Price ChangesAutomatic Repricing
Ask your assistant to prepare automatic repricing for RAW, graded, or all cards. supercatch_preview_auto_repricing returns a read-only proposal and a SuperCatch review URL; choose OFF, RECOMMEND_ONLY, or AUTO_APPLY. You approve persistent settings in SuperCatch. Ongoing repricing uses the existing store cadence, current per-copy floors and ceilings, movement and anchor limits, freshness and checkout safeguards. Graded prices need suitable grade-specific comps; RAW aggregate comps cannot drive graded price changes. Choosing a different strategy for enabled repricing changes store-wide policy for all enrolled listings. Including graded cards also turns off Exclude Graded. Disabling affects only the selected cards. Existing recommendation-only overrides remain until you explicitly change them. The one-time direction filter does not constrain future automation; ongoing repricing may raise or lower prices under its strategy and limits. To configure automation, use Increases and Decreases. Review every batch to cover all selected inventory.
Marketplace Publishing
Ask your assistant to prepare marketplace publishing for your cards. supercatch_preview_marketplace_publish lists enabled marketplace connections belonging to your connected store and returns a review URL. It never exposes connector passwords or tokens. Choose the exact marketplace account in SuperCatch and confirm the displayed card batch. Publishing includes the displayed cards even when no market-based price proposal is available, and uses current listing data. SuperCatch queues its normal export job with its existing permissions, readiness, inventory, credential, platform and duplicate-job checks. Queue acceptance or a provider submission does not mean listings are live. Follow Store Jobs and marketplace sync status for accepted, skipped, rejected or failed records. A failed export needs its actual cause fixed before retrying. MCP alone never changes credentials, activates automation or publishes listings: the separate SuperCatch confirmation performs the requested action.
Why Codex Redirects to Localhost
A desktop or command-line MCP client can use a temporary localhost callback such as http://127.0.0.1:<port>/callback. SuperCatch returns authorization to the client running on your own computer, rather than returning you to the SuperCatch homepage. The port can change on each attempt. The client exchanges the short-lived authorization code and saves its connection. Keep its login process running until it reports success. If the listener expires, start a fresh login instead of reusing an old callback URL. Do not share callback URLs containing authorization codes or copy access tokens into chat.
Review or Disconnect Access
Review assistant connections in SuperCatch Account Settings → Connected Apps. Disconnecting revokes that connection. Removing a connection inside an assistant is also useful, but use Connected Apps when you want SuperCatch to revoke its grant. Existing read-only connections do not gain write access merely because a new tool is added. Reconnect and review any additional permissions before enabling a future write capability.