Random Pokémon Finder MCP Server

Fetches information about a random Pokémon, including its name, sprite image, types, and basic stats. Built for Model Context Protocol (MCP), easily used with Claude Desktop and other MCP client tools.

Features

• Retrieves a truly random Pokémon from the official PokéAPI
• Provides:
  • Pokémon name and ID
  • Sprite image URL
  • Types (e.g., Fire, Water)
  • Basic battle stats (HP, Attack, etc.)

Installation & Usage

You can run this server instantly as an MCP server:

Option 1: Run with npx

npx @dennisk2025/random-pokemon-finder

Option 2: Install globally

npm install -g @dennisk2025/random-pokemon-finder
random-pokemon-finder

Add to Claude Desktop (claude_desktop_config.json)

Add this entry to your config file:

{
  "mcpServers": {
    "pokemon": {
      "command": "npx",
      "args": ["@dennisk2025/random-pokemon-finder"]
    }
  }
}

Add this to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Then restart Claude Desktop. "pokemon" will appear as a tool source.

Usage Examples

You can now use this MCP server from any MCP-compatible client!

List Available Tools

Request:

list_tools

Returns:

[
  {
    "name": "get_random_pokemon",
    "description": "Returns data about a randomly selected Pokémon, including its name, sprite image, types, and basic stats.",
    "inputSchema": {
      "type": "object",
      "properties": {},
      "required": []
    }
  }
]

Call: get_random_pokemon

Request:

{
  "name": "get_random_pokemon",
  "arguments": {}
}

Typical Response:

{
  "id": 25,
  "name": "pikachu",
  "sprite": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/25.png",
  "types": ["electric"],
  "stats": [
    { "name": "hp", "base": 35 },
    { "name": "attack", "base": 55 },
    { "name": "defense", "base": 40 },
    ...
  ]
}

Tools

• get_random_pokemon
  Returns data about a randomly selected Pokémon, including its name, sprite image, types, and basic stats.
  • Parameters: None

This MCP server is open and free to use. It leverages the official PokéAPI—no authentication or keys needed!