Tool tree
Explore fictional card listings, exact-tier sale statistics, seller evidence, and transparent scores. No live marketplace data.
Implementation
gradeNot graded
gradeNot graded
search_cardsAnswer
Search normalized card variants and return the strongest exact-tier listing for each card.
View tool JSON
{
"name": "search_cards",
"kind": "answer",
"impl": "imperative",
"description": "Search normalized card variants and return the strongest exact-tier listing for each card.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 160,
"description": "Card name, set, number, grade, or condition."
},
"max_total_cents": {
"type": "integer",
"minimum": 1,
"maximum": 10000000,
"description": "Maximum item price plus known shipping, expressed as integer USD cents."
},
"raw_or_graded": {
"type": "string",
"enum": [
"RAW",
"GRADED"
],
"description": "Restrict results to raw cards or professionally graded cards."
},
"grading_company": {
"type": "string",
"enum": [
"PSA",
"BGS",
"CGC"
],
"description": "Exact grading company. Different grading companies are never pooled."
},
"grade": {
"type": "number",
"minimum": 1,
"maximum": 10,
"description": "Exact numeric grade from 1 to 10. Adjacent grades are never pooled."
},
"minimum_seller_trust": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Minimum evidence-backed Seller Trust score from 0 to 100."
},
"minimum_percent_below_market": {
"type": "number",
"minimum": 0,
"maximum": 95,
"description": "Minimum percentage below the exact-tier 90-day median."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Maximum number of normalized results to return."
}
},
"required": [
"query"
],
"additionalProperties": false
}
}get_card_market_stateAnswer
Get current listings, exact comparable-sales statistics, scores, and risks for one normalized card. Provide either card_id or query.
View tool JSON
{
"name": "get_card_market_state",
"kind": "answer",
"impl": "imperative",
"description": "Get current listings, exact comparable-sales statistics, scores, and risks for one normalized card. Provide either card_id or query.",
"inputSchema": {
"type": "object",
"properties": {
"card_id": {
"type": "string",
"maxLength": 160,
"description": "Canonical Scout card identifier. Use this when a previous result supplied it."
},
"query": {
"type": "string",
"maxLength": 160,
"description": "Card name, set, number, grade, or condition used to resolve one canonical card."
}
},
"additionalProperties": false
}
}assess_listingAction
Assess one listing using total cost, exact comps, Deal Score, Seller Trust, and warning evidence.
View tool JSON
{
"name": "assess_listing",
"kind": "act",
"impl": "imperative",
"description": "Assess one listing using total cost, exact comps, Deal Score, Seller Trust, and warning evidence.",
"inputSchema": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"maxLength": 160,
"description": "Scout listing identifier returned by search_cards or get_card_market_state."
}
},
"required": [
"listing_id"
],
"additionalProperties": false
}
}compare_listingsAction
Compare two to five listings using aligned acquisition cost, market, trust, risk, and score evidence.
View tool JSON
{
"name": "compare_listings",
"kind": "act",
"impl": "imperative",
"description": "Compare two to five listings using aligned acquisition cost, market, trust, risk, and score evidence.",
"inputSchema": {
"type": "object",
"properties": {
"listing_ids": {
"type": "array",
"description": "Two to five unique Scout listing identifiers from prior search or market-state results.",
"items": {
"type": "string",
"maxLength": 160,
"description": "A Scout listing identifier."
},
"minItems": 2,
"maxItems": 5,
"uniqueItems": true
}
},
"required": [
"listing_ids"
],
"additionalProperties": false
}
}find_dealsAnswer
Find listings that satisfy a budget, exact grade, seller-trust, and below-market threshold.
View tool JSON
{
"name": "find_deals",
"kind": "answer",
"impl": "imperative",
"description": "Find listings that satisfy a budget, exact grade, seller-trust, and below-market threshold.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 160,
"description": "Card name, set, number, grade, or condition."
},
"max_total_cents": {
"type": "integer",
"minimum": 1,
"maximum": 10000000,
"description": "Maximum item price plus known shipping, expressed as integer USD cents."
},
"raw_or_graded": {
"type": "string",
"enum": [
"RAW",
"GRADED"
],
"description": "Restrict results to raw cards or professionally graded cards."
},
"grading_company": {
"type": "string",
"enum": [
"PSA",
"BGS",
"CGC"
],
"description": "Exact grading company. Different grading companies are never pooled."
},
"grade": {
"type": "number",
"minimum": 1,
"maximum": 10,
"description": "Exact numeric grade from 1 to 10. Adjacent grades are never pooled."
},
"minimum_seller_trust": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Minimum evidence-backed Seller Trust score from 0 to 100."
},
"minimum_percent_below_market": {
"type": "number",
"minimum": 0,
"maximum": 95,
"description": "Minimum percentage below the exact-tier 90-day median."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Maximum number of normalized results to return."
}
},
"additionalProperties": false
}
}compare_raw_vs_gradedAction
Compare raw-condition and company-and-grade-specific market tiers without pooling them. Provide either card_id or query.
View tool JSON
{
"name": "compare_raw_vs_graded",
"kind": "act",
"impl": "imperative",
"description": "Compare raw-condition and company-and-grade-specific market tiers without pooling them. Provide either card_id or query.",
"inputSchema": {
"type": "object",
"properties": {
"card_id": {
"type": "string",
"maxLength": 160,
"description": "Canonical Scout card identifier. Use this when a previous result supplied it."
},
"query": {
"type": "string",
"maxLength": 160,
"description": "Card name, set, or number used to resolve one canonical card."
}
},
"additionalProperties": false
}
}