Pokémon MCP Server
# Pokémon MCP Server — Live PokeAPI (Gen 1–3 friendly)
Nelson Escalante - 22046
# Descripcion
Servidor MCP que consulta PokeAPI.
## Requisitos
- Node.js 18+
- npm
## Instalar y ejecutar
```bash
npm install
npm run build
npm start
```
Debe de salir: `[pokemon-mcp-server] Ready on stdio (PokeAPI live).`
## Herramientas disponibles
- `search_names` — búsqueda difusa/substring en Pokémon y movimientos.
- `get_pokemon` — ficha (tipos, base stats, habilidades).
- `get_learnset` — learnset con filtros `version_group` y `method` (`level|machine|tutor|egg|all`).
- `get_evolutions` — cadena/grafo de evoluciones desde species -> evolution_chain.
- `type_matchup` — multiplicador ofensivo entre tipos (usa relaciones de PokeAPI).
- `calc_stats` — cálculo final dado nivel, IV/EV y naturaleza.
- `validate_moveset` — legalidad de movimientos por `version_group`.
- `suggest_moveset` — sugerencia heurística basada en STAB/coverage (consulta tipos de los movimientos).
- `team_analysis` — sinergias/weak/resist/immune para un equipo (consulta tipos en PokeAPI y tabla de tipos).
## Notas
- Hay caché en memoria para evitar llamadas repetidas.
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose with no overlap: calc_stats calculates final stats, get_evolutions retrieves evolution chains, get_learnset fetches learnsets, get_pokemon provides Pokémon details, search_names searches for names, suggest_moveset suggests movesets, team_analysis analyzes team synergies, type_matchup calculates damage multipliers, and validate_moveset validates movesets. The descriptions are specific and unambiguous.
The naming follows a consistent verb_noun pattern throughout (e.g., get_pokemon, search_names, suggest_moveset), with all tools using snake_case. However, there is a minor deviation with 'calc_stats' using 'calc' instead of 'get' or another verb, but it still fits the pattern and is readable.
With 9 tools, the count is well-scoped for a Pokémon data and analysis server. Each tool serves a distinct function related to Pokémon stats, evolutions, movesets, team building, and type matchups, making it comprehensive without being overwhelming.
The tool set covers key aspects of Pokémon data retrieval and analysis, including stats, evolutions, learnsets, movesets, team synergies, and type matchups. Minor gaps might include tools for item or ability details, but the core workflows for Pokémon enthusiasts or competitive players are well-supported.