API access is included with Pro ($7.99/mo). Free accounts can still read card data on vendbro.com, but vb_live_ keys require an active paid subscription. Upgrade in your profile →
Using an AI assistant? The VendBro MCP server wraps this API as 15 tools for Claude Desktop, Cursor, and Zed — no code required, just a config snippet and an API key. This page is the raw REST API for everything else.
What you can build
Card identification
POST a card image, get back the card ID, set, condition-aware pricing, and (for JP cards) an English translation hint.
Scan history + sessions
Read a user's scan log. Group by named sessions. Bulk-import rows from your own tool.
Inventory
List, upsert, and sell inventory items. Track binder location, condition, acquired vs market price.
Metadata lookup
Look up a card by name and number without burning a scan — free reads against the card database.
The REST API
Stable, versioned, OpenAPI-documented. Every endpoint takes
Authorization: Bearer vb_live_....
curl https://api.vendbro.com/v1/lookup?name=Charizard\&number=4/102 \
-H "Authorization: Bearer vb_live_..."Prefer an MCP server?
If you're wiring this into an AI assistant rather than writing HTTP calls yourself, use the
VendBro MCP server instead. It wraps the same API — same key, same scopes,
same per-user data — as 15 tools that drop into Claude Desktop, Cursor, or Zed with one
npx config snippet. Full install + tool reference is at vendbro.com/mcp.
Getting a key
Requires Pro. Sign in at app.vendbro.com,
upgrade from your profile if you haven't, then scroll to the
API Keys section. Name your key, pick scopes, hit
Create. The full vb_live_... token is shown
once — copy it into your MCP config or .env.
Security: keys are stored as SHA256 hashes on our side. Revoke any time from the same page — revocation takes effect immediately. If you downgrade to free, existing keys stop working within 60 seconds.
Scopes
Keys carry a list of scopes. Scope down to the minimum the integration needs:
Rate limits
- 120 requests / minute per key for most endpoints.
- 30 requests / minute on
/scan(GPU-backed). This limit is fail-closed: if our rate-limiter is unavailable,/scanreturns 429 instead of letting abuse through. - Over the limit: HTTP
429. Retry after a minute.
Ideas
- Discord bot that posts each scan to a trade channel.
- TCGPlayer auto-lister for everything tagged
readyin a binder. - eBay price-history dashboard pulling the user's last 500 scans.
- Desktop companion app for bulk data-entry via keyboard-only workflows.
- "What's my collection worth?" Slack/Discord slash command powered by the MCP server.
Ready to build?
Generate your first key in the app, then paste the MCP config into Claude Desktop.