Serveur MCP Pulltrader
Commit 4 oct. 2026Identifiez des cartes à collectionner, analysez leur valeur de marché via les ventes récentes et calculez vos bénéfices nets sur différentes plateformes de vente.
Aussi connu sous pulltrader/pulltrader-mcp, pulltrader-mcp
- Étoiles
- 0
- Outils
- 17
- Téléchargements, 30 jours
- —
- Dernière version
- 0.6.1
- Dernier commit
- 4 oct. 2026
- Licence
- MIT
Qu'est-ce que Pulltrader MCP ?
Pulltrader est un serveur MCP. Identifiez des cartes à collectionner, analysez leur valeur de marché via les ventes récentes et calculez vos bénéfices nets sur différentes plateformes de vente. Il expose 17 outils, comme identify_card, search_card_sales, summarize_card_market.
Résumé généré à partir du README du projet
À propos du MCP server Pulltrader
Les collectionneurs et revendeurs de cartes à collectionner peuvent effectuer des recherches sur les valeurs de marché et calculer leurs profits potentiels directement via leur assistant IA. Ce MCP server en lecture seule propose des outils pour convertir des descriptions en langage naturel en données de cartes structurées, récupérer des ventes comparables récentes et consulter des graphiques d'historique de prix. Il est conçu pour les utilisateurs de Claude, ChatGPT et Cursor qui ont besoin d'un accès rapide à l'économie des cartes à collectionner sans changer d'application.
Le serveur inclut un moteur déterministe pour estimer les revenus des vendeurs sur diverses plateformes comme eBay et Pulltrader. Il calcule le profit net en tenant compte des barèmes de frais spécifiques, des frais d'expédition et des forfaits vendeurs. Les utilisateurs peuvent également déterminer le prix de vente exact requis pour atteindre un montant net cible spécifique. Au-delà de l'étude de marché, le système inclut un outil Kapture pour vérifier si le certificat d'une carte correspond à un registre de cartes volées.
La configuration nécessite une connexion à un endpoint HTTP distant. Le service est public et ne nécessite pas d'authentification, bien qu'il applique des limites de débit pour gérer l'utilisation des données. Tous les chiffres de marché sont des estimations basées sur des ventes récentes, et tous les calculs financiers sont effectués par le serveur pour garantir l'exactitude plutôt que de s'appuyer sur l'inférence du modèle.
Ce que vous pouvez faire avec
- 1Identifier des cartes spécifiquesConvertissez une description textuelle d'une carte en données structurées incluant le joueur, l'édition et la note.
- 2Analyser les tendances de valeur de marchéConsultez les ventes comparables récentes et les graphiques d'historique de prix pour comprendre la valeur d'une carte.
- 3Comparer la rentabilité des plateformesCalculez la somme réelle que vous conserverez lors de la vente d'une carte sur différentes plateformes.
- 4Calculer des prix de vente ciblesTrouvez le prix de mise en vente nécessaire pour garantir que vous atteignez un objectif de profit net spécifique après déduction des frais.
- 5Vérifier l'authenticité d'une carteVérifiez un numéro de certification par rapport à un registre pour voir si la carte a été signalée comme volée.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Pulltrader MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Pulltrader MCP dans Claude Code
$ claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpInstaller Pulltrader MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp"
}
}
}Installer Pulltrader MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"pulltrader-mcp": {
"type": "http",
"url": "https://mcp.pulltrader.app/mcp"
}
}
}Installer Pulltrader MCP dans VS Code CLI
$ code --add-mcp '{"name":"pulltrader-mcp","type":"http","url":"https://mcp.pulltrader.app/mcp"}'Installer Pulltrader MCP dans Codex
$ codex mcp add pulltrader-mcp --url https://mcp.pulltrader.app/mcpInstaller Pulltrader MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.pulltrader-mcp] url = "https://mcp.pulltrader.app/mcp"
Installer Pulltrader MCP dans Gemini CLI
$ gemini mcp add -s user --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpInstaller Pulltrader MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp",
"type": "http"
}
}
}Outils MCP Pulltrader 17
Détectés depuis le READMEidentify_cardsearch_card_salessummarize_card_marketget_card_price_historycompare_selling_costscalculate_required_sale_priceexplain_selling_methodcurrencyquantityshipping_amountitem_categoryseller_plan
| identify_card | — | |
| search_card_sales | — | |
| summarize_card_market | — | |
| get_card_price_history | — | |
| compare_selling_costs | — | |
| calculate_required_sale_price | — | |
| explain_selling_method | — | |
| currency | — | |
| quantity | — | |
| shipping_amount | — | |
| item_category | — | |
| seller_plan | — |
Afficher les 17 outilsAfficher moins d'outils
seller_levelseller_covers_feesebay_store_subscriptionacquisition_costebay_fee_percent_override
| seller_level | — | |
| seller_covers_fees | — | |
| ebay_store_subscription | — | |
| acquisition_cost | — | |
| ebay_fee_percent_override | — |
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblepulltrader/pulltrader-mcp is public and reachablegithub.com/pulltrader/pulltrader-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-04github.com/pulltrader/pulltrader-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur GitHubPulltrader — 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)
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": {
"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
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.
More
Deploy prerequisites
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.
Questions sur Pulltrader MCP
Comment ajouter Pulltrader MCP à Claude Code ?
Exécutez claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Pulltrader MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Pulltrader MCP fournit-il ?
Il expose 17 outils, dont identify_card, search_card_sales, summarize_card_market, get_card_price_history, compare_selling_costs.
Puis-je identifier une carte à partir d'une image ?
Non, la version actuelle permet uniquement l'identification de cartes via des descriptions textuelles ou des champs structurés.
Le serveur fournit-il des conseils financiers ?
Non, les chiffres de marché fournis sont des estimations et l'outil ne prétend pas donner de conseils financiers.
Quelles sont les devises prises en charge ?
Le serveur prend actuellement uniquement l'USD en charge.
Comment les frais de vente sont-ils calculés ?
Le serveur utilise un moteur déterministe pour calculer les frais au lieu de demander au modèle de les déduire du texte.