MCP server

Give an AI agent the Partner API as tools.

If your integration is an AI agent, connect it to our Model Context Protocol server instead of writing HTTP calls. Every tool calls the same REST endpoint documented here, with your key, so scopes, idempotency and purchase limits apply exactly the same way.

• URL: https://catchbackcards.com/api/mcp
• Transport: Streamable HTTP, stateless, JSON responses
• Auth: the same Authorization: Bearer cb_live_... header

The agent only sees the tools your key has scopes for.

Connect

Claude Code

claude mcp add --transport http catchback https://catchbackcards.com/api/mcp \
  --header "Authorization: Bearer cb_live_..."

JSON config

{
  "mcpServers": {
    "catchback": {
      "type": "http",
      "url": "https://catchbackcards.com/api/mcp",
      "headers": { "Authorization": "Bearer cb_live_..." }
    }
  }
}

Tools

Tool	Endpoint	Scope
list_packs	List packs	read:catalog
get_pack_pool	Get a pack’s pool	read:catalog
search_cards	Search shop cards	read:catalog
buy_packs	Buy packs	rip:packs
get_balance	Get account	read:account
get_vault	Get vault	read:account
sell_back_cards	Sell back cards	sell:cards
list_card	List a card	write:listings
delist_card	Delist a card	write:listings

buy_packs takes an order_id argument, which is sent as the Idempotency-Key. Have your agent generate one per order and reuse it when retrying that order. A retry under a new order_id is a new order and opens a second set of packs.

An error comes back as a tool result with isError: true and the HTTP status in the text, so the agent can read it and react.