Skip to content
MCP server

NeoSatoshi Card Recognition

Identify trading and football cards in photos and look up Cardmarket prices

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.7.0
Listing updated
3 days ago

About NeoSatoshi Card Recognition

NeoSatoshi Card Recognition is a freemium MCP server for games and play. It runs locally on your machine and is started by your AI client.

Cards in a photo, including binder pages with several at once, are sent to NeoSatoshi's recognition API and come back as JSON. Each result has name, set, number, rarity, language, Cardmarket ID and a daily price, with a confidence value and a hint when a card should be reviewed. Football and basketball cards return the player, release and suggested parallel instead.

Supported games are Pokémon, One Piece, Disney Lorcana, Yu-Gi-Oh!, Magic: The Gathering, Star Wars: Unlimited, Digimon, Cyberpunk TCG and Riftbound. Japanese cards are matched too, and the Japanese name is returned. The recognize_cards tool takes a local file, a public image URL or base64 data and an optional game. The assistant can also search the catalog and correct a wrong match with correct_card, and Digimon and Cyberpunk printings that look alike come back as alternatives with their own prices.

It is a local stdio server from the npm package neosatoshi-card-mcp and needs Node.js 18 or newer. Without an API key it uses a shared demo key limited to 10 detections a day per network. A free account includes 50 cards a month, and paid plans go up to 10,000. An optional setting restricts which directories it may read images from.

Install

Run in a terminal

claude mcp add card-recognition-mcp --env NEOSATOSHI_API_KEY='<NEOSATOSHI_API_KEY>' -- npx -y neosatoshi-card-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "card-recognition-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "neosatoshi-card-mcp"
      ],
      "env": {
        "NEOSATOSHI_API_KEY": "<NEOSATOSHI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "card-recognition-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "neosatoshi-card-mcp"
      ],
      "env": {
        "NEOSATOSHI_API_KEY": "<NEOSATOSHI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "card-recognition-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "neosatoshi-card-mcp"
      ],
      "env": {
        "NEOSATOSHI_API_KEY": "<NEOSATOSHI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "card-recognition-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "neosatoshi-card-mcp"
      ],
      "env": {
        "NEOSATOSHI_API_KEY": "<NEOSATOSHI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "card-recognition-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "neosatoshi-card-mcp"
      ],
      "env": {
        "NEOSATOSHI_API_KEY": "<NEOSATOSHI_API_KEY>"
      }
    }
  }
}

Configuration

  • NEOSATOSHI_API_KEYYour NeoSatoshi API key. Optional: without it the public demo key is used (10 detections per day per network).
  • NEOSATOSHI_ALLOWED_DIRSOptional list of directories the server may read images from, separated by ':' (';' on Windows). Unset means any readable image file.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

recognize_cards
Identify cards in a photo from a file path, URL or base64 data
correct_card
Pick the right printing when a match is wrong or unconfirmed

What it does

Multi-card photos
Binder pages return one parsed object per card.
Many games
Covers nine trading card games plus football and basketball cards.
Cardmarket prices
Results include the Cardmarket ID and daily price, plus TCGplayer for some games.
Review hints
Low-confidence cards are marked so you can check them.
Catalog search and correction
Search the catalog and fix a wrong match with correct_card.
Folder access control
NEOSATOSHI_ALLOWED_DIRS limits where images are read from.

Good for

  • Value a binder page of Pokémon cards from one photo
  • Catalogue a folder of card photos
  • Check Cardmarket prices for cards you want to sell
  • Fix a misidentified card with a correction
  • Log football card parallels from collection photos

Pricing

Freemium

Demo key: 10 detections a day; free account 50 cards a month; paid plans up to 10,000 cards; prices not published here

Prices change. Check neosatoshi.com before you buy.

NeoSatoshi Card Recognition FAQ

Do I need an API key?

No. Without one, a shared demo key allows 10 detections a day per network.

What does a free account include?

50 cards a month; paid plans go up to 10,000.

Which runtime does it need?

Node.js 18 or newer, installed from the npm package neosatoshi-card-mcp.

Does it download image URLs itself?

No. A public URL is forwarded to the API as is; the server never downloads it.

Is NeoSatoshi Card Recognition free?

NeoSatoshi Card Recognition has a free plan, with paid plans for more usage or features.

How do I add NeoSatoshi Card Recognition to Claude Code?

Run this command in your terminal: claude mcp add card-recognition-mcp --env NEOSATOSHI_API_KEY='<NEOSATOSHI_API_KEY>' -- npx -y neosatoshi-card-mcp

What are the best alternatives to NeoSatoshi Card Recognition?

The closest alternatives to NeoSatoshi Card Recognition are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

Alternatives to NeoSatoshi Card Recognition

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory