# Valo.IA (ValoTCG)

Valo.IA (ValoTCG) is a Claude Code MCP server for trading card prices and card details. The agent searches for a card and requests prices from sources such as Cardmarket and eBay.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: valotcg
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/valotcg/valo-ia-mcp
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/valoia-valotcg

## What it does

Valo.IA searches trading cards and returns prices with their source, currency, and observation date. It covers 14 trading card games, including Pokémon, Magic: The Gathering, and One Piece Card Game. Separate tools search sealed products, retrieve price history, and compare cards.

The server provides 16 read-only tools, including `identify_card`, `get_card_prices`, and `price_summary`. When a quote cannot be found, the response uses the `missing` status; currencies are not converted. `scan_card` identifies a card from a photo and requires a key with Vision scope.

ValoTCG hosts the server, so it does not need to be built locally. Tool calls require a Valo.Data API key. Sandbox keys are free; `vd_live_…` keys are for paid plans.

## Requirements
- Remote server: `https://api.valotcg.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http valoia-valotcg https://api.valotcg.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add valoia-valotcg --url https://api.valotcg.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "valoia-valotcg": {
            "url": "https://api.valotcg.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "valoia-valotcg": {
            "type": "http",
            "url": "https://api.valotcg.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http valoia-valotcg https://api.valotcg.com/mcp
```

## When to use it
- look up a card by name, number, or edition
- retrieve dated prices from different sources
- compare prices for cards or sealed products
- view a card’s price history for up to 365 days
- identify a card from a photo with a Vision-scope key

## Example prompts
- Find the current Cardmarket price for Charizard ex 199/165 from the 151 set.
- Compare these cards and give the source and date for each price.
- Identify the card in this photo and look up its price.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
