# myfigurecollection-api

myfigurecollection-api is an MCP server for Claude Code that searches MyFigureCollection and reads figure records. It can also look up barcodes, shop listings, collections, and clubs.

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

## What it does

myfigurecollection-api connects an AI agent to MyFigureCollection through a local MCP server. Its tools search figures and shops, retrieve item details, collections, user lists, and club information, and match items by JAN or UPC barcode. The server communicates over stdio.

Installation requires Python 3.10 or newer. The `uvx` setup also needs `uv`; alternatively, the MCP configuration can point to the absolute path of the installed `mfc-api` script. The package fetches public HTML with `curl_cffi`, since Cloudflare returns 403 to regular clients such as `requests`, `httpx`, and `aiohttp`. Price and stock checks depend on MyFigureCollection having a barcode for the item.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add myfigurecollection-api -- uvx myfigurecollection-api
```
uvx runs the command named after the package; if the README names another one, use uvx --from myfigurecollection-api <command>

### Codex

**Platform CLI**
```bash
codex mcp add myfigurecollection-api -- uvx myfigurecollection-api
```
uvx runs the command named after the package; if the README names another one, use uvx --from myfigurecollection-api <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "myfigurecollection-api": {
            "command": "uvx",
            "args": [
                "myfigurecollection-api"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from myfigurecollection-api <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "myfigurecollection-api": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "myfigurecollection-api"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from myfigurecollection-api <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add myfigurecollection-api uvx myfigurecollection-api
```
uvx runs the command named after the package; if the README names another one, use uvx --from myfigurecollection-api <command>

## When to use it
- find a figure in the MyFigureCollection catalog
- match an item using its JAN or UPC barcode
- check partner shops for prices and availability
- read a user's collection or published item lists
- retrieve club details and its member roster

## Example prompts
- Find this figure on MyFigureCollection and show its item details.
- Check which partner shops list this figure and show their prices.
- Look up the MyFigureCollection item with JAN barcode 1234567890123.

## Similar
- [prisma-client-api](https://affpapa.org/en/nevibecode/skills/prisma-client-api.md) — skill · 441400 installs
- [Multi-Carrier Shipping API — powered by Secureship](https://affpapa.org/en/nevibecode/mcp/multi-carrier-shipping-api-powered-by-secureship.md) — MCP server · 6130 installs
- [NEXUS Intelligence API](https://affpapa.org/en/nevibecode/mcp/nexus-intelligence-api.md) — MCP server · 4735 installs
- [Weather API — Current & 7-Day Forecast Worldwide](https://affpapa.org/en/nevibecode/mcp/weather-api-current-7-day-forecast-worldwide.md) — MCP server · 4044 installs
- [Shirabe Calendar API](https://affpapa.org/en/nevibecode/mcp/shirabe-calendar-api.md) — MCP server · 2944 installs
- [middleBrick | API-Security](https://affpapa.org/en/nevibecode/mcp/middlebrick-api-security.md) — MCP server · 2930 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
