Flipzi Mcp

io.flipziPublished by flipzi.iov0.1.1Updated Nov 4, 2026

Trading card prices, sold comps, history and movers from the Flipzi Data API. Bring your own key.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that lets an assistant look up trading card prices, sold comps, price history and market movers through the Flipzi Data API using your own key.

What you can do
  • Look up games, sets and cards, and search cards by name
  • Get current prices with market and confidence, plus daily price history
  • See what buyers actually paid on eBay (sold comps) and Cardmarket asking prices by language, finish and grade
  • Check biggest gainers and losers for a game, and sealed booster-box value versus estimated contents
  • Check your plan, allowance used and which tools it unlocks
When to use it
Useful when you want an assistant to answer questions about trading card values, recent sales or market movement while chatting, without leaving the client. Worth adding if you already collect or trade cards and want quick price checks in Claude, Cursor or another MCP client.
Requirements
Node.js 18+ and npx to run the local package over stdio. A Flipzi account and API key supplied as the FLIPZI_API_KEY environment variable; a free plan key is available. Network access to the Flipzi Data API. Optional settings include FLIPZI_MCP_MAX_UNITS and FLIPZI_MCP_NO_CLIENT_TAG.
Before you install
The API key is a secret placed in your client config; do not commit config files containing it. Calls consume monthly units per account (movers cost 5), and higher-tier tools such as sold comps, history, movers and box value need paid plans. Requests go to the Flipzi API with your key and a client header identifying the MCP server unless opted out; links printed include tracking parameters. Data is informational only and the free plan carries no commercial-use grant.

Installation

In SourceWeft

  1. Open Flipzi Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Flipzi MCP server

Ask Claude, Cursor or any MCP client about trading card prices: search cards, get current prices, sold comps, price history, market movers, games and sets. It is a thin local wrapper over the Flipzi Data API. You bring your own Flipzi API key; the free plan needs no card.

Runs on your machine over stdio (npx). Nothing is hosted, and the only network traffic is your requests to data.flipzi.io.

Source: https://github.com/flipzitcg/flipzi-mcp. Public mirror; please report problems as GitHub issues rather than pull requests.

1. Get a key (free)

  1. Create an account: https://flipzi.io/account/register?product=data&utm_source=npm&utm_medium=directory&utm_campaign=202610_mcp
  2. Verify your email. A free key allowance (500 units/month, 5 requests/minute) is created for you.
  3. Create a key at https://flipzi.io/account/keys (it starts with fz_live_ and is shown once).

2. Add it to your AI tool

Requires Node.js 18+. Replace fz_live_... with your key.

Claude Code

bash
claude mcp add --env FLIPZI_API_KEY=fz_live_... --transport stdio flipzi -- npx -y @flipzitcg/mcp

Check with claude mcp list or /mcp. Add --scope user to use it in every project.

Claude Desktop (one click) — once the release publishes it, download flipzi-mcp.mcpb from the GitHub releases and open it; Claude Desktop asks for your key in a masked field.

Claude Desktop (config file) — Settings → Developer → Edit Config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows), then fully quit and reopen the app:

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

Cursor — add the same block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Do not commit a file containing your key.

Then ask: "What's an Umbreon VMAX worth right now?" or call flipzi_account to see your plan.

Tools

ToolNeedsUnitsWhat it does
flipzi_accountany key0Your plan, allowance used, which tools your plan unlocks
flipzi_list_gamesFree1Supported games
flipzi_list_setsFree1Sets of a game
flipzi_list_set_cardsFree1Cards in a set (gets card ids)
flipzi_search_cardsFree1Search by name
flipzi_get_cardFree1Card details
flipzi_get_priceFree1Current price, market and confidence (graded needs Pro)
flipzi_get_historyBasic1Daily history (30 days on Basic, longer on Pro+)
flipzi_get_sold_compsPro1What buyers actually paid on eBay
flipzi_get_moversUltra5Biggest gainers/losers for a game
flipzi_get_box_valuePro1Sealed booster-box price vs the estimated value of the cards inside (English Pokémon boxes that pass checks; a range, not a promise)
flipzi_get_cardmarket_conditionsUltra1Cardmarket asking prices per language, finish and Cardmarket grade (Mint to Poor): cheapest and median, with the date read

Requirements are read from the API's own contract (openapi.yaml, version in src/plans.generated.ts), not guessed. Plans and prices: https://flipzi.io/api/pricing/?utm_source=npm&utm_medium=directory&utm_campaign=202610_mcp. Every tool is always listed. When your plan does not include one, the tool says so, names the plan that does, links the upgrade, and the refusal costs 0 units.

Allowance and limits

  • One unit per call (movers 5). The API counts per account per UTC month; flipzi_account shows what is left.
  • The free plan allows 5 requests per minute. A short wait (≤10 s) is retried once automatically; longer waits are reported.
  • Session budget: this server stops itself after FLIPZI_MCP_MAX_UNITS units per run (default 150) so an agent loop cannot burn your month. Set 0 for unlimited. Restart the server to reset it.
  • Output is capped at about 20 KB per call; search returns 10 cards by default.

Settings (environment variables)

VariableDefault
FLIPZI_API_KEYrequiredYour key. Never printed or logged.
FLIPZI_MCP_MAX_UNITS150Per-run unit budget, 0 = unlimited
FLIPZI_MCP_NO_CLIENT_TAGunset1 stops sending the client header below
FLIPZI_API_BASEhttps://data.flipzi.ioFor testing only

What is sent, and what Flipzi learns (no hidden telemetry)

  • Your requests go to data.flipzi.io with your key, exactly as any API client would. There is no other network call, no analytics service, no update check, and no remote control.
  • Each request carries User-Agent: flipzi-mcp/<version> and X-Flipzi-Client: mcp/<version>. Flipzi records only that the call came from the MCP server (the value mcp), so it can count MCP usage and see which plan-locked tools people try. Opt out with FLIPZI_MCP_NO_CLIENT_TAG=1; everything works the same.
  • Links this server prints (signup, keys, upgrade) include utm_source=mcp so Flipzi can tell that an account started from here. They are plain query parameters you can delete.
  • Prompts, conversations and card queries are not sent anywhere except as the API parameters of the call you asked for.

Troubleshooting

  • "FLIPZI_API_KEY is not set" — the key is missing from the env of your client config; restart the client after editing.
  • Tools don't appear in Claude Desktop — fully quit and reopen; check ~/Library/Logs/Claude/mcp-server-flipzi.log (macOS) or %APPDATA%\Claude\logs (Windows). On Windows, if npx fails, install npm globally (npm install -g npm).
  • "Not on your plan" — expected; see the table. Run flipzi_account.
  • Quote the request_id in any error when contacting support. See SUPPORT.md.

The free plan carries no commercial-use grant. Data is for informational use; see the API terms. MIT licensed.

Source: README.md at commit 35b5dae

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestOct 14, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts