Pulltrader

Official7 toolsLive

by Pulltrader · TypeScript

Trading-card research and seller economics: identify cards, check sold comps, and compare fees.

Pulltrader Seller Economics MCP

A public, read-only Model Context Protocol (MCP) server that compares what a trading-card seller keeps when selling the same card through eBay versus Pulltrader’s selling methods. It estimates the net amount using deterministic calculations based on a dated, versioned fee schedule, performing the math itself.

🛠️ Key Features

Compares seller net proceeds across eBay and Pulltrader
Estimates net amount a seller keeps using deterministic math
Uses a dated, versioned fee schedule
Covers Pulltrader selling methods: marketplace, Fulfilled by Pulltrader, branded storefront, and in-person POS

🚀 Use Cases

Side-by-side fee and proceeds comparison for trading-card selling channels
Planning which marketplace method to use based on estimated net proceeds
Using results inside an AI assistant via MCP

⚡ Developer Benefits

Read-only MCP server focused on fee/proceeds calculation
Deterministic, versioned fee inputs for repeatable outputs
Designed for developer integration (topics include TypeScript, MCP, and Cloudflare Workers)

⚠️ Limitations

Limited to seller economics/net proceeds estimates; no personalized or model-driven fee selection is described
Tool coverage count is 7 (as provided), with details not included beyond the fee-comparison scope

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.

Parameters11

sale_price	number	required	The per-item sale price (the card's listed/sold price), in the given currency.
currency	string	optional	ISO currency code. Only USD is supported.
quantity	integer	optional	Number of identical items in one order. Per-order fixed fees are applied once.
shipping_amount	number	optional	Shipping amount charged to the buyer. Affects eBay's fee base. See assumptions for how each method treats shipping.
item_category	string	optional	Item category. Only trading_cards is supported.
seller_plan	string	optional	Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%).
seller_covers_fees	boolean	optional	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	boolean	optional	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).
methods	array	optional	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_cost	number	optional	Optional. What the seller paid for the card; used to estimate net profit per method.
ebay_fee_percent_override	number	optional	Optional. Override the estimated eBay final value fee percentage (e.g. for a seller with an eBay Store subscription).

Raw schema

{
  "type": "object",
  "properties": {
    "sale_price": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000,
      "description": "The per-item sale price (the card's listed/sold price), in the given currency."
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD"
      ],
      "default": "USD",
      "description": "ISO currency code. Only USD is supported."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "default": 1,
      "description": "Number of identical items in one order. Per-order fixed fees are applied once."
    },
    "shipping_amount": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "default": 0,
      "description": "Shipping amount charged to the buyer. Affects eBay's fee base. See assumptions for how each method treats shipping."
    },
    "item_category": {
      "type": "string",
      "enum": [
        "trading_cards"
      ],
      "default": "trading_cards",
      "description": "Item category. Only trading_cards is supported."
    },
    "seller_plan": {
      "type": "string",
      "enum": [
        "free",
        "starter",
        "pro",
        "shop"
      ],
      "default": "free",
      "description": "Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%)."
    },
    "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)."
    },
    "methods": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ebay",
          "pulltrader_marketplace",
          "pulltrader_fbp",
          "pulltrader_storefront",
          "pulltrader_pos",
          "tcgplayer",
          "manapool",
          "misprint",
          "fanatics_collect",
          "goldin"
        ]
      },
      "uniqueItems": true,
      "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."
    },
    "acquisition_cost": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Optional. What the seller paid for the card; used to estimate net profit per method."
    },
    "ebay_fee_percent_override": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Optional. Override the estimated eBay final value fee percentage (e.g. for a seller with an eBay Store subscription)."
    }
  },
  "required": [
    "sale_price"
  ],
  "additionalProperties": false
}

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.

Parameters11

