# flipzi-mcp

A local MCP server that lets your agent search trading cards and pull prices, history and sold comps from the Flipzi Data API. You supply the Flipzi key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: flipzitcg
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/flipzitcg/flipzi-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/flipzi-mcp

## What it does

It runs on your own machine over stdio, started with `npx`. Nothing is hosted; the only outbound traffic is your own calls to `data.flipzi.io`. Under the hood it is a thin wrapper around the Flipzi Data API, and the tool list follows that API's contract.

Available tools: search cards by name, read the current price with market and confidence, daily history, eBay sold comps, top gainers and losers for a game, and a sealed booster-box value set against an estimate of the cards inside. Some tools sit behind a plan: history starts at Basic, sold comps and box value at Pro, movers and Cardmarket asking prices at Ultra. All of them always show up in the list. Ask for one your plan lacks and the server names the plan that has it, links the upgrade, and charges nothing for the refusal.

Two things to sort out first: a Flipzi key (`fz_live_...`) and Node.js 18+. The key goes into `FLIPZI_API_KEY` in your client config; leave it out and the server fails with a missing-key error. A per-run budget set by `FLIPZI_MCP_MAX_UNITS` (150 units by default) keeps an agent loop from eating your whole month, and `0` removes the cap.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FLIPZI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add flipzi-mcp -e FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add flipzi-mcp --env FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "flipzi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@flipzitcg/mcp"
            ],
            "env": {
                "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "flipzi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@flipzitcg/mcp"
            ],
            "env": {
                "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FLIPZI_API_KEY=<FLIPZI_API_KEY> flipzi-mcp npx -y @flipzitcg/mcp
```
Replace <…> with your own values

## When to use it
- check what a card sells for before buying it
- see what buyers actually paid on eBay
- pull a daily price history for a card
- find the biggest gainers and losers in a game
- compare a sealed booster box price with the cards inside

## Example prompts
- What is an Umbreon VMAX going for right now?
- Show the price history for this card over the last 30 days.
- Which Pokémon cards moved the most this week?

## Similar
- [openrouter-models](https://affpapa.org/en/nevibecode/skills/openrouter-models.md) — skill · 862 installs
- [OCI Pricing](https://affpapa.org/en/nevibecode/mcp/oci-pricing.md) — MCP server · ★ 5
- [backend-patterns](https://affpapa.org/en/nevibecode/skills/backend-patterns.md) — skill · 6000 installs
- [api-pagination](https://affpapa.org/en/nevibecode/skills/api-pagination.md) — skill · 489 installs
- [idempotency-handling](https://affpapa.org/en/nevibecode/skills/idempotency-handling.md) — skill · 401 installs
- [Financial Modeling Prep MCP Server](https://affpapa.org/en/nevibecode/mcp/financial-modeling-prep-mcp-server.md) — MCP server · ★ 150

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