Pulltrader MCP server
2026년 10월 4일 커밋트레이딩 카드를 식별하고, 최근 판매 데이터를 통해 시장 가치를 분석하며, 다양한 마켓플레이스에서의 순수익을 계산합니다.
다른 이름 pulltrader/pulltrader-mcp, pulltrader-mcp
- 스타
- 0
- Tools
- 17
- 다운로드, 30일
- —
- 최신 버전
- 0.6.1
- 마지막 커밋
- 2026년 10월 4일
- 라이선스
- MIT
Pulltrader MCP란?
Pulltrader은(는) MCP server입니다. 트레이딩 카드를 식별하고, 최근 판매 데이터를 통해 시장 가치를 분석하며, 다양한 마켓플레이스에서의 순수익을 계산합니다. 17개 도구를 제공합니다. 예: identify_card, search_card_sales, summarize_card_market.
프로젝트 README에서 생성된 요약
Pulltrader MCP server 정보
트레이딩 카드 수집가와 딜러는 AI 어시스턴트를 통해 시장 가치를 조사하고 잠재적 수익을 직접 계산할 수 있습니다. 이 read-only MCP server는 자연어 설명을 구조화된 카드 데이터로 변환하고, 최근 유사 판매 사례를 조회하며, 가격 변동 차트를 볼 수 있는 도구를 제공합니다. 애플리케이션을 전환하지 않고도 트레이딩 카드 경제 데이터를 빠르게 확인해야 하는 Claude, ChatGPT, Cursor 사용자에게 최적화되어 있습니다.
이 서버에는 eBay 및 Pulltrader와 같은 다양한 마켓플레이스의 판매 수익을 추정하는 결정론적 엔진이 포함되어 있습니다. 특정 수수료 체계, 배송비, 판매자 플랜을 고려하여 순이익을 계산합니다. 사용자는 또한 특정 목표 실수령액을 달성하기 위해 필요한 정확한 판매 가격을 결정할 수 있습니다. 시장 조사 외에도, 카드의 인증 번호가 도난 카드 등록부와 일치하는지 확인하는 Kapture 도구가 포함되어 있습니다.
설정을 위해서는 원격 HTTP 엔드포인트 연결이 필요합니다. 이 서비스는 공개 서비스이며 인증이 필요하지 않지만, 데이터 사용량 관리를 위해 rate limit을 적용합니다. 모든 시장 수치는 최근 판매를 기반으로 한 추정치이며, 정확성을 보장하기 위해 모든 금융 계산은 모델의 추론에 의존하지 않고 서버에서 직접 수행됩니다.
활용 사례
- 1특정 트레이딩 카드 식별카드의 텍스트 설명을 플레이어, 세트, 등급을 포함한 구조화된 데이터로 변환합니다.
- 2시장 가치 트렌드 분석최근 유사 판매 사례와 가격 변동 차트를 확인하여 카드의 가치를 파악합니다.
- 3마켓플레이스 수익성 비교다양한 플랫폼에서 카드를 판매할 때 실제로 손에 쥐게 될 금액을 계산합니다.
- 4목표 판매 가격 계산수수료를 제외하고 특정 순이익 목표를 달성하기 위해 필요한 리스팅 가격을 찾습니다.
- 5카드 정품 확인인증 번호를 등록부와 대조하여 카드가 도난 신고되었는지 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Pulltrader MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Pulltrader MCP 설치
$ claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpCursor에 Pulltrader MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp"
}
}
}VS Code에 Pulltrader MCP 설치
.vscode/mcp.json
{
"servers": {
"pulltrader-mcp": {
"type": "http",
"url": "https://mcp.pulltrader.app/mcp"
}
}
}VS Code CLI에 Pulltrader MCP 설치
$ code --add-mcp '{"name":"pulltrader-mcp","type":"http","url":"https://mcp.pulltrader.app/mcp"}'Codex에 Pulltrader MCP 설치
$ codex mcp add pulltrader-mcp --url https://mcp.pulltrader.app/mcpCodex config.toml에 Pulltrader MCP 설치
~/.codex/config.toml
[mcp_servers.pulltrader-mcp] url = "https://mcp.pulltrader.app/mcp"
Gemini CLI에 Pulltrader MCP 설치
$ gemini mcp add -s user --transport http pulltrader-mcp https://mcp.pulltrader.app/mcpGemini settings.json에 Pulltrader MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"pulltrader-mcp": {
"url": "https://mcp.pulltrader.app/mcp",
"type": "http"
}
}
}Pulltrader MCP 도구 17
README에서 감지됨identify_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 | — |
도구 17개 모두 보기도구 수 줄이기
seller_levelseller_covers_feesebay_store_subscriptionacquisition_costebay_fee_percent_override
| seller_level | — | |
| seller_covers_fees | — | |
| ebay_store_subscription | — | |
| acquisition_cost | — | |
| ebay_fee_percent_override | — |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능pulltrader/pulltrader-mcp is public and reachablegithub.com/pulltrader/pulltrader-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-04github.com/pulltrader/pulltrader-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음17 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
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)
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.
Pulltrader MCP 질문
Pulltrader MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http pulltrader-mcp https://mcp.pulltrader.app/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Pulltrader MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Pulltrader MCP는 어떤 도구를 제공하나요?
17개 도구를 제공합니다. 예: identify_card, search_card_sales, summarize_card_market, get_card_price_history, compare_selling_costs.
이미지를 사용하여 카드를 식별할 수 있나요?
아니요, 현재 버전은 텍스트 기반의 설명이나 구조화된 필드를 통한 카드 식별만 지원합니다.
이 서버가 금융 조언을 제공하나요?
아니요, 제공되는 시장 수치는 추정치이며 이 도구는 금융 조언을 제공하지 않습니다.
지원되는 통화는 무엇인가요?
현재 이 서버는 USD만 지원합니다.
판매 수수료는 어떻게 계산되나요?
모델이 텍스트에서 추론하도록 하는 대신, 결정론적 엔진을 사용하여 수수료를 계산합니다.