{
 "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
 "name": "com.cardvolume/market-data",
 "title": "CardVolume",
 "description": "Verified trading-card sales, market prices by grade, record sales and population for Pokémon, Magic, Yu-Gi-Oh!, sports cards, One Piece and Lorcana. Every figure links to its source page.",
 "version": "1.0.0",
 "websiteUrl": "https://cardvolume.com",
 "serverUrl": "https://cardvolume.com/mcp",
 "remotes": [
  {
   "type": "streamable-http",
   "url": "https://cardvolume.com/mcp"
  }
 ],
 "authentication": {
  "required": false
 },
 "tools": [
  {
   "name": "search_cards",
   "title": "Search cards",
   "description": "Find trading cards tracked by CardVolume by name, set, number or player. Returns ids, titles, headline market price and record sale. Use get_card with an id for full data.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "query": {
      "type": "string",
      "description": "e.g. 'base set charizard 1st edition', 'moonbreon', '1986 fleer jordan'"
     },
     "category": {
      "type": "string",
      "enum": [
       "pokemon",
       "magic",
       "yugioh",
       "sports",
       "one-piece",
       "lorcana",
       "non-sport"
      ]
     },
     "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
     }
    },
    "required": [
     "query"
    ]
   },
   "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
   }
  },
  {
   "name": "get_card",
   "title": "Get card prices and verified sales",
   "description": "Full verified data for one card: key facts, market price for each version and grade (median of at least 5 verified sales in 90 days), last and record sale, population, and every verified sale with its source URL. Accepts a CardVolume id, a card URL, or a search query.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "description": "Card id like 'pokemon/base-set/charizard-4-102' or a cardvolume.com URL"
     },
     "query": {
      "type": "string",
      "description": "Used when id is not known; the best match is returned"
     },
     "max_sales": {
      "type": "integer",
      "minimum": 0,
      "maximum": 200,
      "default": 50
     }
    }
   },
   "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
   }
  },
  {
   "name": "list_record_sales",
   "title": "List verified record sales",
   "description": "Highest verified sale for each card, version and grade, largest first, with venue, date and source URL.",
   "inputSchema": {
    "type": "object",
    "properties": {
     "category": {
      "type": "string",
      "enum": [
       "pokemon",
       "magic",
       "yugioh",
       "sports",
       "one-piece",
       "lorcana",
       "non-sport"
      ]
     },
     "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
     }
    }
   },
   "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
   }
  }
 ]
}