Limitless TCG MCP Server
About
The Limitless TCG MCP Server lets LLMs integrate with the Limitless TCG API to retrieve tournament data, team and decklist information. It is designed for users who want to query Limitless TCG data through an MCP-compatible assistant such as Claude.
Details
- Author
- jpbullalayao
- Downloads
- 510
- Categories
- Other
Jump to
- Access tournaments, details, standings, and pairings
- Supports filtering by game, format, organizer, and pagination
- Uses MCP resources with a limitless:// URI scheme
- Authentication via X-Access-Key HTTP header
- Connects to https://play.limitlesstcg.com/api
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Limitless TCG MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server with npx limitlesstcg-mcp api-key=<YOUR_API_KEY> or set the LIMITLESS_API_KEY environment variable. For Claude Desktop, add the server to your claude_desktop_config.json using the npx command and the environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"limitless tcg mcp server": {
"limitlesstcg": {
"command": "npx",
"args": [
"limitlesstcg-mcp"
],
"env": {
"LIMITLESS_API_KEY": "<LIMITLESS_API_KEY_HERE>"
}
}
}
}
}McpServers
{
"limitlesstcg": {
"command": "npx",
"args": [
"limitlesstcg-mcp"
],
"env": {
"LIMITLESS_API_KEY": "<LIMITLESS_API_KEY_HERE>"
}
}
}Limitless TCG MCP Server
The Limitless TCG Model Context Protocol (MCP) server allows you to use LLMs to integrate with the Limitless TCG API to access tournament and team/decklist data.
Setup
To run the Limitless TCG MCP server using npx, use the following command:
$ npx limitlesstcg-mcp api-key=<LIMITLESS_API_KEY_HERE>
You can also set LIMITLESS_API_KEY as an env var without passing api-key as a command line argument.
Usage with Claude Desktop
Add the following to your claude_desktop_config.json. See here for more details.
{
"mcpServers": {
"limitlesstcg": {
"command": "npx",
"args": ["limitlesstcg-mcp"],
"env": {
"LIMITLESS_API_KEY": "<LIMITLESS_API_KEY_HERE>"
}
}
}
}
Getting a Limitless TCG API Key
To use this MCP server, you'll need a Limitless TCG API key:
1. Go to your user API settings in the Limitless TCG platform
2. Fill out the form linked at the top of the page
3. Once approved, you can find your key on that same page
Authentication
The server supports authentication via HTTP Headers, as provided by the Limitless TCG API:
{
'X-Access-Key': <LIMITLESS_API_KEY_HERE>
}
API Connection
The server connects to the Limitless TCG API at https://play.limitlesstcg.com/api and handles the following endpoints:
- /tournaments - List of all tournaments
- /tournaments/{id}/details - Details for a specific tournament
- /tournaments/{id}/standings - Standings for a specific tournament
- /tournaments/{id}/pairings - Match pairings for a specific tournament
MCP Resources
The server exposes the corresponding MCP resources to LLMs:
- limitless://tournaments{?game,format,organizerId,limit,page} - List of tournaments
- game: Game ID, e.g. PTCG, VGC
- format: Format ID
- organizerId: Organization ID for a specific organizer's tournaments
- limit: Number of tournaments to be returned (default: 50)
- page: Used for pagination
- limitless://tournament/{id}/details - Details for a specific tournament
- limitless://tournament/{id}/standings - Standings for a specific tournament
- limitless://tournament/{id}/pairings - Match pairings for a specific tournament
Using with LLMs
When connected to an MCP-compatible LLM (like Claude), you can ask about tournaments and teams with specific queries such as:
- "Show me the latest Pokémon VGC tournaments"
- "Get the standings for the latest Nino FF"
- "what were the most popular restricted duos in the Smogon Challenge?"
The MCP server handles the API authentication and data formatting for seamless integration with the LLM.
Author's Note
Interested in the progress of this project? Feel free to follow the repo for live updates!
If you need to get a hold of me regarding this project, feel free to either:
- email me at professor.ragna@gmail.com
- tweet me @professorragna
If you're interested in helping to fund this project, you can support me here. Any and all support is greatly appreciated!
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
