YuGiOh Card API MCP Server

What is YuGiOh Card API MCP Server?

This server implements an MCP (Model Context Protocol) wrapper for the YuGiOh Card Database (YGOPRODeck) API. It allows AI agents to search YuGiOh cards using various filter criteria. It is intended for developers integrating YuGiOh card data into MCP-compatible applications.

How to use YuGiOh Card API MCP Server?

Clone the repository, build with mvn clean package, and configure your MCP client to use the server. The server exposes a tool called yugioh-api that accepts parameters such as name, id, type, atk, def, level, race, attribute, archetype, sort, format, banlist, and language. Example: {"name": "Dark Magician"}.

Key features of YuGiOh Card API MCP Server

• Exposes YuGiOh card search via MCP tool yugioh-api
• Supports multiple filter criteria (name, type, attribute, etc.)
• Uses the public YGOPRODeck API as data source
• Written in Java 21 with Maven build
• Provides JSON schema validation for parameters

Use cases of YuGiOh Card API MCP Server

• Searching for a specific card by exact name or ID
• Finding all monsters of a given archetype (e.g., Blue-Eyes)
• Filtering cards by type, attribute, and race simultaneously
• Retrieving cards sorted by ATK or other fields

FAQ from YuGiOh Card API MCP Server

What are the runtime requirements?

Java 21 or higher and Maven 3.6 or higher are required.

What tool does the server expose?

The server exposes a single tool called yugioh-api that accepts a JSON object with optional filter fields.

Where does the card data come from?

All card data is fetched from the public YGOPRODeck API.

How do I install the server?

Clone the repository and run mvn clean package to build the executable JAR.

Does the server use authentication or a specific transport?

The README does not mention any authentication or transport details beyond implementing the MCP standard (likely stdio-based).