onepiece-oracle
# onepiece-oracle
One Piece TCG MCP server — card search, deck analysis, and set browsing for the One Piece Card Game.
<p align="center">
<a href="https://www.npmjs.com/package/onepiece-oracle"><img src="https://img.shields.io/npm/v/onepiece-oracle.svg" alt="npm version"></a>
<a href="https://www.npmjs.com/package/onepiece-oracle"><img src="https://img.shields.io/npm/dm/onepiece-oracle.svg" alt="npm downloads"></a>
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node.js 18+"></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple.svg" alt="MCP Compatible"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
<a href="https://github.com/sponsors/gregario"><img src="https://img.shields.io/badge/sponsor-♥-ea4aaa.svg" alt="Sponsor"></a>
<a href="https://glama.ai/mcp/servers/gregario/onepiece-oracle"><img src="https://glama.ai/mcp/servers/gregario/onepiece-oracle/badges/score.svg" alt="onepiece-oracle MCP server"></a>
</p>
<!-- mcp-name: io.github.gregario/onepiece-oracle -->
## 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`:
```json
{
"mcpServers": {
"onepiece-oracle": {
"command": "npx",
"args": ["-y", "onepiece-oracle"]
}
}
}
```
### Claude Code
```bash
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
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no overlap: analyze_cost_curve focuses on deck analysis, browse_leaders and browse_sets handle specific card categories, card_versions shows printings, find_counters targets defensive strategies, and search_cards provides general card search. The descriptions clearly differentiate their unique functions.
The naming follows a consistent verb_noun pattern (e.g., analyze_cost_curve, browse_leaders, search_cards) with minor deviations: 'card_versions' uses a noun_noun structure instead of a verb, and 'find_counters' uses 'find' while others use 'analyze', 'browse', or 'search'. Overall, it's mostly predictable and readable.
With 6 tools, this server is well-scoped for its purpose of One Piece TCG analysis. Each tool serves a specific role in deck building, card browsing, and strategy, making the count appropriate without being too sparse or overwhelming for the domain.
The toolset covers key aspects of the One Piece TCG domain, including deck analysis, card browsing, version tracking, counter strategies, and detailed search. A minor gap exists in direct deck management tools (e.g., create or save decks), but agents can work around this using the provided tools for analysis and card selection.