Meta Agent Tools
PT

Back to the catalog

io.github.Asthanaji05/pokeapi-mcp-server

Empower your AI with Pokédex powers! Fetch and explore Pokémon data seamlessly via PokeAPI.

Open source Open in the app JSON README (API)

About

Empower your AI with Pokédex powers! Fetch and explore Pokémon data seamlessly via PokeAPI.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
asthanaji05
Origin
official
Category
ferramentas
Transport
local
Version
1.12.0
Stars
1
Last push
2025-11-02T07:20:53Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:01:42
Updated
2026-08-29 03:01:42
Origin id
io.github.Asthanaji05/pokeapi-mcp-server

README

# PokeAPI MCP Server

[![npm version](https://img.shields.io/npm/v/pokeapi-mcp-server.svg)](https://www.npmjs.com/package/pokeapi-mcp-server)
[![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://registry.modelcontextprotocol.io)
[![License: ISC](https://img.shields.io/badge/License-ISC-yellow.svg)](https://opensource.org/licenses/ISC)

Empower your AI with Pokédex powers! Fetch and explore Pokémon data seamlessly via PokeAPI.

**Server:** `io.github.Asthanaji05/pokeapi-mcp-server`  
**npm package:** `pokeapi-mcp-server`

This project provides a Model Context Protocol (MCP) Server that enables Large Language Models (LLMs) to make tool calls for Pokémon-related data. It integrates with the [PokeAPI](https://pokeapi.co/) to offer access to 47 different Pokémon-related endpoints.

## Project Overview

The PokeAPI MCP Server acts as a bridge, allowing AI assistants to fetch and utilize comprehensive Pokémon data directly from the PokeAPI. This facilitates the development of intelligent applications that require accurate and up-to-date information about Pokémon, moves, items, game mechanics, and more.

## Available Tools

The server provides 47 Pokémon-related tools, covering a wide range of data:

* **Pokémon Data**: `getPokemonByName`, `getPokemonSpeciesByName`, `getPokemonFormByName`, `getPokemonColorByName`, `getPokemonHabitatByName`, `getPokemonShapeByName`.
* **Moves**: `getMoveByName`, `getMoveCategoryByName`, `getMoveDamageClassByName`, `getMoveAilmentByName`, `getMoveBattleStyleByName`, `getMoveLearnMethodByName`, `getMoveTargetByName`.
* **Items**: `getItemByName`, `getItemCategoryByName`, `getItemAttributeByName`, `getItemFlingEffectByName`, `getItemPocketByName`.
* **Game Mechanics**: `getTypeByName`, `getStatByName`, `getAbilityByName`, `getGrowthRateByName`, `getNatureByName`, `getEggGroupByName`, `getGenerationByName`, `getVersionByName`, `getVersionGroupByName`, `getPokedexByName`, `getLanguageByName`.
* **Encounters**: `getLocationByName`, `getLocationAreaByName`, `getEncounterMethodByName`, `getEncounterConditionByName`, `getEncounterConditionValueByName`.
* **Berries**: `getBerryByName`, `getBerryFirmnessByName`, `getBerryFlavorByName`.
* **Contests**: `getContestTypeByName`, `getContestEffectById`, `getSuperContestEffectById`.
* **Evolution**: `getEvolutionChainById`, `getEvolutionTriggerByName`.
* **Other**: `getCharacteristicById`, `getMachineById`, `getPalParkAreaByName`, `getPokeathlonStatByName`, `getRegionByName`.

## 🚀 Installation

### Global Installation

```bash
npm install -g pokeapi-mcp-server
```

## ⚙️ Configuration

After installation, add the server to your MCP client configuration:

### For Claude Desktop

Add to `Claude>claude_desktop_config.json`

```json
{
  "mcpServers": {
    "pokemon-mcp-server": {
      "command": "npx",
      "args": [
        "pokeapi-mcp-server@1.4.0"
      ]
    }
  }
}
```

![image](https://github.com/user-attachments/assets/b352f1ee-62b3-44c7-9443-72a20094907e)

### For Cursor IDE

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "pokemon-mcp-server": {
      "command": "npx",
      "args": [
        "pokeapi-mcp-server@1.4.0"
      ]
    }
  }
}

```

Or if installed globally:

```json
{
  "mcpServers": {
    "pokemon-mcp-server": {
      "command": "npx",
      "args": [
        "pokeapi-mcp-server@1.4.0"
      ]
    }
  }
}

```

![image](https://github.com/user-attachments/assets/297f41f5-21f5-404f-9336-57f53f9b3e74)

### For Gemini CLI

Add to `.gemini/settings.json`:

```json
{
  "mcpServers": {
    "pokemon-mcp-server": {
      "command": "npx",
      "args": [
        "--yes",
        "pokeapi-mcp-server@1.4.0"
      ],
      "transport": "stdio",
      "trust": true,
      "env": {
        "MCP_HTTP_SERVER_URL": "https://pokemon-mcp-server-vs8m.onrender.com"
      }
    }
  }
}
```

![image](https://github.com/user-attachments/assets/8a270afe-562d-4a68-9d96-699b845c66c2)

![image](https://github.com/user-attachments/assets/2bd61cab-82f2-4500-ac86-dba53a50b93f)

![image](https://github.com/user-attachments/assets/a7dd6fc2-f335-4ea5-95c7-77b29d165fd2)

> **Note:** The `env` section ensures the MCP server connects to the correct HTTP server. The remote server at `https://pokemon-mcp-server-vs8m.onrender.com` is available by default. If you're running a local HTTP server on port 3000, change the URL to `http://localhost:3000`. Restart Cursor IDE or Gemini CLI after updating the configuration to load the MCP server.

## 🔗 Links

* [npm Package](https://www.npmjs.com/package/pokeapi-mcp-server)
* [MCP Registry](https://registry.modelcontextprotocol.io)
* [GitHub Repository](https://github.com/Asthanaji05/MCP_Pokemon)
* [PokeAPI Documentation](https://pokeapi.co/docs/v2)

---

Made with ❤️ by [Asthanaji05](https://github.com/Asthanaji05)

More