MCPサーバー

Pulltrader Seller Economics

app.pulltrader/seller-economics
コマース・小売 データ・分析 公開・接続可能 MCP 2026-07-28

このMCPでできること

Estimates trading-card sale prices, marketplace fees, seller proceeds, comparable sales, price histories, and market summaries.

calculate_required_sale_price
Find the sale price needed to reach a target net payout
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 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.
入力スキーマ
{'type': 'object', 'required': ['target_net'], 'properties': {'method': {'enum': ['ebay', 'pulltrader_marketplace', 'pulltrader_fbp', 'pulltrader_storefront', 'pulltrader_pos', 'tcgplayer', 'manapool', 'misprint', 'fanatics_collect', 'goldin'], 'type': 'string', 'default': 'ebay', 'description': 'The single selling method to solve for. One of: ebay, pulltrader_marketplace, pulltrader_fbp, pulltrader_storefront, pulltrader_pos, tcgplayer, manapool, misprint, fanatics_collect, goldin.'}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'description': 'ISO currency code. Only USD is supported.'}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 10000, 'minimum': 1, 'description': 'Number of identical items in one order. Per-order fixed fees are applied once.'}, 'target_net': {'type': 'number', 'maximum': 1000000, 'description': 'The amount the seller wants to keep per item after fees. Net profit if acquisition_cost is supplied, otherwise take-home payout.', 'exclusiveMinimum': 0}, 'seller_plan': {'enum': ['free', 'operations', 'business', 'managed'], 'type': 'string', 'default': 'free', 'description': 'Pulltrader seller plan. Sets the payout floor (free/operations=91%, business/managed=95%); a seller level earned on revenue can be higher.'}, 'seller_level': {'enum': [1, 2, 3, 4, 5], 'type': 'integer', 'description': "The seller's actual level (1-5), if known. Level is set from plan AND sales volume, so levels 2 and 4 exist only by earning them and cannot be inferred from a plan. Overrides the plan's rate: 1=91%, 2=92%, 3=93%, 4=94%, 5=95%."}, 'item_category': {'enum': ['trading_cards'], 'type': 'string', 'default': 'trading_cards', 'description': 'Item category. Only trading_cards is supported.'}, 'shipping_amount': {'type': 'number', 'default': 0, 'maximum': 100000, 'minimum': 0, 'description': "Shipping amount charged to the buyer. Affects eBay's fee base."}, 'acquisition_cost': {'type': 'number', 'maximum': 1000000, 'minimum': 0, 'description': 'Optional. What the seller paid for the card. When supplied, target_net is interpreted as net profit (payout minus this cost).'}, 'seller_covers_fees': {'type': 'boolean', 'default': False, 'description': 'If true, the seller absorbs the Pulltrader platform fee (3.25% + $0.40). If false (default), the buyer pays it at checkout.'}, 'ebay_store_subscription': {'type': 'boolean', 'default': False, 'description': 'If true, estimate eBay fees using the eBay Store subscriber rate instead of the individual rate.'}, 'ebay_fee_percent_override': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Optional. Override the estimated eBay final value fee percentage.'}}, 'additionalProperties': False}
check_kapture_cert
Check a cert against Kapture stolen-card reports
Check an exact certification number against Kapture. 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.
入力スキーマ
{'type': 'object', 'required': ['cert'], 'properties': {'cert': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Exact cert number as a string, including leading zeros.'}}, 'additionalProperties': False}
compare_selling_costs
Compare trading-card seller proceeds across selling methods
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.
入力スキーマ
{'type': 'object', 'required': ['sale_price'], 'properties': {'methods': {'type': 'array', 'items': {'enum': ['ebay', 'pulltrader_marketplace', 'pulltrader_fbp', 'pulltrader_storefront', 'pulltrader_pos', 'tcgplayer', 'manapool', 'misprint', 'fanatics_collect', 'goldin'], 'type': 'string'}, 'description': 'Which selling methods to compare. Defaults to eBay, Pulltrader marketplace, and Pulltrader storefront. Other supported methods (off by default): pulltrader_fbp, pulltrader_pos, and estimated competitor marketplaces tcgplayer, manapool, misprint, fanatics_collect, goldin.', 'uniqueItems': True}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'description': 'ISO currency code. Only USD is supported.'}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 10000, 'minimum': 1, 'description': 'Number of identical items in one order. Per-order fixed fees are applied once.'}, 'sale_price': {'type': 'number', 'maximum': 1000000, 'description': "The per-item sale price (the card's listed/sold price), in the given currency.", 'exclusiveMinimum': 0}, 'seller_plan': {'enum': ['free', 'operations', 'business', 'managed'], 'type': 'string', 'default': 'free', 'description': 'Pulltrader seller plan. Sets the payout floor (free/operations=91%, business/managed=95%); a seller level earned on revenue can be higher.'}, 'seller_level': {'enum': [1, 2, 3, 4, 5], 'type': 'integer', 'description': "The seller's actual level (1-5), if known. Level is set from plan AND sales volume, so levels 2 and 4 exist only by earning them and cannot be inferred from a plan. Overrides the plan's rate: 1=91%, 2=92%, 3=93%, 4=94%, 5=95%."}, 'item_category': {'enum': ['trading_cards'], 'type': 'string', 'default': 'trading_cards', 'description': 'Item category. Only trading_cards is supported.'}, 'shipping_amount': {'type': 'number', 'default': 0, 'maximum': 100000, 'minimum': 0, 'description': "Shipping amount charged to the buyer. Affects eBay's fee base. See assumptions for how each method treats shipping."}, 'acquisition_cost': {'type': 'number', 'maximum': 1000000, 'minimum': 0, 'description': 'Optional. What the seller paid for the card; used to estimate net profit per method.'}, 'seller_covers_fees': {'type': 'boolean', 'default': False, 'description': 'If true, the seller absorbs the Pulltrader platform fee (3.25% + $0.40). If false (default), the buyer pays it at checkout. The platform fee is always charged on Pulltrader card sales regardless.'}, 'ebay_store_subscription': {'type': 'boolean', 'default': False, 'description': 'If true, estimate eBay fees using the eBay Store subscriber rate (12.35% up to $2,500/item) instead of the individual rate (13.25% up to $7,500/item).'}, 'ebay_fee_percent_override': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Optional. Override the estimated eBay final value fee percentage (e.g. for a seller with an eBay Store subscription).'}}, 'additionalProperties': False}
explain_selling_method
Explain how a supported selling method works and what fees apply
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.
入力スキーマ
{'type': 'object', 'properties': {'methods': {'type': 'array', 'items': {'enum': ['ebay', 'pulltrader_marketplace', 'pulltrader_fbp', 'pulltrader_storefront', 'pulltrader_pos', 'tcgplayer', 'manapool', 'misprint', 'fanatics_collect', 'goldin'], 'type': 'string'}, 'description': 'Which selling methods to explain. Defaults to all supported methods: ebay, pulltrader_marketplace, pulltrader_fbp, pulltrader_storefront, pulltrader_pos, tcgplayer, manapool, misprint, fanatics_collect, goldin.', 'uniqueItems': True}}, 'additionalProperties': False}
get_card_price_history
Get the price history time series for a trading card
Return a chart-ready price-history series for a trading card, aggregated from recent comparable sold sales into day/week/month buckets with a median per bucket and an 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`. Series is built from sold-sale samples (and vendor TCG history when available); estimates only, not financial advice. Trading cards only.
入力スキーマ
{'type': 'object', 'properties': {'item': {'type': 'object', 'description': 'Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.', 'additionalProperties': True}, 'query': {'type': 'string', 'minLength': 2, 'description': "Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required."}, 'interval': {'enum': ['day', 'week', 'month'], 'type': 'string', 'default': 'week', 'description': 'Bucket size for the series. Defaults to week.'}}, 'additionalProperties': False}
identify_card
Identify a trading card from a text description
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.
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'minLength': 2, 'description': "The card description to identify, e.g. '2018 Prizm Luka Doncic Silver PSA 10'."}}, 'additionalProperties': False}
search_card_sales
Find recent comparable sold sales for a trading card
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`. Figures are estimates from recent sales and exclude fees/taxes/shipping; this is not financial advice and does not place orders. Trading cards only.
入力スキーマ
{'type': 'object', 'properties': {'item': {'type': 'object', 'description': 'Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.', 'additionalProperties': True}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of example sales to return (1–10).'}, 'query': {'type': 'string', 'minLength': 2, 'description': "Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required."}}, 'additionalProperties': False}
summarize_card_market
Summarize the current market for a trading card
Return a canonical market summary for a trading card from recent comparable sales: 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`. Estimates from recent sales, excluding fees/taxes/shipping; not financial advice. Trading cards only.
入力スキーマ
{'type': 'object', 'properties': {'item': {'type': 'object', 'description': 'Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.', 'additionalProperties': True}, 'query': {'type': 'string', 'minLength': 2, 'description': "Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required."}}, 'additionalProperties': False}
変更
calculate_required_sale_price
2026年9月25日3:01
変更
compare_selling_costs
2026年9月25日3:01
追加
check_kapture_cert
2026年9月25日3:01
追加
get_card_price_history
2026年9月17日7:57
追加
summarize_card_market
2026年9月17日7:57
追加
search_card_sales
2026年9月17日7:57
追加
identify_card
2026年9月17日7:57
追加
explain_selling_method
2026年9月17日7:57
追加
calculate_required_sale_price
2026年9月17日7:57
追加
compare_selling_costs
2026年9月17日7:57