# Flipzi MCP

> Flipzi MCP is a freemium MCP server for antiques and collectibles. Trading card prices, sold comps and market movers from the Flipzi Data API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Repository:** https://github.com/flipzitcg/flipzi-mcp
- **MCP Registry name:** io.flipzi/flipzi-mcp
- **Categories:** [antiques and collectibles](https://ai-powered.com/categories/antiques-and-collectibles), [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

Aimed at collectors and resellers, this local stdio server wraps the Flipzi Data API so an assistant can look up what a card or a sealed product is worth. Ask for something like the value of a specific Pokemon card and it can return the current price with market and confidence, daily price history, eBay sold comps and the biggest gainers and losers for a game. Sealed coverage includes booster boxes, Elite Trainer Boxes and tins with Cardmarket and TCGplayer prices, plus an estimated box-value check.

You bring your own Flipzi API key. The free plan needs no card and gives 500 units a month at 5 requests a minute. Each tool is always listed, but when your plan does not include one it says which plan does, at no unit cost. Free covers games, sets, cards, search and current prices; history, sold comps, sealed search and movers need Basic, Pro or Ultra.

A session budget stops the server after 150 units by default so an agent loop cannot use up the month. The README says the only network traffic is to data.flipzi.io, with no analytics. The free plan has no commercial-use grant.

## Features

- **Card and set lookup:** Lists games, sets and cards, searches by name and fetches card details.
- **Current prices:** Returns price, market and confidence for a card, with graded prices on Pro.
- **Sold comps and history:** Shows what buyers paid on eBay and daily price history on paid plans.
- **Market movers:** Lists the biggest gainers and losers for a game on the Ultra plan.
- **Sealed product search:** Searches over 7,600 sealed products with Cardmarket and TCGplayer prices.
- **Usage guardrails:** A per-run unit budget and an account tool keep API usage in check.

## Good for

- Check what a card is worth before buying or listing it
- Compare sealed box price with estimated card value
- Track gainers and losers in a trading card game
- Review recent eBay sold prices for a card

## Install

### Claude Code (Terminal)

```sh
claude mcp add flipzi-mcp --env FLIPZI_API_KEY='<FLIPZI_API_KEY>' -- npx -y @flipzitcg/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "flipzi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@flipzitcg/mcp"
      ],
      "env": {
        "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "flipzi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@flipzitcg/mcp"
      ],
      "env": {
        "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "flipzi-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@flipzitcg/mcp"
      ],
      "env": {
        "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "flipzi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@flipzitcg/mcp"
      ],
      "env": {
        "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "flipzi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@flipzitcg/mcp"
      ],
      "env": {
        "FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `flipzi_account`: Show plan, allowance used and unlocked tools
- `flipzi_list_games`: List supported games
- `flipzi_list_sets`: List sets of a game
- `flipzi_list_set_cards`: List cards in a set
- `flipzi_search_cards`: Search cards by name
- `flipzi_get_card`: Get card details
- `flipzi_get_price`: Get current price, market and confidence
- `flipzi_get_history`: Get daily price history
- `flipzi_get_sold_comps`: Get eBay sold comps
- `flipzi_get_movers`: Get biggest gainers and losers
- `flipzi_search_sealed`: Search sealed products
- `flipzi_get_sealed_cardmarket`: Get Cardmarket asking prices for a sealed product
- `flipzi_get_box_value`: Compare box price with estimated card value
- `flipzi_get_cardmarket_conditions`: Get Cardmarket prices per condition

## FAQ

### Do I need an API key?

Yes. Create a free account at Flipzi and generate a key starting with fz_live_; the free plan needs no card.

### What does the free plan include?

500 units a month at 5 requests a minute, covering games, sets, cards, search and current prices.

### How is usage limited?

One unit per call (movers cost 5), and the server stops after 150 units per run by default, adjustable with FLIPZI_MCP_MAX_UNITS.

### Is anything tracked?

Requests carry a client tag showing the call came from the MCP server, which can be disabled with FLIPZI_MCP_NO_CLIENT_TAG=1.

### Is Flipzi MCP free?

Flipzi MCP has a free plan, with paid plans for more usage or features.

### How do I add Flipzi MCP to Claude Code?

Run this command in your terminal: claude mcp add flipzi-mcp --env FLIPZI_API_KEY='<FLIPZI_API_KEY>' -- npx -y @flipzitcg/mcp

### What are the best alternatives to Flipzi MCP?

The closest alternatives to Flipzi MCP are Digimon, Disney, Clash Royale, Gamechalk Score Keeper and OSRS Calc MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Digimon](https://ai-powered.com/mcp/digimon): Digimon is a freemium MCP server for games and play.
- [Disney](https://ai-powered.com/mcp/disney): Disney is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [Gamechalk Score Keeper](https://ai-powered.com/mcp/gamechalk-score-keeper): Gamechalk Score Keeper is an MCP server for games and play.
- [OSRS Calc MCP](https://ai-powered.com/mcp/osrs-calc-mcp): OSRS Calc MCP is an open-source MCP server for games and play.
- [Opendota](https://ai-powered.com/mcp/opendota): Opendota is a freemium MCP server for games and play.
- [Reaction Time Test MCP](https://ai-powered.com/mcp/reaction-time-test-mcp): Reaction Time Test MCP is a free MCP server for games and play.
- [20-0 MCP](https://ai-powered.com/mcp/20-0-mcp): 20-0 MCP is an open-source MCP server for games and play.

---
Source: https://ai-powered.com/mcp/flipzi-mcp
