app.pulltrader/seller-economics

Official7 tools

by Pulltrader · TypeScript

Pulltrader Seller Economics

Compare what a trading-card seller keeps across eBay, Pulltrader, and other card marketplaces.

Compare seller payouts across eBay, Pulltrader, and other trading card marketplaces.

Topics

cloudflare-workersebayfeesmcpmodel-context-protocoltrading-cardstypescript

Captured live from the server via tools/list.

compare_selling_costs

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.

Parameters (11)

sale_pricenumberrequired
The per-item sale price (the card's listed/sold price), in the given currency.
currencystring
ISO currency code. Only USD is supported.
quantityinteger
Number of identical items in one order. Per-order fixed fees are applied once.
shipping_amountnumber
Shipping amount charged to the buyer. Affects eBay's fee base. See assumptions for how each method treats shipping.
item_categorystring
Item category. Only trading_cards is supported.
seller_planstring
Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%).
seller_covers_feesboolean
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_subscriptionboolean
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).
methodsarray
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.
acquisition_costnumber
Optional. What the seller paid for the card; used to estimate net profit per method.
ebay_fee_percent_overridenumber
Optional. Override the estimated eBay final value fee percentage (e.g. for a seller with an eBay Store subscription).

calculate_required_sale_price

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.

Parameters (11)

target_netnumberrequired
The amount the seller wants to keep per item after fees. Net profit if acquisition_cost is supplied, otherwise take-home payout.
methodstring
The single selling method to solve for. One of: ebay, pulltrader_marketplace, pulltrader_fbp, pulltrader_storefront, pulltrader_pos, tcgplayer, manapool, misprint, fanatics_collect, goldin.
currencystring
ISO currency code. Only USD is supported.
quantityinteger
Number of identical items in one order. Per-order fixed fees are applied once.
shipping_amountnumber
Shipping amount charged to the buyer. Affects eBay's fee base.
item_categorystring
Item category. Only trading_cards is supported.
seller_planstring
Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%).
seller_covers_feesboolean
If true, the seller absorbs the Pulltrader platform fee (3.25% + $0.40). If false (default), the buyer pays it at checkout.
ebay_store_subscriptionboolean
If true, estimate eBay fees using the eBay Store subscriber rate instead of the individual rate.
acquisition_costnumber
Optional. What the seller paid for the card. When supplied, target_net is interpreted as net profit (payout minus this cost).
ebay_fee_percent_overridenumber
Optional. Override the estimated eBay final value fee percentage.

explain_selling_method

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.

Parameters (1)

methodsarray
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.

identify_card

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.

Parameters (1)

querystringrequired
The card description to identify, e.g. '2018 Prizm Luka Doncic Silver PSA 10'.

search_card_sales

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.

Parameters (3)

querystring
Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required.
itemobject
Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.
limitinteger
Maximum number of example sales to return (1–10).

summarize_card_market

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.

Parameters (2)

querystring
Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required.
itemobject
Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.

get_card_price_history

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.

Parameters (3)

querystring
Natural-language card description, e.g. '2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10'. Either query or item is required.
itemobject
Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport.
intervalstring
Bucket size for the series. Defaults to week.

README.md7 KBView on GitHub

Pulltrader Seller Economics MCP

Compare what a trading-card seller keeps across eBay and Pulltrader selling methods — inside your AI assistant.

A public, read-only Model Context Protocol server that estimates the net amount a trading-card seller keeps when selling the same card through eBay versus Pulltrader's selling methods (marketplace, Fulfilled by Pulltrader, branded storefront, and in-person POS).

Calculations are deterministic and use a dated, versioned fee schedule. The server performs the math itself — it never asks the model to infer fees from prose. eBay figures are clearly labeled estimates.

Transport: Streamable HTTP (POST /mcp)
Auth: none (public, read-only)
Endpoint: https://mcp.pulltrader.app/mcp
Registry name: app.pulltrader/seller-economics

Who it's for

Trading-card sellers, dealers, and shops deciding where to list a card and how much they'll take home — especially while comparing eBay against alternatives.

