get-pokemonLABSCO SUMMARY
PokeAPI without the API.
The data is public and well documented; what this adds is asking for it the way a person would — by name, by type, by region, or in a sentence.
What it is
A TypeScript server over PokeAPI. Five tools cover named lookups, random picks filtered by region or type, and a natural-language query path. It speaks stdio and HTTP with Server-Sent Events.
What you get
- get-pokemon returns detailed information for a Pokémon you name
- random-pokemon returns one at random
- random-pokemon-from-region draws from Kanto, Johto, Hoenn and the rest
- random-pokemon-by-type draws from Fire, Water, Electric and the other types
- pokemon-query answers questions phrased in plain language
- Input is validated with Zod, so a malformed request fails at the edge instead of reaching PokeAPI
Requirements
Node.js. Clone the repository, run npm install and npm run build, then npm start serves it at http://127.0.0.1:3000/sse for your client to connect to. PokeAPI is public — no account or key.
Setup effort
Build from source — git clone https://github.com/NaveenBandarage/poke-mcp.git
USE CASES
01
Looking up a Pokémon's details
Name in, full entry out, so a question during a game does not become a browser tab.
02
Asking a question in plain language
pokemon-query takes the question as phrased rather than requiring the right tool and the right parameter.
03
Picking a random starter for a run
A random pick, optionally constrained to one region, which is the whole mechanic of a randomizer challenge.
04
Building around a type
Random draws filtered to a type, for team-building exercises and for teaching type matchups.
5 tools
Listed in project docs. Your client may show a different list.
random-pokemonrandom-pokemon-from-regionrandom-pokemon-by-typepokemon-queryBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/NaveenBandarage/poke-mcp.git
cd poke-mcp
npm install
npm run build
npm startMCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"pokedex": {
"url": "http://127.0.0.1:3000/sse"
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport sse pokedex http://127.0.0.1:3000/sse
