About onepiece-oracle
onepiece-oracle is an MCP server for searching and browsing One Piece Card Game cards and analyzing decks. It uses community-maintained card data and includes tools for set and card-variant exploration.
Key features
- 01Search cards with detailed filters
- 02Browse sets and their cards
- 03View card printings and variants
- 04Browse Leader cards by color
- 05Analyze deck cost and color distribution
- 06Find cards with counter values
Use cases
- 01Search cards by attributes or set
- 02Explore cards in a particular set
- 03Compare printings and alternate art
- 04Review deck composition and find defensive counters
MCP support
The MCP server exposes tools for card search, set browsing, card versions, Leader browsing, deck cost-curve analysis, and counter discovery.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| set | string | No | Set name or code (e.g., "OP-01", "ROMANCE DAWN") |
| cost | number | No | Exact cost value |
| type | string | No | Character type (e.g., "Straw Hat Crew", "Navy", "Supernovas") |
| color | string | No | Card color: Red, Blue, Green, Purple, Yellow, Black |
| limit | number | No | Max results (default 10) |
| query | string | No | Search card name, number, effect text, or character type |
| offset | number | No | Offset for pagination |
| rarity | string | No | Rarity: C, UC, R, SR, SEC, L, SP CARD, P, TR |
| cost_max | number | No | Maximum cost |
| cost_min | number | No | Minimum cost |
| attribute | string | No | Attribute: Slash, Strike, Ranged, Special, Wisdom |
| card_type | string | No | Card type: LEADER, CHARACTER, EVENT, STAGE |
| power_max | number | No | Maximum power |
| power_min | number | No | Minimum power |
| has_counter | boolean | No | Filter cards with/without counter value |
Details
From the project READMEonepiece-oracle
One Piece TCG MCP server — card search, deck analysis, and set browsing for the One Piece Card Game.
What It Does
Search, browse, and analyze One Piece TCG cards with ground-truth data from the community-maintained card database. 4,348 cards across all sets (OP-01 through OP-14, Starter Decks, Event Boosters, and Promos).
Tools
| Tool | Description |
|---|---|
search_cards | Full-text search with filters for color, type, cost, power, rarity, attribute, character type, and set. |
browse_sets | List all sets with card counts, or view cards in a specific set. |
card_versions | Show all printings of a card including alternate art variants. |
browse_leaders | Browse all Leader cards, optionally filtered by color. |
analyze_cost_curve | Parse a deck list and show cost distribution, color breakdown, type spread, and counter summary. |
find_counters | Find cards with counter values for defensive deck building. |
Install
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"onepiece-oracle": {
"command": "npx",
"args": ["-y", "onepiece-oracle"]
}
}
}
Claude Code
claude mcp add onepiece-oracle -- npx -y onepiece-oracle
Disclaimer
This is a fan-made, non-commercial project for informational and educational purposes only. One Piece Card Game is a trademark of Bandai Co., Ltd. and Shueisha Inc. One Piece is created by Eiichiro Oda. This project is not produced, endorsed, supported, or affiliated with Bandai or Shueisha. Card data is sourced from community-maintained databases.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.