PokéWallet MCP server
card prices in your AI assistant

How it works

1. Your clientClaude Code, Cursor, VS Code…Holds your key in its own config.
2. Bearer pk_…
3. mcp.pokewallet.ioKeeps nothingForwards your key, stores and logs nothing.
4. your key
5. api.pokewallet.ioYour plan, your quotaEach tool call uses one request.

Connect your client

Pick your client and paste the configuration. The key goes in the Authorization header; keep it in an environment variable where the client supports it.

claude mcp add --transport http pokewallet https://mcp.pokewallet.io/mcp \
  --header "Authorization: Bearer $POKEWALLET_API_KEY"

{
  "mcpServers": {
    "pokewallet": {
      "url": "https://mcp.pokewallet.io/mcp",
      "headers": { "Authorization": "Bearer ${env:POKEWALLET_API_KEY}" }
    }
  }
}

{
  "servers": {
    "pokewallet": {
      "type": "http",
      "url": "https://mcp.pokewallet.io/mcp",
      "headers": { "Authorization": "Bearer ${input:pokewallet-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "pokewallet-key", "description": "PokeWallet API key", "password": true }
  ]
}

{
  "mcpServers": {
    "pokewallet": {
      "httpUrl": "https://mcp.pokewallet.io/mcp",
      "headers": { "Authorization": "Bearer $POKEWALLET_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "pokewallet": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.pokewallet.io/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer pk_live_xxx" }
    }
  }
}

URL     https://mcp.pokewallet.io/mcp   (Streamable HTTP)
Header  Authorization: Bearer <your key>

Claude Code

Terminal. Add --scope user to have the server in every project; /mcp inside Claude Code shows whether it is connected.

Cursor

~/.cursor/mcp.json, or .cursor/mcp.json in a project.

VS Code

.vscode/mcp.json in a project, or MCP: Open User Configuration. VS Code asks for the key on first start and stores it securely.

Gemini CLI

~/.gemini/settings.json, or .gemini/settings.json in a project.

Claude Desktop

claude_desktop_config.json (Settings → Developer → Edit Config), through mcp-remote. Replace pk_live_xxx with your key, keep the file private and restart the app.

Other clients

Windsurf, Cline, Zed or your own code with an MCP SDK: give the client the URL and the header. A client that only runs local servers can use the mcp-remote setup.

Tools

10 read-only tools. A game parameter picks pokemon (default), onepiece or one of the ten game codes.

• list_gamesFree

  The ten games and their codes.

• search_cardsFree

  Cards matching a name, with prices. At most 10 results.

• get_cardFree

  One card with every finish and price.

• list_setsFree

  All sets, filtered by name or language.

• get_setFree

  The cards of a set. An ambiguous code returns the alternatives.

• get_price_historyPro

  Price at 7, 14, 30, 60 and 120 days. Pokémon only.

• top_cardsPro

  Ranking by price or by 7-day growth.

• trending_setsPro

  Sets with the biggest CardMarket price moves over the last 7 days.

• set_statisticsPro

  Average, min, max, most expensive card and rarity breakdown of a set.

• set_completion_valuePro

  Cost of one copy of every card in a set.

Pro tools need the Pro plan for Pokémon and One Piece, the Ultra plan for the ten other games, or the 7-day free trial. See plans

Try asking

• Find Charizard ex cards and their CardMarket trend price
• Which One Piece sets moved most this week?
• What does it cost to complete Phantasmal Flames?
• Top 10 Magic cards by TCGPlayer price

Your key stays yours

• Nothing stored. The server is stateless: your key travels in the request header to the PokéWallet API and is never saved or logged.
• Read-only. No tool changes your account, your keys or your plan. It only reads cards, sets and prices.
• Open source. The code is on GitHub ↗, and you can run it on your own machine.

gh repo clone pokewallet-lab/pokewallet-sdk && cd pokewallet-sdk
(cd packages/ts && npm install && npm run build)
cd packages/mcp && npm install && npx wrangler dev

Frequently asked questions