GhostTypes/pokemon-go-mcp

Prerequisites

• Python 3.10 or higher
• uv package manager (recommended) or pip

Claude Desktop Configuration

{
  "mcpServers": {
    "pokemon-go": {
      "command": "uv",
      "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]
    }
  }
}

Claude Code Configuration

# Quick add with claude mcp command
claude mcp add pokemon-go uv run python /path/to/pokemon-go-mcp/pogo_mcp/server.py

# Or manually create .mcp.json in your project directory
echo '{"servers": {"pokemon-go": {"command": "uv", "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]}}}' > .mcp.json

VS Code Configuration

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "pokemon-go-stdio": {
      "command": "uv",
      "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]
    },
    "pokemon-go-http": {
      "type": "http",
      "url": "http://localhost:8000",
      "description": "Pokemon Go MCP Server via HTTP"
    }
  }
}

n8n Workflows

1. Install n8n MCP Node:

   npm install n8n-nodes-mcp
   # Set environment: N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
   

2. Configure MCP Client Node:

   • Connection Type: HTTP Streamable (Recommended)
   • URL: http://localhost:8000 (when running with MCP_TRANSPORT=http)
   • Headers: Optional authentication headers if needed

3. Docker Deployment for n8n:

   # Build and run the Pokemon Go MCP server
   docker build -t pokemon-go-mcp .
   docker run -d -p 8000:8000 -e MCP_TRANSPORT=http pokemon-go-mcp
   

Transport Modes

Get Today's Priorities

Use the get_daily_priorities tool to get curated recommendations for:

• Active events to participate in
• Priority raids for shiny hunting
• Easy research tasks with valuable rewards
• Optimal egg hatching strategy

Find a Specific Pokemon

Use search_pokemon_everywhere with "Dratini" to find:

• If it's featured in any current events
• Whether it's available as a raid boss
• Which research tasks reward it
• If it can be hatched from eggs
• Shiny availability across all sources

Plan Your Shiny Hunt

Use get_all_shiny_pokemon to see every shiny currently available, then:

• get_shiny_raids for raid targets
• get_shiny_research_rewards for research tasks
• get_shiny_egg_hatches for egg planning
• get_route_gift_pokemon for special route gift opportunities
• get_shiny_shadow_pokemon for Shadow Pokemon

pokemon-go-mcp/
├── pogo_mcp/
│   ├── __init__.py          # Package initialization
│   ├── server.py            # Main MCP server with cross-cutting tools
│   ├── api_client.py        # Local data client with caching
│   ├── types.py             # Type definitions and data classes
│   ├── utils.py             # Utility functions and formatters
│   ├── events.py            # Event-related tools
│   ├── raids.py             # Raid-related tools
│   ├── research.py          # Research-related tools
│   ├── eggs.py              # Egg-related tools
│   └── rocket_lineups.py    # Team Rocket-related tools
├── data/                    # Local JSON data files (git-ignored)
├── tests/                   # Test files
├── server.py                # Main entry point
├── pyproject.toml           # Project configuration
└── README.md                # This file

Setup Development Environment

# Clone repository
git clone <repository-url>
cd pokemon-go-mcp

# Install with development dependencies
uv sync --all-extras --dev

# Code formatting
ruff format .

# Linting
ruff check .

# Type checking
pyright

Testing