# NeoSatoshi Card Recognition

> NeoSatoshi Card Recognition is a freemium MCP server for games and play. Identify trading and football cards in photos and look up Cardmarket prices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://neosatoshi.com/developers/detection-api
- **Repository:** https://github.com/cookiebreed/card-recognition-api/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.Cookiebreed/card-recognition-mcp
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/neosatoshi-card-recognition
