NeoSatoshi Card Recognition
Identify trading and football cards in photos and look up Cardmarket prices
- 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-mcpAdd 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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media
Born Then
MCP serverFree MCP server that rolls random historical births weighted by real demographics
- 2 tools
- Remote
- Free
- Education and exams
Haze City
MCP serverMCP server for agents to look around and build in a shared 3D world
- 17 tools
- Remote
- Open source
- Games and play

Vectoroids
MCP serverA first-person 3D asteroids game with a scanner, playable by humans and agents
- 6 tools
- Remote
- Free
- Games and play

Vector Abyss
MCP serverPlay a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn
- 6 tools
- Remote
- Free
- Knowledge and memory