flipzi-mcp — MCP-сервер для Claude Code: цены на карточки TCG
Локальный MCP-сервер, через который агент ищет карточки, смотрит цены, историю и проданные лоты из Flipzi Data API. Нужен свой ключ Flipzi.
claude mcp add flipzi-mcp -e FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcpЧто делает flipzi-mcp
Сервер запускается у вас на машине через npx и общается по stdio. Хост не нужен: сеть уходит только в data.flipzi.io, когда агент вызывает инструмент. Внутри — тонкая обёртка над Flipzi Data API, список инструментов один в один повторяет её контракт.
Что умеет: искать карточки по имени, тянуть текущую цену с рынком и уверенностью, дневную историю, проданные лоты на eBay, крупнейших выросших и упавших за период, стоимость запечатанного бустера в сравнении с оценкой карт внутри. Часть инструментов привязана к тарифу: история с Basic, проданные лоты и бокс с Pro, муверы и цены Cardmarket с Ultra. Инструменты видны всегда — если тариф не тот, сервер назовёт подходящий и откажет бесплатно.
Заранее нужно два: ключ Flipzi (fz_live_...) и Node.js 18+. Ключ подставляется в переменную FLIPZI_API_KEY в конфиге клиента — без неё сервер не стартует с ошибкой о незаданном ключе. Лимит на прогон задаёт FLIPZI_MCP_MAX_UNITS (по умолчанию 150 единиц), чтобы цикл агента не сжёг месячный запас; 0 снимает потолок.
Какие задачи решает
- узнать текущую цену карточки перед покупкой
- посмотреть, за сколько реально продавались такие карточки на eBay
- вытянуть дневную историю цены за период
- найти самые подорожавшие и подешевевшие карточки игры
- сравнить цену запечатанного бустера с оценкой карт внутри
Примеры запросов агенту
- Сколько сейчас стоит Umbreon VMAX?
- Покажи историю цены за последние 30 дней для этой карточки.
- Какие карточки Pokémon сильнее всего выросли?
Как установить flipzi-mcp
Командой платформы
claude mcp add flipzi-mcp -e FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add flipzi-mcp --env FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"flipzi-mcp": {
"command": "npx",
"args": [
"-y",
"@flipzitcg/mcp"
],
"env": {
"FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"flipzi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flipzitcg/mcp"
],
"env": {
"FLIPZI_API_KEY": "<FLIPZI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FLIPZI_API_KEY=<FLIPZI_API_KEY> flipzi-mcp npx -y @flipzitcg/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о flipzi-mcp
Как установить flipzi-mcp в Claude Code?
Выполните claude mcp add flipzi-mcp -e FLIPZI_API_KEY=<FLIPZI_API_KEY> -- npx -y @flipzitcg/mcp, подставив свой ключ. Проверить подключение можно через claude mcp list или /mcp.
Что делает flipzi-mcp?
Даёт агенту инструменты к Flipzi Data API: поиск карточек, текущая цена, история, проданные лоты, муверы и стоимость боксов. Работает локально по stdio.
Нужен ли платный ключ Flipzi?
Нет, бесплатный тариф выдаёт ключ сразу после регистрации и подтверждения почты. Но часть инструментов — история, проданные лоты, муверы — открывается только на платных тарифах.