target_net	number	required	The amount the seller wants to keep per item after fees. Net profit if acquisition_cost is supplied, otherwise take-home payout.
method	string	optional	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	string	optional	ISO currency code. Only USD is supported.
quantity	integer	optional	Number of identical items in one order. Per-order fixed fees are applied once.
shipping_amount	number	optional	Shipping amount charged to the buyer. Affects eBay's fee base.
item_category	string	optional	Item category. Only trading_cards is supported.
seller_plan	string	optional	Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%).
seller_covers_fees	boolean	optional	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	boolean	optional	If true, estimate eBay fees using the eBay Store subscriber rate instead of the individual rate.
acquisition_cost	number	optional	Optional. What the seller paid for the card. When supplied, target_net is interpreted as net profit (payout minus this cost).
ebay_fee_percent_override	number	optional	Optional. Override the estimated eBay final value fee percentage.

Raw schema

{
  "type": "object",
  "properties": {
    "target_net": {
      "type": "number",
      "exclusiveMinimum": 0,
      "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."
    },
    "method": {
      "type": "string",
      "enum": [
        "ebay",
        "pulltrader_marketplace",
        "pulltrader_fbp",
        "pulltrader_storefront",
        "pulltrader_pos",
        "tcgplayer",
        "manapool",
        "misprint",
        "fanatics_collect",
        "goldin"
      ],
      "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": {
      "type": "string",
      "enum": [
        "USD"
      ],
      "default": "USD",
      "description": "ISO currency code. Only USD is supported."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "default": 1,
      "description": "Number of identical items in one order. Per-order fixed fees are applied once."
    },
    "shipping_amount": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "default": 0,
      "description": "Shipping amount charged to the buyer. Affects eBay's fee base."
    },
    "item_category": {
      "type": "string",
      "enum": [
        "trading_cards"
      ],
      "default": "trading_cards",
      "description": "Item category. Only trading_cards is supported."
    },
    "seller_plan": {
      "type": "string",
      "enum": [
        "free",
        "starter",
        "pro",
        "shop"
      ],
      "default": "free",
      "description": "Pulltrader seller plan. Determines the marketplace payout tier (free=91%, starter=93%, pro=94%, shop=95%)."
    },
    "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."
    },
    "acquisition_cost": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Optional. What the seller paid for the card. When supplied, target_net is interpreted as net profit (payout minus this cost)."
    },
    "ebay_fee_percent_override": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Optional. Override the estimated eBay final value fee percentage."
    }
  },
  "required": [
    "target_net"
  ],
  "additionalProperties": false
}

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.

Parameters1

methods

array

optional

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.

Raw schema

{
  "type": "object",
  "properties": {
    "methods": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ebay",
          "pulltrader_marketplace",
          "pulltrader_fbp",
          "pulltrader_storefront",
          "pulltrader_pos",
          "tcgplayer",
          "manapool",
          "misprint",
          "fanatics_collect",
          "goldin"
        ]
      },
      "uniqueItems": true,
      "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."
    }
  },
  "additionalProperties": false
}

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.

Parameters1

query

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "The card description to identify, e.g. '2018 Prizm Luka Doncic Silver PSA 10'."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "item": {
      "type": "object",
      "additionalProperties": true,
      "description": "Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10,
      "description": "Maximum number of example sales to return (1–10)."
    }
  },
  "additionalProperties": false
}

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "item": {
      "type": "object",
      "additionalProperties": true,
      "description": "Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport."
    }
  },
  "additionalProperties": false
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "item": {
      "type": "object",
      "additionalProperties": true,
      "description": "Structured card fields (alternative to query): player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport."
    },
    "interval": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "default": "week",
      "description": "Bucket size for the series. Defaults to week."
    }
  },
  "additionalProperties": false
}

README.md11 KBView on GitHub

Pulltrader — Trading-Card MCP Server

Identify a card, pull recent sold comps, summarize its market value, chart its price history, and compare what a seller keeps across eBay, Pulltrader, and other card marketplaces — inside your AI assistant.

A public, read-only Model Context Protocol server for trading-card research and selling. Eight tools: a Kapture stolen-card registry check, four back onto Pulltrader's card data (identification, comparable sold sales, market value, price history), three run Pulltrader's deterministic seller-economics engine over a dated, versioned fee schedule.

