Koskamo

CARDZ MCP

A free, read-only MCP server that provides PSA 10 graded Pokémon and One Piece card data, including prices, population, market cap, and history, directly into AI conversations without requiring authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

CARDZ MCP logo, by Jackz Intelligent Technology Co., Ltd.Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by Jackz Intelligent Technology Co., Ltd.
MCP endpoint (Streamable HTTP)
https://mcp.cardz.game/mcp
Vendor documentation

What you can do with it

  • Find PSA 10 prices for specific Pokémon or One Piece cards
  • View market cap rankings for TCG sets
  • Check population counts for graded cards
  • Retrieve daily price history for card printings

Source and maintenance

Community listingRegistry 1.1.4
Maintenance checked

Protocol and capabilities

Server
cardzmc-public 1.1.5
MCP protocol
2025-06-18
Tools
3 advertised
Resources
1 advertised
Resource templates
0 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {},
  "resources": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Use these tools only for CARDZ physical graded-card data. Cite canonical card URLs and original metric dates. Reference prices are daily published observations, not live quotes. Do not turn null into zero, combine different printings, invent missing figures, or treat the tracked index as the entire market. Search before reading an unknown card ID. Preserve version ambiguity. Provide no trading, purchase, gacha or wallet actions.

Tools

3 advertised

search_cards — Search TCG cards
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the user names a card, set, or collector number and wants to find matching printings or get card IDs for further lookup. Searches CARDZ public graded Pokémon or One Piece cards. Returns candidate printings with names, sets, languages, market ranks, PSA 10 prices, populations, market caps, and canonical card links. Multiple candidates may match; call get_card with the exact id for full metrics. An empty result means no published match.

search_cards input schema
{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "Card name or collector number. Examples: 'Charizard', '199/165', 'OP05-119', 'Van Gogh Pikachu'. At least one meaningful keyword."
    },
    "tcg": {
      "enum": [
        "pokemon",
        "one-piece"
      ],
      "type": "string",
      "description": "Optional: 'pokemon' or 'one-piece'. Omit to search both games."
    },
    "lang": {
      "enum": [
        "en",
        "zh-TW",
        "ja",
        "ko"
      ],
      "type": "string",
      "description": "Language for display labels in the response. Does not filter by card language; use tcg to narrow by game. Printing language is always returned in the result."
    }
  },
  "additionalProperties": false
}
search_cards annotations
{
  "title": "Search TCG cards",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_card — Card metrics & history
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the user wants detailed metrics for a specific card: PSA 10 reference price, population, market cap, price changes, daily history, and canonical URL. Requires an exact card ID from search_cards. Prices are daily published observations in USD, not live or executable quotes. Null values mean data is unavailable for that field — do not substitute zero.

get_card input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
      "maxLength": 96,
      "minLength": 1,
      "description": "Exact CARDZ card ID returned by search_cards, e.g. cmc_fc229f7ae1b256b2119fa79b. Do not guess or construct IDs; always obtain from search_cards first."
    },
    "lang": {
      "enum": [
        "en",
        "zh-TW",
        "ja",
        "ko"
      ],
      "type": "string",
      "description": "Language for display labels in the response. Does not filter by card language; use tcg to narrow by game. Printing language is always returned in the result."
    },
    "historyDays": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Days of price history to include, counting back from the most recent published point. Default 90; max 365. Omit for standard 90-day view."
    }
  },
  "additionalProperties": false
}
get_card annotations
{
  "title": "Card metrics & history",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_market — TCG market rankings
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the user asks about the top-ranked cards by market cap, wants to know which cards are most valuable by the CARDZ index, or requests a leaderboard for Pokémon or One Piece graded cards. Returns the published ranking with PSA 10 prices, populations, market caps, and the effective date of the data. Market cap = PSA 10 reference price × verified PSA 10 population. This index does not represent the full trading-card market.

get_market input schema
{
  "type": "object",
  "required": [],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "zh-TW",
        "ja",
        "ko"
      ],
      "type": "string",
      "description": "Language for display labels in the response. Does not filter by card language; use tcg to narrow by game. Printing language is always returned in the result."
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "How many top-ranked cards to return. Default 10, max 20."
    },
    "scope": {
      "enum": [
        "all",
        "pokemon",
        "one-piece"
      ],
      "type": "string",
      "description": "'pokemon', 'one-piece', or 'all' (combined index). Default: all."
    }
  },
  "additionalProperties": false
}
get_market annotations
{
  "title": "TCG market rankings",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

CARDZ — CARDZ · Collectibles & TCG

Advertised by the server during the last successful anonymous check.

Explore collectible cards through exact-printing search, PSA 10 daily price history and published market rankings. Current data covers Pokémon and One Piece.

CARDZ URI
ui://cardz-marketcap/cardz-1.1.5.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
458 ms
95th percentile latency
458 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 458 ms · metadata changed · 3 tool(s), 1 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http cardz-mcp https://mcp.cardz.game/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add cardz-mcp --url https://mcp.cardz.game/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable cardz-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "cardz-mcp": {
      "url": "https://mcp.cardz.game/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "cardz-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.cardz.game/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start cardz-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "cardz-mcp": {
      "type": "http",
      "url": "https://mcp.cardz.game/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http cardz-mcp https://mcp.cardz.game/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "cardz-mcp": {
      "url": "https://mcp.cardz.game/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "cardz-mcp": {
      "serverUrl": "https://mcp.cardz.game/mcp"
    }
  }
}

Let your agent find its tools

Find servers like CARDZ MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.