# Suverse MTG Card Search

> Suverse MTG Card Search is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-14).

Search Magic: The Gathering cards by name and return mana cost, card type, rarity, and set name for each matching card.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-tcg-mtg-cards
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-mtg-card-search-ac20d39c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mwv_hz8sybQv2IMdz8_Dg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suverse-mtg-card-search-ac20d39c -d '<json body>'
```

Example prompt: Can you look up the Magic: The Gathering card 'Black Lotus' and tell me its mana cost, type, rarity, and what set it belongs to?

## When to prefer this

Use this endpoint when you need quick, keyless lookups of MTG card metadata (mana cost, type, rarity, set) by card name without needing your own magicthegathering.io API key. Ideal for agents building MTG deck tools, price trackers, or game assistants that need basic card facts. Not suitable if you need full card text, rulings, legality data, or image URLs.

## Known failure modes

- No matching cards found for the given name — returns empty results
- Partial name matches may return many unrelated cards
- Card name typos or misspellings return no results
- magicthegathering.io upstream API downtime causes failures
- Very new or unreleased cards may not be in the database yet

## How this service works

Search Magic: The Gathering cards by name and get mana cost, card type, rarity and set name for each match. Backed by the keyless magicthegathering.io API. Pass a card name like Black Lotus.

## Output

Returns a list of matching Magic: The Gathering cards, each with mana cost (e.g. '{0}'), card type (e.g. 'Artifact'), rarity (e.g. 'Rare', 'Mythic Rare', 'Common'), and set name (e.g. 'Alpha', 'Commander Legends').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-mtg-card-search-ac20d39c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)
