Pokemon Paste MCP Server

MCP server for creating Pokémon pastes (pokepastes)

Installation

From npm (Recommended)

npm install -g pokemon-paste-mcp

From source

npm install
npm run build

Usage

The server provides a create_pokepaste tool that accepts Pokemon set data and creates a Pokepaste URL.

Tool: create_pokepaste

Creates a Pokepaste from an array of Pokemon set objects.

Parameters:

pokemon (array, required): Array of Pokemon set objects
title (string, optional): Title for the paste
author (string, optional): Author name
notes (string, optional): Additional notes

Pokemon Set Object Structure:

{
  "name": "string",
  "species": "string", 
  "item": "string",
  "ability": "string",
  "moves": ["string", "string", "string", "string"],
  "nature": "string",
  "gender": "string",
  "evs": {
    "hp": 0,
    "atk": 252,
    "def": 0,
    "spa": 4,
    "spd": 0,
    "spe": 252
  },
  "ivs": {
    "hp": 31,
    "atk": 31,
    "def": 31,
    "spa": 31,
    "spd": 31,
    "spe": 31
  },
  "level": 50,
  "shiny": false,
  "happiness": 255,
  "pokeball": "Poke Ball",
  "hpType": "Electric",
  "dynamaxLevel": 10,
  "gigantamax": false,
  "teraType": "Electric"
}

Example Usage:

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50
    }
  ],
  "title": "My Team",
  "author": "Trainer"
}

MCP Client Configuration

Configure your MCP client (Claude Desktop, Cursor, etc.):

Using remote npm package:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "npx",
      "args": ["pokemon-paste-mcp"],
      "env": {}
    }
  }
}

Local development:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "node",
      "args": ["/path/to/pokemon-paste-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Testing

Local MCP Tool Testing

You can test the local MCP server using the MCP Inspector:

npm run build
npx @modelcontextprotocol/inspector node path/to/pokemon-paste-mcp/dist/index.js

If you want to test the MCP server directly with your MCP client, use this complete test input:

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": false
    },
    {
      "name": "Charizard",
      "species": "Charizard",
      "item": "Charcoal",
      "ability": "Blaze",
      "moves": ["Flamethrower", "Air Slash", "Solar Beam", "Roost"],
      "nature": "Modest",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "teraType": "Fire"
    },
    {
      "name": "Alakazam",
      "species": "Alakazam",
      "item": "Life Orb",
      "ability": "Magic Guard",
      "moves": ["Psychic", "Focus Blast", "Shadow Ball", "Recover"],
      "nature": "Timid",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": true,
      "pokeball": "Ultra Ball"
    }
  ],
  "title": "Sample Competitive Team",
  "author": "Pokemon Trainer",
  "notes": "A balanced team with Pikachu as the main attacker, Charizard for coverage, and Alakazam for special sweeping."
}

This test input includes:

Three diverse Pokemon with different roles
Various optional fields (shiny, teraType, pokeball)
Sample EV/IV spreads for competitive play
Team metadata (title, author, notes)

The expected output should be a Pokepaste URL that you can visit to see the formatted team.

Author's Note

Interested in the progress of this project? Feel free to follow the repo for live updates!

If you need to get a hold of me regarding this project, feel free to either:

email me at professor.ragna@gmail.com
tweet me @professorragna

If you're interested in helping to fund this project, you can support me here. Any and all support is greatly appreciated!

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

create_pokepaste

Creates shareable Pokepaste URLs from Pokémon team data, allowing users to format and share competitive Pokémon teams via a simple API.

Related MCP Servers

pokemon-api-server
Harnishnava
-
security
F
license
-
quality
Fetch Pokémon data from PokéAPI
Last updated -
Python
Poke-MCP
NaveenBandarage
A
security
F
license
A
quality
A Model Context Protocol server that provides Pokémon information by connecting to the PokeAPI, enabling users to query detailed Pokémon data, discover random Pokémon, and find Pokémon by region or type.
Last updated -
4
2
TypeScript
PokeAPI MCP Server
AkhrHysd
-
security
-
license
-
quality
A Model Context Protocol server that interfaces with PokeAPI to provide Pokémon information to LLM applications through JSON-RPC over stdio.
Last updated -
TypeScript
Spotify Model Context Protocol
belljustin
A
security
A
license
A
quality
Enables creating Spotify playlists based on text descriptions by connecting Cursor editor to Spotify's API through OAuth authentication.
Last updated -
3
Python
MIT License

View all related MCP servers

Pokemon Paste MCP Server