AI Pokemon Arena MCP
Powers AI-driven Pokemon battle simulation, using Gemini to analyze Pokemon stats and matchups and generate intelligent, realistic battle narratives and outcomes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AI Pokemon Arena MCP simulate a battle between Pikachu and Charizard"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI Pokemon Arena MCP
A web-based Pokemon battle simulation application powered by AI, featuring both a user-friendly web interface and MCP (Model Context Protocol) server integration for advanced interactions.
Live Demo:
https://ai-pokemon-arena-mcp-server.vercel.app/
Features
Interactive Web Interface: Select Pokemon and simulate battles through a clean, responsive web UI
AI-Powered Battle Simulation: Uses Gemini AI for intelligent battle analysis and realistic outcomes
Comprehensive Pokemon Database: Access detailed Pokemon information via PokeAPI integration
MCP Server Support: Connect to Claude Desktop for advanced Pokemon queries and battle simulations
Real-time API: RESTful endpoints for Pokemon data and battle results
Related MCP server: Pokémon MCP Server
Project Structure
src/ # Source TypeScript files
├── index.ts # MCP server entry point
├── services/
│ ├── pokeapi.ts # PokeAPI integration
│ └── gemini.ts # Gemini AI service
├── tools/
│ └── pokemon-tools.ts # MCP tool implementations
├── types/
│ └── pokemon.ts # TypeScript definitions
└── utils/
└── helpers.ts # Utility functions
build/ # Compiled JavaScript files
simple-battle.html # Main web interface
server.js # Express web server
styles.css # CSS styles for the web app
script.js # Frontend JavaScript
package.json # Dependencies and scripts
tsconfig.json # TypeScript configurationSetup
Prerequisites
Node.js 18+
Gemini API key
Installation
Install dependencies:
npm installSet up environment: Create a
.envfile with your Gemini API key:
GEMINI_API_KEY=your_gemini_api_key_hereBuild the project:
npm run buildUsage
Web Application
Start the web server:
npm run webOpen http://localhost:3001/simple-battle.html in your browser to access the battle arena.
You can also access the live demo at:
https://ai-pokemon-arena-mcp-server.vercel.app/
Features:
Search and select Pokemon for battle
View detailed Pokemon stats and information
Simulate battles with AI-generated narratives
MCP Server
Run the MCP server:
npm startConnect to Claude Desktop:
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ai-pokemon-arena-mcp": {
"command": "node",
"args": ["C:/path/to/your/project/build/index.js"]
}
}
}Available MCP Tools:
get_pokemon_data: Get detailed Pokemon informationbattle_simulation: Simulate battles between two Pokemonget_pokemon_list: Browse Pokemon with pagination
API Endpoints
The web server provides REST API endpoints:
GET /api/pokemon/:name- Get Pokemon dataPOST /api/battle- Simulate a battleGET /api/pokemon- List Pokemon
Development
Development mode (with hot reload):
npm run devTest the MCP server:
npm run testTechnologies Used
Frontend: HTML5, CSS3, JavaScript
Backend: Node.js, Express.js
AI: Google Gemini API
Data: PokeAPI
Protocol: Model Context Protocol (MCP)
Language: TypeScript
Contributing
Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request
License
MIT License
Available Tools
5 toolsanalyze_pokemonC
Get AI-powered analysis of a Pokemon's battle capabilities and characteristics
Inputs: name (required).
battle_simulationB
Simulate a battle between two Pokemon using AI analysis of their stats, types, and abilities
Inputs: pokemon1 (required), pokemon2 (required).
get_pokemon_dataB
Get comprehensive data about a specific Pokemon including stats, types, abilities, and description
Inputs: name (required).
get_pokemon_listC
Get a list of Pokemon with optional pagination
Inputs: limit, offset.
search_pokemonB
Search for Pokemon by name with partial matching
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
get_pokemon_data and analyze_pokemon could be confused since both provide Pokemon information, but one is raw data and the other is AI analysis. search_pokemon is clearly for finding Pokemon by name, distinct from get_pokemon_list which lists all. Minor overlap exists but descriptions help differentiate.
All tool names follow a consistent snake_case verb_noun pattern: get_pokemon_data, battle_simulation, get_pokemon_list, search_pokemon, analyze_pokemon. Verb choice is clear and predictable.
5 tools is well-scoped for a Pokemon battle and data server. Each tool serves a distinct purpose without redundancy, and the count is appropriate for the domain.
Core operations for retrieving Pokemon data, searching, listing, simulating battles, and analyzing are covered. However, there is no tool to get detailed move information or type effectiveness charts, which could be useful for battle simulation completeness. Minor gaps that agents can work around.
Maintenance
Related MCP Connectors
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Teamfight Tactics data & AI coaching for Claude and ChatGPT — 19 tools, built-in Riot key.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables users to access comprehensive Pokemon data through the PokeAPI, including Pokemon stats, types, descriptions, move details, and complete evolution chains. Allows Claude to answer Pokemon-related questions with detailed information about any Pokemon, their abilities, and evolutionary relationships.1ISC
- FlicenseNot gradedqualityDmaintenanceEnables AI models to access comprehensive Pokémon data from PokéAPI and simulate battles between any two Pokémon with realistic mechanics including type effectiveness, stat-based damage calculations, and status effects.1-
- AlicenseAqualityDmaintenanceEnables querying Pokemon information from PokeAPI, including Pokemon details, types, moves, abilities, evolution chains, and search functionality, through natural language.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude AI to query competitive Pokémon meta stats, retrieve and save teams, and enforce custom move/item rules for team building.MIT