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)

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

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)

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:

{
  "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

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.

More

• 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