What it does (and doesn't)

Does	Doesn't
Estimate seller fees & net proceeds per method	Look up a card's market value or recent sales
Compare eBay (estimated) vs Pulltrader methods	Identify a card from text or image
Compute the price needed for a target net (via inputs)	Make any write/account changes
State its assumptions and limitations explicitly	Claim one platform is universally cheapest

Card identification, comparable sales, and "what's it worth" are out of scope for this server (see ROADMAP).

Tools

`compare_selling_costs`

Compare estimated fees and seller net proceeds for one trading-card sale across selling methods.

Inputs

Field	Type	Required	Default	Notes
`sale_price`	number	✅	—	Per-item price, > 0
`currency`	enum `USD`		`USD`	Only USD supported
`quantity`	integer		`1`	Per-order fixed fees applied once
`shipping_amount`	number		`0`	Affects eBay's fee base
`item_category`	enum `trading_cards`		`trading_cards`	Only trading cards
`seller_plan`	enum `free`\|`starter`\|`pro`\|`shop`		`free`	Marketplace payout tier
`seller_covers_fees`	boolean		`false`	If false, buyer pays the platform fee
`ebay_store_subscription`	boolean		`false`	Use eBay Store rate (12.35%) vs individual (13.25%)
`methods`	array		eBay + marketplace + storefront	Subset of supported methods
`acquisition_cost`	number		—	Estimates net profit per method
`ebay_fee_percent_override`	number		—	Override estimated eBay FVF % (flat)

Supported methods: ebay, pulltrader_marketplace, pulltrader_fbp, pulltrader_storefront, pulltrader_pos, and estimated competitor marketplaces tcgplayer, manapool, misprint, fanatics_collect, goldin (off by default — opt in via methods). Competitor figures model fixed-price / Buy Now seller fees only; auction formats (hammer price, buyer's premium, negotiated consignment) are not modeled.

Output (structured): currency, sale_price, methods[] (each with gross_amount, estimated_total_fees, fee_breakdown, estimated_payout, effective_fee_rate, owns_listing, fulfilled_by, where_it_sells, estimated, notes), difference_from_baseline, best_for_seller, assumptions, inputs_used, fee_schedules, fee_schedule_version, warnings, calculated_at, disclaimer, related_url. A concise, neutral human summary is returned as text content.

Example prompts

"Compare my estimated proceeds on a $250 graded-card sale."
"What would I keep on an $80 card on eBay vs Pulltrader?"
"If I'm on the Pro plan, what do I net on a $500 sale through Pulltrader?"
"Explain the assumptions behind this payout estimate."

Example response (text summary)

code

On a $250.00 trading-card sale, estimated seller proceeds by method:
- Sell it yourself on eBay: keep $216.47 (estimated) (fees $33.53, 13.41%)
- Pulltrader marketplace (you ship): keep $235.00 (fees $15.00, 6%)
- Your Pulltrader storefront (you ship): keep $250.00 (fees $0.00, 0%)
For these inputs, Your Pulltrader storefront (you ship) returns about $33.53 more than Sell it yourself on eBay.
Estimate based on fee schedules updated 2026-06-01 (Pulltrader) and 2026-06-27 (eBay, estimated). Estimates only, for trading cards in USD. ...

eBay = 13.25% individual FVF + $0.40 per-order fee (orders over $10). The storefront keeps 100% because Pulltrader has no seller fee on storefront/POS — only the platform fee, paid by the buyer here. The platform fee is always charged on Pulltrader card sales (buyer pays by default).

Connecting

Claude (web / Desktop)

Settings → Connectors → Add custom connector → URL https://mcp.pulltrader.app/mcp.

ChatGPT

Settings → Apps & Connectors → Advanced → enable Developer mode → Create → URL https://mcp.pulltrader.app/mcp.

Cursor / generic

Add to your MCP client config:

json

{
  "mcpServers": {
    "pulltrader-seller-economics": {
      "url": "https://mcp.pulltrader.app/mcp"
    }
  }
}

Tested clients: Claude (web/Desktop), ChatGPT developer mode, Cursor, MCP Inspector. We do not claim universal compatibility with every assistant.

Public access & rate limits

Public and read-only. A best-effort per-IP rate limit (default 60 req/min) guards the endpoint and returns HTTP 429 with Retry-After. There is no authenticated tier in this release.

Data sources & fee freshness

Pulltrader fees mirror Pulltrader's authoritative internal fee configuration.
eBay fees are an estimate of published trading-card rates (tiered individual/Store final value fee + order-size-based per-order fee), updated and reviewed on a schedule. See docs/FEE_SCHEDULES.md. Responses warn if a schedule is past its review date.

Limitations

eBay estimates exclude promoted listings, international fees, buyer-paid sales tax, and the seller's own shipping-label cost.
Not financial advice; actual proceeds vary.
Trading cards / USD only in this release.

Development

bash

npm install
npm run typecheck   # tsc --noEmit
npm test            # vitest
npm run dev         # wrangler dev (local)

Deploy and registry submission require explicit approval — see docs/DEPLOYMENT.md and docs/DISTRIBUTION.md. Do not deploy or publish from a development environment.

PRIVACY · SECURITY · TERMS · CHANGELOG
Fee schedules & update process

Roadmap

Card market context (comparable sales / pricing) is intentionally deferred. It will only be added if this MVP demonstrates useful repeat usage, acceptable cost, reliable outputs, meaningful seller intent, measurable conversion, and low support burden — and after data-licensing and abuse/auth review.

Built and maintained by Pulltrader. Support: support@pulltrader.app

Install

claude_desktop_config.json

{
  "mcpServers": {
    "seller-economics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pulltrader.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

compare_selling_costs

calculate_required_sale_price

explain_selling_method

identify_card

search_card_sales

summarize_card_market

get_card_price_history

Pulltrader Seller Economics MCP

Who it's for

What it does (and doesn't)

Tools

compare_selling_costs

Example prompts

Example response (text summary)

Connecting

Claude (web / Desktop)

ChatGPT

Cursor / generic

Public access & rate limits

Data sources & fee freshness

Limitations

Development

More

Roadmap

Install

`compare_selling_costs`