Pokémon AI Demo

Name: Pokémon AI Demo
Author: GomesAdhikari

@GomesAdhikari

Repository

About Pokémon AI Demo

MCP server for agentic AI to withdraw information

#mathgpt #math-solver #math-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Pokeapi-MCP": {
      "command": "python",
      "args": [
        "manage.py",
        "migrate"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Pokémon AI Demo?

Pokémon AI Demo is a full-stack application for exploring Pokémon data, comparing Pokémon, suggesting counters, and generating teams using AI. It features a Django REST API backend with a React/Material-UI frontend.

How to use Pokémon AI Demo?

The system is deployed locally by setting up the Django backend (cd mcp_server, install dependencies, run migrations, start server with python manage.py runserver) and the React frontend (cd mcp_frontend, install packages via npm, start with npm start). Environment variables POKE_API_URL and GOOGLE_API_KEY are required in a .env file inside the mcpserver folder. Users interact through the web UI (four card-based sections) or by sending JSON POST requests directly to the API endpoints (/api/agent/pokemon-info/, /api/agent/compare/, /api/agent/strategy/, /api/agent/team/).

Key features of Pokémon AI Demo

Pokémon info lookup with stats, abilities, moves, and evolution
Side-by-side comparison of two Pokémon
Counter suggestions based on weaknesses
AI-generated team builder from a natural language description
Web UI with four interactive cards for each function
JSON API endpoints for external agent integration

Use cases of Pokémon AI Demo

Look up detailed data for any Pokémon by name
Compare two Pokémon’s stats and type advantages
Find counters for a specific Pokémon
Generate a custom Pokémon team using a text description

FAQ from Pokémon AI Demo

What are the prerequisites to run the server?

Python 3.8+, Node.js 16+, npm, and pip are required. The backend uses Django and the frontend uses React and MUI.

What environment variables are needed?

Create a .env file inside the mcpserver folder with POKE_API_URL = "https://pokeapi.co/api/v2/" and your GOOGLE_API_KEY.

What APIs does the server use?

It uses the public PokéAPI for Pokémon data and a Google AI API (via the provided key) for team generation.

Is this project affiliated with Nintendo or The Pokémon Company?

No, this project is for educational and demo purposes only and is not affiliated with Nintendo, Game Freak, or The Pokémon Company.

How can external agents interact with the server?

Agents can send JSON POST requests to any of the four endpoints listed in the API documentation; for example, requests.post('http://127.0.0.1:8000/api/agent/pokemon-info/', json={"name": "pikachu"}).