🏆 Pokémon Champion - Team Builder & AI MCP Server

A modern competitive Pokémon Team Builder application featuring full EV/IV customization, custom Developer rules, real-time battle statistics powered by the Champions Battle Data API, and an official Model Context Protocol (MCP) Remote Server to connect your team data directly with Claude AI.

✨ Features

• 🎮 Competitive Team Builder:

  • Build & manage teams of up to 6 Pokémon with interactive slot assignment.

  • Custom EV controls with step buttons (-1, +1) and intelligent MAX budget calculation (max 32 EV per stat, 66 EV total budget limit).

  • Showdown Paste export and import format support.

  • Save Pokémon directly to a personal BOX.

• 🛠️ Developer Control Panel:

  • Define custom allowed move pools per Pokémon (e.g. Mega Malamar, Mega Raichu Y).

  • Restrict held items with strict non-duplication enforcement per team.

• 📊 Champions Battle Data API Integration:

  • View real-time competitive Meta Usage Rankings sorted from #1 to #40 for both Doubles and Singles formats.

  • Inspect top used moves, held items, natures, EV spreads, and best synergy teammates per Pokémon.

• 🤖 Model Context Protocol (MCP) Remote Server:

  • Built using Anthropic's official @modelcontextprotocol/server (v2 spec mcp-client-2025-11-20).

  • Exposes 7 tools for Claude to read teams, query meta stats, enforce dev rules, and automatically save AI-generated teams.

Related MCP server: Pokémon MCP Server

⚡ Quick Start

1. Install Dependencies

# Main application
npm install

# MCP Server
cd mcp-server
npm install
cd ..

2. Run Main Web App

npm start

The Web App will run at http://localhost:3030.

3. Run MCP Server (for Claude AI)

cd mcp-server
node mcp-server.js

The MCP Server will run at http://localhost:3031/mcp.

🤖 Remote MCP Tools for Claude

🔒 Connecting to your Claude Account

1. Start your local MCP Server (node mcp-server/mcp-server.js).

2. Expose the port over HTTPS using Cloudflare Tunnels:

   cloudflared tunnel --url http://localhost:3031

3. Open your account on Claude.ai or Claude Desktop.

4. Go to Customize -> Connectors -> Add Custom Connector.

5. Paste your HTTPS URL (e.g. https://your-tunnel.trycloudflare.com/mcp).

6. Enable the connector in your chat conversation and start asking Claude to build & optimize your teams!

🤝 Attributions & Credits

• Pokémon data provided by PokéAPI.

• Battle data provided by Pokémon Champions Battle Data.

⚖️ Legal Disclaimer

This fan-made project is not affiliated with, endorsed by, or sponsored by Pokémon, Nintendo, GAME FREAK, Creatures Inc., or The Pokémon Company.

📄 License

Distributed under the MIT License.