Skip to main content
Glama
jmohanty2

Pokémon MCP Server for ChatGPT

by jmohanty2
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Pokémon MCP Server for ChatGPT

This project reproduces the MCP server from 2MinutesPy's “Building an MCP server in 2 minutes” video. It exposes the same three tools:

  • get_pokemon_info(name) — fetch live Pokémon types, abilities, and stats

  • create_tournament_squad() — build the video's six-Pokémon squad

  • list_popular_pokemon() — list the video's popular tournament picks

The only important change is the connection method. The video uses local stdio; ChatGPT needs a remotely reachable MCP endpoint. This project therefore defaults to Streamable HTTP at /mcp.

No OpenAI API key or PokéAPI key is required.

What is happening, in plain English?

  1. You ask ChatGPT a Pokémon question.

  2. ChatGPT chooses one of this server's three tools.

  3. The server calls the public PokéAPI when live data is needed.

  4. The server sends the Pokémon information back to ChatGPT.

Related MCP server: Pokémon MCP Server

Run it locally

You need Python 3.11 or newer.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
python server.py

The MCP URL is:

http://localhost:8000/mcp

ChatGPT cannot call that localhost URL directly. Local running is for testing; use the deployment section to give ChatGPT a public HTTPS URL.

Run the automated tests:

pytest

Run the live PokéAPI smoke test:

PYTHONPATH=. python scripts/smoke_test.py

Deploy it for ChatGPT

The included Dockerfile works on Render, Railway, Fly.io, Google Cloud Run, Azure Container Apps, or another Docker host. The easiest beginner route is:

  1. Create a GitHub repository and upload this project's files.

  2. In Render, choose New → Blueprint and select that repository.

  3. Deploy the render.yaml blueprint.

  4. Copy the public Render URL and add /mcp to the end.

Example:

https://pokemon-chatgpt-mcp-xxxx.onrender.com/mcp

Free hosts may sleep when unused, so the first tool call can take longer.

Connect it to ChatGPT

After deployment:

  1. Open ChatGPT → Settings → Security and login.

  2. Turn on Developer mode.

  3. Open ChatGPT Plugins and select the plus button.

  4. Create a connection named Pokemon MCP.

  5. Enter your complete public URL, including /mcp.

  6. Review the three discovered tools and save the connection.

  7. In a new chat, enable Pokemon MCP from the tools menu.

If Developer mode or Plugins is not shown, custom MCP connections may not be enabled for your current account or workspace yet.

Prompts to test in ChatGPT

Use Pokemon MCP to tell me Pikachu's type, abilities, and stats.
Use Pokemon MCP to list the popular tournament Pokémon.
Use Pokemon MCP to build me the tournament squad.

Optional: run like the original video

To use the original local stdio transport with an MCP-compatible desktop client:

MCP_TRANSPORT=stdio python server.py

Security note

This server contains only read-only Pokémon tools and no private data. Because it has no authentication, anyone who knows the deployed URL can call it. Add authentication before reusing this pattern for private files, accounts, or write actions.

Sources

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • Pokédex MCP Server

    hollanddd
    A
    license
    B
    quality
    C
    maintenance
    Enables AI agents to access comprehensive Pokémon data through PokeAPI, including detailed Pokémon information, type effectiveness charts, encounter locations, and search capabilities. Provides a complete toolkit for retrieving stats, abilities, sprites, battle mechanics, and wild encounter data for all Pokémon.
    4
    271 npm
    1
    MIT

  • Pokémon MCP Server

    EscasanN
    F
    license
    C
    quality
    D
    maintenance
    Enables interaction with live Pokémon data through PokeAPI, providing comprehensive Pokémon information, battle calculations, moveset validation, and team analysis. Supports searching Pokémon and moves, calculating stats, checking type effectiveness, and analyzing team synergies with in-memory caching for improved performance.
    9
    -

  • PokeAPI MCP Server

    Asthanaji05
    A
    license
    B
    quality
    D
    maintenance
    Empowers AI assistants to fetch and explore comprehensive Pokémon data from PokeAPI via 47 tools covering Pokémon, moves, items, game mechanics, and more.
    47
    81 npm
    1
    ISC