Skip to main content
Glama
AI Pokemon Arena MCP

AI Pokemon Arena MCP

by tannnuu

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 configuration

Setup

Prerequisites

  • Node.js 18+

  • Gemini API key

Installation

  1. Install dependencies:

npm install
  1. Set up environment: Create a .env file with your Gemini API key:

GEMINI_API_KEY=your_gemini_api_key_here
  1. Build the project:

npm run build

Usage

Web Application

Start the web server:

npm run web

Open 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 start

Connect 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 information

  • battle_simulation: Simulate battles between two Pokemon

  • get_pokemon_list: Browse Pokemon with pagination

API Endpoints

The web server provides REST API endpoints:

  • GET /api/pokemon/:name - Get Pokemon data

  • POST /api/battle - Simulate a battle

  • GET /api/pokemon - List Pokemon

Development

Development mode (with hot reload):

npm run dev

Test the MCP server:

npm run test

Technologies Used

  • Frontend: HTML5, CSS3, JavaScript

  • Backend: Node.js, Express.js

  • AI: Google Gemini API

  • Data: PokeAPI

  • Protocol: Model Context Protocol (MCP)

  • Language: TypeScript

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Test thoroughly

  5. Submit a pull request

License

MIT License

Available Tools

5 tools
analyze_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

    B3.4/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      1
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables querying Pokemon information from PokeAPI, including Pokemon details, types, moves, abilities, evolution chains, and search functionality, through natural language.
      8
      MIT