Pokédex

You can run a dedicated MCP Server that exposes Pokémon data through PokeAPI to your AI agents. It supports detailed Pokémon information, type relationships, encounter locations, and name-based search, all accessible via a clean MCP interface with built-in validation and a TypeScript client.

How to use

Start the server locally using the provided runtime command. Once the server is running, connect your MCP client to the configured stdio transport and issue tools to fetch Pokémon data, view type effectiveness, discover encounter locations, or search by partial names. The server validates inputs at runtime, formats responses consistently, and ensures your client receives structured, typed results.

How to install

Prerequisites: you need Node.js 18+ installed and a package manager such as pnpm or npm.

1. Clone the project or create your working directory and navigate into it.

2. Install dependencies using your preferred package manager.

3. Build the TypeScript sources to JavaScript.

4. Start the MCP server so it becomes available to clients.

pnpm install
pnpm build
node dist/index.js

MCP connection and configuration

The server provides an MCP configuration snippet that you can use to connect a client via stdio. The configuration starts the server with the appropriate command and points to the compiled entry file.

{
  "mcpServers": {
    "pokedex": {
      "type": "stdio",
      "name": "pokedex",
      "command": "node",
      "args": ["/path/to/pokedex/dist/index.js"],
      "env": {}
    }
  }
}

Notes on runtime and tools

All available tools are exposed by the server for you to request from your MCP client. You can fetch detailed Pokémon data, gather type effectiveness charts, query encounter locations, or perform partial-name searches. Runtime input validation is performed with Zod to ensure you receive predictable responses.

Troubleshooting and tips

If you encounter connection issues, verify the stdio transport is correctly wired to your MCP client. Ensure the server process has access to the compiled entry point at the specified path and that Node.js is available on your system. Check that your client uses the same MCP protocol version and supports tools with change tracking.

Available tools

fetch_pokemon

Fetch detailed information about a Pokémon by name or ID, including types, stats, abilities, sprites, and artwork.

get_type_effectiveness

Return type effectiveness data including strengths, weaknesses, and resistances for a given type.

get_pokemon_encounters

Provide encounter locations, levels, and capture methods for a specified Pokémon.

search_pokemon

Search for Pokémon by partial name match and return matching results.