Market figures are estimates derived from recent sales. Fee math is deterministic — the server computes it and 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
Protocol: 2025-06-18 (the client's requested version is echoed when present)

Who it's for

Trading-card sellers, dealers, shops, and collectors who want to know what a card is, what it's worth, and what they'd actually take home selling it — without leaving their assistant.

What it does (and doesn't)

Does	Doesn't
Resolve a prose card description into structured fields	Identify a card from an image (text only)
Return recent comparable sold sales (price + date)	Return listing, affiliate, or per-sale outbound URLs
Summarize market value: median, mean, p10–p90, volatility, confidence	Claim a guaranteed value or give financial advice
Chart price history by day / week / month with a trend	Make any write, order, or account change
Estimate seller fees and net proceeds per selling method	Claim one platform is universally cheapest
Solve for the price needed to hit a target net	Model auction formats (hammer, buyer's premium, consignment)
State its assumptions, data freshness, and limitations	Cover non-card categories or currencies other than USD

Tools

Kapture cert check (data-backed)

check_kapture_cert accepts { "cert": "00123456" } and preserves leading zeros. CLEAN only means no verified stolen report matched. STOLEN includes the Kapture report and a voluntary Pulltrader recovery-form link. The tool never collects personal information, infers possession, or submits a recovery report. The backend holds KAPTURE_API_KEY; no new Worker secret is needed. Recovery handoff is manual until Kapture provides a reporting API. See pulltrader-backend/docs/KAPTURE.md.

Card research (data-backed)

These bridge to the Pulltrader backend. Card data is limited-public: a capped sample of sales, no per-listing or affiliate URLs, and only the catalog reference image.

Each accepts either query (a natural-language description, e.g. "2023 Panini Prizm Victor Wembanyama #136 Silver PSA 10") or item (structured fields: player_athlete, year_manufactured, set_name, card_number, parallel_variety, grader, grade, sport). One of the two is required.

Tool	What it returns
`identify_card`	Canonical fields (player/athlete, year, set, number, parallel, grader, grade, category) plus a confidence level and which fields resolved. Takes `query` only. Does not price the card.
`search_card_sales`	A capped sample of recent comparable sold sales (price + date) plus a market snapshot. Optional `limit`.
`summarize_card_market`	Canonical market value: median, mean, p10–p90, volatility, sample size, confidence.
`get_card_price_history`	A chart-ready time series with a trend. Optional `interval`: `day` \| `week` \| `month`.

When eBay has no dated comps, search_card_sales and summarize_card_market fall back to the authoritative vendor price and surface market_value, value_source (TCG Market | CardSightAI | eBay Comps), price_change_7d, price_change_30d, and a single catalog image.

Seller economics (deterministic, no I/O)

Tool	What it returns
`compare_selling_costs`	Estimated fees and net proceeds for one sale across selling methods, with a per-method fee breakdown, the difference vs the eBay baseline, and the assumptions used. Requires `sale_price`.
`calculate_required_sale_price`	The per-item price needed to reach a target take-home (or net profit, when `acquisition_cost` is given) on a single method. Requires `target_net`.
`explain_selling_method`	Plain, structured explanation of how each method owns the listing, fulfills, and charges fees. Derived from the same engine, so it never drifts from `compare_selling_costs`.

Shared inputs (compare_selling_costs, calculate_required_sale_price):

Field	Type	Default	Notes
`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`	`free`\|`starter`\|`pro`\|`shop`	`free`	Marketplace payout tier
`seller_level`	enum	derived from plan	Explicit payout level override
`seller_covers_fees`	boolean	`false`	If false, the buyer pays the platform fee
`ebay_store_subscription`	boolean	`false`	eBay Store rate (12.35%) vs individual (13.25%)
`acquisition_cost`	number	—	Switches output to net profit
`ebay_fee_percent_override`	number	—	Override the estimated eBay FVF % (flat)

Supported methods: ebay, pulltrader_marketplace, pulltrader_fbp, pulltrader_storefront, pulltrader_pos, plus 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.

Example prompts

"What is this card: 2023 Bowman Chrome Elly De La Cruz PSA 10?"
"Show me recent sold comps and the market value for that card."
"What's the price history on a 2018 Prizm Luka Doncic Silver PSA 10 over the last year?"
"Compare my estimated proceeds on a $250 graded-card sale."
"What would I keep on an $80 card on eBay vs Pulltrader?"
"What do I have to sell it for to clear $200 after fees?"
"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": {
    "scout-by-pulltrader": {
      "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

The /mcp endpoint is public and read-only. A separate seller resource is implemented at /seller/mcp; OAuth is provisioned and its signed-in pilot is pending. See Seller MCP.

Limit	Default	Notes
All `POST /mcp`	60 / IP / min	HTTP 429 + `Retry-After`. Fail-open if KV is down.
Data tools (identify / comps / market / history)	8 / IP / min, 40 / IP / day	Tool `isError` `RATE_LIMITED`. Fail-closed if KV is down.
Data tools global	10,000 / day	Circuit breaker for model + comps spend.
Batch size	5 messages	Larger batches are rejected.

Requires the MCP_ABUSE KV namespace (see wrangler.toml). Tune via PUBLIC_RATE_LIMIT_PER_MIN, DATA_RATE_LIMIT_PER_MIN, DATA_RATE_LIMIT_PER_DAY, DATA_GLOBAL_LIMIT_PER_DAY.

Errors

Input problems come back as a tool result with isError: true and a stable code, not a JSON-RPC error: INVALID_INPUT, NOT_FOUND, RATE_LIMITED, UPSTREAM_ERROR, UPSTREAM_TIMEOUT, DATA_BACKEND_UNAVAILABLE, INTERNAL_ERROR. Unknown methods and malformed envelopes use standard JSON-RPC error codes.

The four card tools require the backend bridge (PULLTRADER_API_BASE + SCOUT_MCP_SECRET). Without it they degrade to DATA_BACKEND_UNAVAILABLE; the three seller-economics tools are pure and always available.

Data sources & fee freshness

Card data is limited-public and estimate-only: a capped sample of recent sold comps, aggregated by the shared Pulltrader domain engine.
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.

Current schedule versions are served live at /version.

Limitations

eBay estimates exclude promoted listings, international fees, buyer-paid sales tax, and the seller's own shipping-label cost.
Market values are estimates from recent sales, excluding fees, taxes, and shipping.
Not financial advice; actual proceeds and actual value 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 session.

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

Deploy prerequisites

bash

wrangler kv namespace create MCP_ABUSE
wrangler kv namespace create MCP_ABUSE --preview
# Paste ids into wrangler.toml [[kv_namespaces]] binding MCP_ABUSE
wrangler secret put SCOUT_MCP_SECRET

Roadmap

Image-based card identification.
Athlete/player profile tools.
Complete the signed-in seller pilot for /seller/mcp; global per-user quotas remain future work.

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

_{This repository is the public mirror of the Pulltrader MCP Worker, exported from the Pulltrader monorepo on each release. Issues and questions are welcome here; pull requests are applied upstream. wrangler.toml KV ids are redacted — deploys run from the monorepo.}

Install

Tools (7)

compare_selling_costscalculate_required_sale_priceexplain_selling_methodidentify_cardsearch_card_salessummarize_card_marketget_card_price_history

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.pulltrader.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

Pulltrader

Pulltrader Seller Economics MCP

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

compare_selling_costs

calculate_required_sale_price

explain_selling_method

identify_card

search_card_sales

summarize_card_market

get_card_price_history

Pulltrader — Trading-Card MCP Server

Who it's for

What it does (and doesn't)

Tools

Kapture cert check (data-backed)

Card research (data-backed)

Seller economics (deterministic, no I/O)

Example prompts

Example response (text summary)

Connecting

Claude (web / Desktop)

ChatGPT

Cursor / generic

Public access & rate limits

Errors

Data sources & fee freshness

Limitations

Development

More

Deploy prerequisites

Roadmap

Install

Remote endpoint

Related servers