CardMind API

Quickstart

Get your first API response in under 5 minutes.

1. 1

   Sign up at cardmind.app

   Create a free account at cardmind.app. Free accounts include 1,000 API calls per month with no credit card required.

2. 2

   Generate your API key in Settings

   Go to cardmind.app/settings and create an API key. Your key will be prefixed with cm_live_. Keep it secret — it authenticates all your requests.

3. 3

   Make your first request

   Search for any Magic: The Gathering card using the /api/cards/search endpoint. Replace cm_live_YOUR_KEY with your actual key.

   curl "https://api.cardmind.app/api/cards/search?q=lightning+bolt" \
     -H "Authorization: Bearer cm_live_YOUR_KEY"

Base URL

All API requests are made to:

https://api.cardmind.app

Key Concepts

Authentication

Pass your API key as a Bearer token in the Authorization header on every request.

Rate Limits

Free tier: 10 requests/min, 1,000/month. Premium tier: 60 requests/min, unlimited. Rate limit headers are returned with every response.

Response Format

All endpoints return JSON with a consistent envelope: { data: ..., error: null } on success or { data: null, error: { message, code } } on failure.

MCP Protocol

Connect Claude Desktop or any MCP client to https://api.cardmind.app/mcp for natural language card lookups, price checks, and market signals.