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.
Two ways to integrate
1. MCP server (for AI assistants)
Drop the VendBro MCP server into Claude Desktop, Cursor, or Zed. The AI gets tools to scan cards, query inventory, and manage sessions on the user's behalf. No code required — just a config snippet and an API key.
{
"mcpServers": {
"vendbro": {
"command": "npx",
"args": ["-y", "@vendbro/mcp-server"],
"env": { "VENDBRO_API_KEY": "vb_live_..." }
}
}
}
Tools included: vendbro_recognize_card, vendbro_lookup_card,
vendbro_list_scans, vendbro_add_scan,
vendbro_list_sessions, vendbro_create_session,
vendbro_list_inventory.
2. REST API (for everything else)
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_..."Getting a key
Sign in at app.vendbro.com, open your profile,
and 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.
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.