CardSight AI

Showing 25 of 96 from the live probe.

• Search Catalog

  Global fuzzy search across the entire CardSightAI catalog. Searches cards, sets, releases, and parallels simultaneously across all sports and TCGs. BEST FOR: - Quick discovery when you're not sure of the exact entity type - Cross-category searching (e.g., "Topps Chrome" finds releases and sets) - Broad exploratory queries TIPS: - Use the type filter to narrow results to a specific entity type - Use the segment filter for sport-specific results - Append a standalone slash term like "/25" to mat

• Get Catalog Statistics

  Get comprehensive statistics about the CardSightAI catalog. Returns total counts of cards, sets, releases, parallels, segments, and manufacturers across all sports and TCGs. Results are cached for ~1 hour. USE WHEN: - User wants to know how large the catalog is - Getting an overview of available data - Understanding what segments/sports are covered

• Search Cards

  Search the CardSightAI trading card catalog across all sports and TCGs. Searches millions of cards from all major manufacturers and years. BEST FOR: - Finding cards of specific players or subjects - Browsing cards from specific years or year ranges - Searching within specific sets or releases - Finding rookie cards or special attributes (RC, AU, GU, SP, SSP, 1/1) - Sorting cards by price to find valuable or affordable options TIPS: - Player/subject names support partial matching (e.g., "Griffe

• Get Card

  Get detailed catalog information about a specific trading card using its UUID. RETURNS: - Card name/subject and card number - Release and set information - Year and manufacturer details - Parallel variants and numbered print runs (when applicable) - Attributes (RC, AU, GU, SP, SSP, 1/1, REF, etc.) - Flexible TCG metadata fields (HP, Rarity, Mana Cost, etc. — varies by segment) USE WHEN: - You have a card ID from a search result and want full catalog details. - You need parallel/attribute conte

• Search Sets

  Search for card sets in the catalog. Sets are collections of cards released together within a product. SET TYPES: - Base sets (main collection of cards) - Insert sets (special subsets within a release) - Parallel sets (variations of base cards) SEARCH BY: - Set name (e.g., "Chrome", "Heritage", "Prizm", "Base Set") - Year or year range - Manufacturer (Topps, Panini, Pokemon Company, etc.) - Release name TIPS: - Sets often have the same name across years - use year + name for precision - Use r

• Get Set

  Get complete catalog information about a specific card set. RETURNS: - Set name and description - Number of base cards and parallel types - Release and year information - List of all parallel variants with print runs (where defined) USE WHEN: - You have a set ID from search results. - You need set composition and the parallel-variant list. - Use `get_set_cards` to browse the cards inside this set. **Pricing is a separate call.** This tool does not return parallel pricing. For value, use `get_

• Get Set Cards

  List all cards within a specific set. Use this to browse a set's checklist with pagination support. USE WHEN: - You have a set ID and want to see its cards - Building a checklist for a set - Looking for specific cards within a known set - Use get_set first to see set metadata, then this tool for the card list

• Search Releases

  Search for card releases across all sports and TCGs. A release is a product line that may contain multiple sets. UNDERSTANDING RELEASES: - A release is the overall product (e.g., "2023 Topps Series 1", "2024 Pokemon Scarlet & Violet") - Each release contains multiple sets (base set, inserts, parallels) - Releases are year and manufacturer specific SEARCH TIPS: - Use segment to filter by sport/category (e.g., "Baseball", "Football", "Pokemon", "Magic: The Gathering") - Manufacturer + Year gives

• Get Release

  Get comprehensive information about a specific card release. RETURNS: - Release name and year - All sets within the release with card counts - Parallel counts per set USE WHEN: - You have a release ID from search results - Want to see all sets in a product - Need to understand product structure - Use get_release_cards to browse the cards within this release

• Get Release Cards

  List all cards within a specific release. Can be filtered by set within the release. USE WHEN: - You have a release ID and want to browse its cards - Looking for specific cards across all sets in a release - Use get_release first to see release metadata and set list, then this tool for cards

• List Segments

  List available market segments (sports and TCG categories) in the CardSightAI catalog. Segments represent the different card markets such as Baseball, Football, Basketball, Hockey, Pokemon, Magic: The Gathering, etc. USE WHEN: - User wants to know what sports or card games are supported - Need to find the correct segment name for filtering other searches - Exploring what categories of cards are available

• List Manufacturers

  List card manufacturers in the CardSightAI catalog. Manufacturers are the companies that produce trading cards. COMMON MANUFACTURERS: - Sports: Topps, Panini, Upper Deck, Bowman, Donruss, Fleer - TCG: Pokemon Company, Wizards of the Coast, Konami, Bandai USE WHEN: - User wants to know which manufacturers are available - Need to find the correct manufacturer name for filtering searches - Browsing by manufacturer

• List Attributes

  List card attributes in the CardSightAI catalog. Attributes are special designations on cards like Rookie Card, Autograph, etc. COMMON ATTRIBUTES: - RC: Rookie Card - AU: Autograph - GU: Game Used / Memorabilia - SP: Short Print - SSP: Super Short Print - 1/1: One of One - REF: Refractor USE WHEN: - User wants to know what card attributes are available - Need to find the correct attribute code for filtering card searches - Exploring special card designations - Sort by cardCount to see most com

• Get Attribute

  Get detailed information about a specific card attribute by its UUID. USE WHEN: - You have an attribute ID from list_attributes or card details - Need to see full details about an attribute designation

• Search Parallels

  Search for parallel variants across the CardSightAI catalog. Parallels are special versions of cards with different designs, colors, or print runs. COMMON PARALLEL TYPES: - Refractors, Prizms, Holos - Color variants (Gold, Silver, Blue, Red, Green) - Numbered parallels (/10, /25, /50, /99, /199) - 1/1 Superfractors, Printing Plates USE WHEN: - Looking for specific parallel types across sets - Comparing parallel availability in a release - Finding numbered or limited parallels

• Get Parallel

  Get detailed catalog information about a specific parallel variant by its UUID. Returns the parallel name, numbering / print run, and set/release context. USE WHEN: - You have a parallel ID from search results or card details. - You need to confirm a parallel's print run or set context before pricing or write operations. **Pricing is a separate call.** This tool does not return market prices for the parallel. For value, call `get_card_pricing` with the card's `cardId` and pass this parallel's

• Get Random Cards

  Get random cards from the catalog. Perfect for discovery, pack opening simulations, or showing users interesting cards they might not find through search. FEATURES: - Returns 1-200 random cards per request - Can be filtered by year, release, set, manufacturer, etc. - includeParallels enables a parallel odds system that simulates real pack odds USE WHEN: - User wants to discover random cards - Simulating a pack opening experience - Showing variety in the catalog - "Show me something cool" or "s

• Get Random Sets

  Get random sets from the catalog. Great for discovery and exploring the catalog breadth. USE WHEN: - User wants to discover new sets - Showing variety in the catalog - Exploring sets from a particular year or manufacturer

• Get Random Releases

  Get random releases from the catalog. Great for discovering products across sports and TCGs. USE WHEN: - User wants to discover new releases/products - Exploring what's available in a particular segment or year - Showing variety across the catalog

• Health Check

  Check if the CardSightAI API is operational and responding. Use when testing connectivity or troubleshooting connection issues.

• List Collections

  Search and list all collections belonging to collectors. Returns paginated results with collection metadata including name, description, and collector information. **Usage Scenarios:** - "Show me all my collections" - "List John's baseball card collections" - "Find collections with 'rookie' in the name" - "What collections do I have?" **LLM Guidance:** Use this as the starting point when a user wants to view, browse, or find their collections. Always use this before performing operations on co

• Get Collection

  Retrieve detailed information about a specific collection including its name, description, collector ID, and metadata. **Usage Scenarios:** - "Show me details of my vintage collection" - "What's in collection abc-123?" - After listing collections, user says "tell me more about the first one" **LLM Guidance:** Use this when a user wants details about a specific collection they've mentioned or selected. This provides the foundation before adding/viewing cards in that collection.

• Create Collection

  Create a new collection for organizing cards. Collections help users organize their cards by theme, player, year, investment goals, or any custom criteria. **Usage Scenarios:** - "Create a new collection for my Ken Griffey Jr. cards" - "Start a collection to track cards I want to sell" - "Make a collection called 'Hall of Fame Rookies'" - "I want to organize my cards by decade" **LLM Guidance - IMPORTANT COLLECTOR WORKFLOW:** Before creating a collection, you MUST determine the collector ID:

• Update Collection

  Modify the name or description of an existing collection. Useful for renaming collections or updating their purpose as the user's organization strategy evolves. **Usage Scenarios:** - "Rename my collection to 'Vintage Stars'" - "Update the description to mention I'm tracking investment cards" - "Change the name of collection XYZ" **LLM Guidance:** Use when users want to reorganize or clarify their collection structure. This is common as collections grow and users refine their organization stra

• Delete Collection

  Permanently delete a collection. This removes the collection container but does NOT delete the actual cards from the system - only the organizational grouping. **Usage Scenarios:** - "Delete my old collection" - "Remove the 'Duplicates' collection" - "I don't need this collection anymore" **LLM Guidance:** **IMPORTANT - Always confirm with user before deleting!** Explain that this removes the collection organization but doesn't delete the cards themselves. Ask for explicit confirmation: "This