MCP server de Pulltrader
Commit 4 oct 2026Identifica cartas coleccionables, analiza su valor de mercado mediante ventas recientes y calcula las ganancias netas en diversos marketplaces.
También conocido como pulltrader/pulltrader-mcp, pulltrader-mcp
- Stars
- 0
- Herramientas
- 17
- Descargas, 30 días
- —
- Última versión
- 0.6.1
- Último commit
- 4 oct 2026
- Licencia
- MIT
¿Qué es Pulltrader MCP?
Pulltrader es un MCP server. Identifica cartas coleccionables, analiza su valor de mercado mediante ventas recientes y calcula las ganancias netas en diversos marketplaces. Expone 17 herramientas, como identify_card, search_card_sales, summarize_card_market.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Pulltrader
Coleccionistas y comerciantes de cartas coleccionables pueden investigar valores de mercado y calcular beneficios potenciales directamente a través de su asistente de IA. Este MCP server de solo lectura ofrece herramientas para convertir descripciones en lenguaje natural en datos estructurados de cartas, recuperar ventas comparables recientes y visualizar gráficos de historial de precios. Está diseñado para usuarios de Claude, ChatGPT y Cursor que necesitan acceso rápido a la economía de las cartas coleccionables sin cambiar de aplicación.
El servidor incluye un motor determinista para estimar las ganancias del vendedor en varios marketplaces como eBay y Pulltrader. Calcula el beneficio neto teniendo en cuenta esquemas de comisiones específicos, gastos de envío y planes de vendedor. Los usuarios también pueden determinar el precio de venta exacto necesario para alcanzar un objetivo específico de ingresos netos. Más allá de la investigación de mercado, el sistema incluye una herramienta Kapture para verificar si el certificado de una carta coincide con un registro de cartas robadas.
La configuración requiere la conexión a un endpoint HTTP remoto. El servicio es público y no requiere autenticación, aunque aplica límites de tasa para gestionar el uso de datos. Todas las cifras de mercado son estimaciones basadas en ventas recientes, y todos los cálculos financieros los realiza el servidor para garantizar la precisión en lugar de depender de la inferencia del modelo.
Qué puedes hacer con él
- 1Identificar cartas coleccionables específicasConvierte una descripción textual de una carta en datos estructurados que incluyen jugador, set y grado.
- 2Analizar tendencias de valor de mercadoConsulta ventas comparables recientes y gráficos de historial de precios para entender el valor de una carta.
- 3Comparar la rentabilidad en marketplacesCalcula cuánto dinero te quedará realmente al vender una carta en diferentes plataformas.
- 4Calcular precios de venta objetivoEncuentra el precio de publicación necesario para asegurar que alcances un objetivo de beneficio neto específico tras las comisiones.
- 5Verificar la autenticidad de una cartaComprueba un número de certificación en un registro para ver si la carta ha sido reportada como robada.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Pulltrader MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Pulltrader MCP en Claude Code
$ claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpInstalar Pulltrader MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp"
}
}
}Instalar Pulltrader MCP en VS Code
.vscode/mcp.json
{
"servers": {
"pulltrader-mcp": {
"type": "http",
"url": "https://mcp.pulltrader.app/mcp"
}
}
}Instalar Pulltrader MCP en VS Code CLI
$ code --add-mcp '{"name":"pulltrader-mcp","type":"http","url":"https://mcp.pulltrader.app/mcp"}'Instalar Pulltrader MCP en Codex
$ codex mcp add pulltrader-mcp --url https://mcp.pulltrader.app/mcpInstalar Pulltrader MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.pulltrader-mcp] url = "https://mcp.pulltrader.app/mcp"
Instalar Pulltrader MCP en Gemini CLI
$ gemini mcp add -s user --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpInstalar Pulltrader MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp",
"type": "http"
}
}
}Herramientas de Pulltrader MCP 17
Detectado desde el 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 | — |
Mostrar las 17 herramientasMostrar menos herramientas
seller_levelseller_covers_feesebay_store_subscriptionacquisition_costebay_fee_percent_override
| seller_level | — | |
| seller_covers_fees | — | |
| ebay_store_subscription | — | |
| acquisition_cost | — | |
| ebay_fee_percent_override | — |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblepulltrader/pulltrader-mcp is public and reachablegithub.com/pulltrader/pulltrader-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-04github.com/pulltrader/pulltrader-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en 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.
Preguntas sobre Pulltrader MCP
¿Cómo agrego Pulltrader MCP a Claude Code?
Ejecuta claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Pulltrader MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Pulltrader MCP?
Expone 17 herramientas, incluidas identify_card, search_card_sales, summarize_card_market, get_card_price_history, compare_selling_costs.
¿Puedo identificar una carta usando una imagen?
No, la versión actual solo permite identificar cartas mediante descripciones de texto o campos estructurados.
¿El servidor ofrece asesoramiento financiero?
No, las cifras de mercado proporcionadas son estimaciones y la herramienta no pretende ofrecer asesoramiento financiero.
¿Qué monedas están soportadas?
El servidor actualmente solo admite USD.
¿Cómo se calculan las comisiones del vendedor?
El servidor utiliza un motor determinista para calcular las comisiones en lugar de pedirle al modelo que las infiera a partir de un texto.