Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/chiragagg5k/poke-mcp

pokemon MCP server using PokeAPI

https://github.com/chiragagg5k/poke-mcp

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.8%) to scientific vocabulary

Keywords

mcp-server pokemon
Last synced: 9 months ago · JSON representation

Repository

pokemon MCP server using PokeAPI

Basic Info
  • Host: GitHub
  • Owner: ChiragAgg5k
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 830 KB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 1
  • Releases: 0
Topics
mcp-server pokemon
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme

README.md

PokeMCP

PokeMCP is an MCP (Modular Command Platform) server that provides detailed Pokémon information by integrating with the PokeAPI. It exposes a tool to fetch comprehensive data about any Pokémon, including base stats, types, abilities (with effects), moves (with effects), and evolution chain.

Features

  • Fetches Pokémon base stats, types, and abilities (with effect descriptions)
  • Retrieves up to 10 moves per Pokémon, including move effects
  • Provides the full evolution chain for a given Pokémon
  • Handles errors gracefully and returns informative error messages

Requirements

Installation

  1. Clone this repository: bash git clone https://github.com/ChiragAgg5k/poke-mcp.git cd poke-mcp
  2. Install dependencies using uv: bash uv sync

Usage

Development Server

Run the server using uv (ensure you have the required MCP infrastructure): bash uv run mcp dev server.py

Connecting with Claude

Run the following command to connect with Claude: bash uv run mcp install server.py

Result should look like this: bash Added server 'poke-mcp' to Claude config Successfully installed poke-mcp in Claude app

Now you can use the poke-mcp MCP tools in Claude:

Get Pokemon Info

Claude with PokeMCP

Simulate Battle

Claude with PokeMCP

Learn how to connect the server with other MCP clients like Cursor here.

API

Tool: get_pokemon_info

Fetches detailed information about a Pokémon.

Arguments

  • pokemon_name (str): The name of the Pokémon (case-insensitive)

Returns

A dictionary with the following structure: json { "name": "pikachu", "id": 25, "base_stats": { "hp": 35, "attack": 55, ... }, "types": ["electric"], "abilities": [ {"name": "static", "effect": "May paralyze on contact."}, ... ], "moves": [ {"name": "thunder-shock", "effect": "Has a 10% chance to paralyze the target."}, ... ], "evolution_chain": ["pichu", "pikachu", "raichu"] }

Error Handling

If the Pokémon is not found or there is a network error, the response will include an error key with a descriptive message.

Tool: simulate_battle

Simulates a Pokémon battle between two Pokémon using core mechanics (stats, type, and status effects).

Arguments

  • pokemon1 (str): Name of the first Pokémon (case-insensitive)
  • pokemon2 (str): Name of the second Pokémon (case-insensitive)

Returns

A dictionary with the following structure: json { "pokemon1": "pikachu", "pokemon2": "charizard", "initial_hp": { "pikachu": 35, "charizard": 78 }, "battle_log": [ "Turn 1:", "charizard uses mega-punch and deals 75 damage! (pikachu HP: 0)", "pikachu fainted!", "Winner: charizard!" ], "winner": "charizard" }

Error Handling

If either Pokémon is not found or there is a network error, the response will include an error key with a descriptive message.

License

This project uses the PokeAPI and is intended for educational and non-commercial use.

Owner

  • Name: Chirag Aggarwal
  • Login: ChiragAgg5k
  • Kind: user
  • Location: Noida , Uttar Pradesh , India
  • Company: Bennett University

CSE Undergrad | Student at Bennett University

GitHub Events

Total
  • Watch event: 2
  • Push event: 7
  • Pull request review event: 2
  • Pull request review comment event: 3
  • Pull request event: 1
  • Create event: 3
Last Year
  • Watch event: 2
  • Push event: 7
  • Pull request review event: 2
  • Pull request review comment event: 3
  • Pull request event: 1
  • Create event: 3

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 9
  • Total Committers: 1
  • Avg Commits per committer: 9.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 9
  • Committers: 1
  • Avg Commits per committer: 9.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
ChiragAgg5k c****k@g****m 9

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
Pull Request Authors
  • ChiragAgg5k (2)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

pyproject.toml pypi
  • httpx >=0.28.1
  • mcp [cli]>=1.4.1
uv.lock pypi
  • annotated-types 0.7.0
  • anyio 4.9.0
  • certifi 2025.4.26
  • click 8.1.8
  • colorama 0.4.6
  • h11 0.16.0
  • httpcore 1.0.9
  • httpx 0.28.1
  • httpx-sse 0.4.0
  • idna 3.10
  • markdown-it-py 3.0.0
  • mcp 1.9.0
  • mdurl 0.1.2
  • poke-mcp 0.1.0
  • pydantic 2.11.4
  • pydantic-core 2.33.2
  • pydantic-settings 2.9.1
  • pygments 2.19.1
  • python-dotenv 1.1.0
  • python-multipart 0.0.20
  • rich 14.0.0
  • shellingham 1.5.4
  • sniffio 1.3.1
  • sse-starlette 2.3.5
  • starlette 0.46.2
  • typer 0.15.4
  • typing-extensions 4.13.2
  • typing-inspection 0.4.0
  • uvicorn 0.34.2