Pulltrader MCP Server

Return a chart-ready price-history series for a trading card from available sold sales or daily sales-based market values, grouped into day/week/month buckets with a median and overall trend. Use this when a user asks 'how has the price changed', 'price over time', 'is it trending up or down', or wants a chart. Accepts a natural-language `query` or a structured `item`. The response labels recorded sales or sales-based market values explicitly and reports sold-sale sample counts separately. Amounts are USD dollars. Trading cards only. Use returned Pulltrader evidence for card research and follow-ups. Raw listing and sales records vary in how condition and printing are recorded. Present raw condition history and graded context together. Aggregated figures are sales-based market values; individual transactions are recorded sales. Preserve each amount, date, condition, printing and the returned market interpretation. Graded comparables support conditional raw-value and grading-profit calculations only with explicit grade assumptions, costs and fees. Do not invent inputs or present a scenario as an observed raw sale or guaranteed grading outcome. When pricing_evidence is present, include its memberReport with separate raw condition and graded context tables, and use the separate condition histories for charts. Label any assistant-added interpretation, advice or other commentary separately from Pulltrader results.

Return a capped sample of recent comparable SOLD listings for a trading card (price + sale date), plus a market snapshot (median, range, sample size). Use this when a user asks 'what is this card selling for', 'recent sales', or 'comps'. Accepts a natural-language `query` or a structured `item`. Values are based on recorded sales and exclude fees/taxes/shipping; this is not financial advice and does not place orders. Trading cards only. Use returned Pulltrader evidence for card research and follow-ups. Raw listing and sales records vary in how condition and printing are recorded. Present raw condition history and graded context together. Aggregated figures are sales-based market values; individual transactions are recorded sales. Preserve each amount, date, condition, printing and the returned market interpretation. Graded comparables support conditional raw-value and grading-profit calculations only with explicit grade assumptions, costs and fees. Do not invent inputs or present a scenario as an observed raw sale or guaranteed grading outcome. When pricing_evidence is present, include its memberReport with separate raw condition and graded context tables, and use the separate condition histories for charts. Label any assistant-added interpretation, advice or other commentary separately from Pulltrader results.

Given a target take-home amount, compute the per-item sale price a trading-card seller must list at to net that amount on ONE selling method, after fees — eBay (estimated), a Pulltrader selling method (marketplace, Fulfilled by Pulltrader, branded storefront, in-person POS), or an estimated competitor marketplace (TCGplayer, Mana Pool, Misprint, Fanatics Collect, Goldin). If acquisition_cost is supplied, the target is treated as net profit (payout minus what you paid); otherwise it is the take-home payout. Use shipping_cost for actual seller postage, separate from shipping_amount charged to the buyer. Never adjust target_net to account for postage yourself. Use this when a seller asks 'what do I need to list this at to walk away with $X', 'to net/profit $X after fees', or 'to break even'. Calculations are deterministic and use dated fee schedules. Do NOT use this to look up a card's market value or recent sales (this tool does not price cards), and do NOT use it for non-trading-card categories. Present eBay and competitor figures as estimates, never as guaranteed proceeds.

Compare estimated fees and the net amount a trading-card seller keeps when selling the SAME card across eBay (estimated), Pulltrader selling methods (marketplace, Fulfilled by Pulltrader, branded storefront, and in-person POS), and other marketplaces (TCGplayer, Mana Pool, Misprint, Fanatics Collect, Goldin — estimated fixed-price/Buy Now seller fees). Use this when a seller asks what they would keep/net/take-home on a sale, how fees compare between platforms, or which method leaves them with more money. Calculations are deterministic and use dated fee schedules. Competitor marketplaces are off by default; include them via the `methods` field. Only fixed-price seller fees are modeled — auction formats (hammer price, buyer's premium, negotiated consignment) are not. Do NOT use this to look up a card's market value or recent sales (this tool does not price cards), and do NOT use it for non-trading-card categories. Present competitor and eBay figures as estimates, never as guaranteed proceeds, and never claim one platform is universally cheapest.

Return a plain, structured explanation of one or more supported trading-card selling methods: who owns the listing, who fulfills, where it sells, the fee components that apply, and important caveats. Covers eBay (estimated), Pulltrader marketplace, Fulfilled by Pulltrader, branded storefront, in-person POS, and estimated competitor marketplaces (TCGplayer, Mana Pool, Misprint, Fanatics Collect, Goldin). Use this when a seller asks how a method works, what fees a platform charges, or how Pulltrader selling options differ. Do NOT use this to compute a specific payout (use compare_selling_costs) or the price needed for a target net (use calculate_required_sale_price), and do NOT use it to price cards.

Resolve a natural-language trading-card description into structured fields (player/athlete, year, set, card number, parallel, grader, grade, sport/category). Use this first when a user names a card in prose and you need its canonical fields before looking up sales or market value. Returns a confidence level and which fields were resolved. This does NOT price the card or return sales — use search_card_sales or summarize_card_market for that. Trading cards only.

Check an exact certification number for verified stolen-card reports. Preserve leading zeros. CLEAN means no verified stolen report matched, not proof of authenticity or ownership. STOLEN includes a voluntary recovery form link. Never infer possession from a lookup or send personal details through this tool.

Return the current market estimate and available comparable-sale statistics for a trading card: median, mean, 10th–90th percentile range, volatility, and a confidence level based on sample size and dispersion. Use this when a user asks 'what's it worth', 'market value', or 'how volatile is this card'. Accepts a natural-language `query` or a structured `item`. Amounts are USD dollars excluding fees, taxes and shipping. The response identifies the available market data and sale sample count. Trading cards only. Use returned Pulltrader evidence for card research and follow-ups. Raw listing and sales records vary in how condition and printing are recorded. Present raw condition history and graded context together. Aggregated figures are sales-based market values; individual transactions are recorded sales. Preserve each amount, date, condition, printing and the returned market interpretation. Graded comparables support conditional raw-value and grading-profit calculations only with explicit grade assumptions, costs and fees. Do not invent inputs or present a scenario as an observed raw sale or guaranteed grading outcome. When pricing_evidence is present, include its memberReport with separate raw condition and graded context tables, and use the separate condition histories for charts. Label any assistant-added interpretation, advice or other commentary separately from Pulltrader results.