Advertise
MCP.so
Sign In

Poké Battle MCP Server

@shreyahhh

Repository

Basic information

Category

AI & Agents

Transports

stdio

Author

shreyahhh

About Poké Battle MCP Server

No overview available yet

Poké Battle MCP Server config

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

{
  "mcpServers": {
    "Pokemon-Battle-using-MCP-Server-connected-to-Claude": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Poké Battle MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Overview

What is Poké-Battle?

Poké-Battle is a Pokemon game built with FastAPI and Python, leveraging Anthropic’s Claude AI through a custom Model Context Protocol (MCP) server and client. It features real-time battles and uses AI for creative battle descriptions, attack recommendations, and generating unique personalities for caught Pokemon.

How to use Poké-Battle?

Clone the repository, create and activate a Python virtual environment, then install dependencies. Set your Anthropic API key in a .env file, run the MCP server on port 8000 (uvicorn mcp_server:app --reload --port 8000), then run the main game server on port 8080 (uvicorn server:app --reload --port 8080). Open http://localhost:8080 in your browser to play.

Key features of Poké-Battle

  • Catch random Pokemon to build your team.
  • Turn-based battles against a random opponent Pokemon.
  • AI‑generated battle descriptions via Claude.
  • AI‑suggested attack moves during battle.
  • Each caught Pokemon gets a unique, AI‑generated personality.
  • Real‑time game state and message updates via WebSocket.
  • Demonstrates a Model Context Protocol for AI model interaction.

Use cases of Poké-Battle

  • Play a Pokemon battle game with AI‑driven narratives.
  • Learn how to integrate Anthropic’s Claude into a web game using MCP.
  • Experiment with real‑time WebSocket updates in a FastAPI application.
  • Showcase creative AI text generation for game commentary.

Frequently asked questions

1

What dependencies does Poké-Battle require?

The project requires Python, FastAPI, Uvicorn, Anthropic’s Claude API (via API key), PokeAPI, and libraries such as python-dotenv, httpx, websockets, and Jinja2.

2

How do I set up the Anthropic API key?

Create a `.env` file in the root directory and add `ANTHROPIC_API_KEY=your_api_key_here`. For production, it’s recommended to use environment variables from your hosting environment instead of a `.env` file.

3

Do I need to run two servers?

Yes. The MCP server runs on port 8000 (the AI backend), and the main game server runs on port 8080 (handles game logic and serves the frontend). Both must be running simultaneously.

4

How does Poké-Battle use the MCP?

The MCP server (`mcp_server.py`) handles communication with the Anthropic API. The main server (`server.py`) uses an MCP client (`mcp_client.py`) to send requests to the MCP server, enabling AI features like battle descriptions, attack suggestions, and Pokemon personalities.

5

What transport does Poké-Battle use?

Game state and messages are updated in real time via WebSocket. The MCP communication between servers uses HTTP (FastAPI endpoints).

Comments

More AI & Agents MCP servers

OpenZiti / LLM-Gateway

openziti

NetFoundry LLM Gateway is an OpenAI-compatible API proxy that routes requests across multiple LLM providers using zero-trust networking. Zero trust LLM gateway. OpenAI-compatible proxy with semantic routing and load bala

93

PDI Bridge for Claude

jxrlabs

Connect Claude Desktop to your ServiceNow PDI. Query records, inspect Business Rules, review ACLs, and troubleshoot against your live instance.

Ranla

Kurtis Tryber

AI growth agent for software businesses. Ranla ships pages that rank on Google, gets your product named in AI answers, replies on Reddit and sends lifecycle email. Ask how growth is going, have Ranla draft the work and a

AON — Agent Offer Network

AON

AON MCP connects AI agents to real, buyable products and services with live pricing and tracked links—enabling builders to earn developer revenue share from attributed clicks and conversions.

2

Poker Bots All Stars

Agent Disco

Live Texas Hold'em for AI agents: your assistant plays your 3D star, talks trash, anyone can watch.

Advertise