random-pokemon-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@random-pokemon-mcp generate a random team with seed "ash" using fire types"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
random-pokemon-mcp
Offline TypeScript MCP server using @modelcontextprotocol/sdk and stdio. Node.js >=20. No backend, keys, telemetry or runtime API requests. Companion website: https://random-pokemon-generator.org
0.3.0 changelog: expanded local calc_damage with weather, terrain, supported damage items/abilities and Terastallization, Gen IX stepwise rounding, explicit support tables and warnings. Calls without new fields retain 0.2.0 numeric results. Not yet published; npm publication remains manual.
0.2.0 changelog: added real abilities (including hidden flags), independent legendary/mythical filtering, and learnable damaging-move type coverage from an offline PokeAPI snapshot. National Dex 1–1025, bundled English names, default forms only. Generation filters mean introduction generation; matchups use Gen VI+ types.
两种使用方式,让用户自己选
本地版(stdio):使用下方
npx -y random-pokemon-mcp@0.3.0安装配置;数据随包离线提供,无需 API 密钥。托管版(网站 Worker):支持远程 MCP 的客户端可使用
https://random-pokemon-generator.org/api/mcp,无需本地安装。托管服务独立开发、部署与更新,功能和数据版本可能与本地版不同。
Related MCP server: Pokemon Showdown MCP Server
Install and configure
After the package is manually published, run npx -y random-pokemon-mcp@0.3.0. Before publication use npm ci && npm run build, then configure node /absolute/path/random-pokemon-mcp/dist/index.js.
Claude Code:
claude mcp add random-pokemon -- npx -y random-pokemon-mcp@0.3.0Cursor (.cursor/mcp.json) and Claude Desktop (claude_desktop_config.json):
{"mcpServers":{"random-pokemon":{"command":"npx","args":["-y","random-pokemon-mcp@0.3.0"]}}}VS Code (.vscode/mcp.json):
{"servers":{"random-pokemon":{"type":"stdio","command":"npx","args":["-y","random-pokemon-mcp@0.3.0"]}}}On Windows use npx.cmd if required by the client. stdout contains MCP protocol only.
Exactly five tools
Tool | Input and behavior |
|
|
| Optional |
|
|
|
|
| Required |
Damage calculation in 0.3.0
All new fields are optional. No new fields means exact 0.2.0 numeric compatibility, including its combined final flooring and no implicit abilities. Passing any new field (even weather:"none" or useAbilities:false) enables Gen IX single-target stepwise rounding. Output reports assumptions, modified stats, power, weather, STAB, effectiveness, selected abilities, warnings, 16 random rolls, HP percentages and OHKO counts. Every success/error declares omissions; success distinguishes included mechanics from remaining limits.
Optional field | Accepted values / behavior |
|
|
|
|
|
|
| Optional booleans for terrain eligibility only. Default uses current defensive type (including Tera) and selected Levitate. Does not remove Flying/Levitate Ground immunity or model Gravity, Iron Ball or Air Balloon. Terrain itself never grants Ground immunity. |
| Attacker-held item; English identifiers below, spaces/underscores/case normalized. Unknown/unsupported items return a readable error with the supported list. |
|
|
| English PokeAPI identifier, |
| One of 18 English types. Attacker retains original offensive STAB ×1.5; new Tera type gains ×1.5, or ×2 if originally matching. Adaptability applies only to the Tera type after Tera (×2 for new type, ×2.25 for original type). Defender's defensive types become only its Tera type. Stellar unsupported. |
| Explicit boolean, default false: critical damage ×1.5, ignores negative attack/positive defense stages; Sniper adds ×1.5. Critical probability is not calculated. |
Supported items (source of truth: SUPPORTED_ITEMS / TYPE_ITEMS in src/damage.ts): none, choice-band (physical Attack ×1.5), choice-specs (Special Attack ×1.5), life-orb (final modifier 5324/4096), expert-belt (super-effective only, 4915/4096), plus type power boosters (4915/4096):
Type | Item | Type | Item |
normal | silk-scarf | fire | charcoal |
water | mystic-water | electric | magnet |
grass | miracle-seed | ice | never-melt-ice |
fighting | black-belt | poison | poison-barb |
ground | soft-sand | flying | sharp-beak |
psychic | twisted-spoon | bug | silver-powder |
rock | hard-stone | ghost | spell-tag |
dragon | dragon-fang | dark | black-glasses |
steel | metal-coat | fairy | fairy-feather |
Supported ability effects: Huge Power/Pure Power double physical Attack (大力士/瑜伽之力); Unaware (纯朴) instead ignores the opponent's relevant stat stages. Adaptability modifies STAB, Technician boosts power ≤60, Sniper boosts explicit critical hits, Solar Power boosts Special Attack in sun, Sand Force boosts Ground/Rock/Steel power in sand, Dry Skin boosts incoming Fire power and grants Water immunity. Air Lock/Cloud Nine suppress weather. Levitate grants Ground immunity; Water Absorb/Storm Drain/Dry Skin, Flash Fire, Lightning Rod/Volt Absorb/Motor Drive and Sap Sipper grant the corresponding type immunity. Absorption's later stat boosts and activated Flash Fire damage boost are not modeled.
Chlorophyll, Swift Swim, Rain Dish, Sand Rush, Sand Veil, Snow Cloak, Slush Rush and Ice Body are recognized as having no direct damage effect in this calculation; speed, accuracy and healing are outside scope. Drought, Drizzle, Sand Stream and Snow Warning are recognized setters, but the caller supplies current weather; switch-in order and weather activation are not inferred. snow-warning does not infer hail versus snow. SUPPORTED_ABILITIES in code/output is the complete supported table; every other selected ability produces a warning.
Example (local MCP):
{"attacker":"charizard","defender":"venusaur","moveType":"fire","power":90,"category":"special","weather":"sun","item":"life-orb","attackerAbility":"solar-power","teraType":"fire"}Still omitted: burn, Reflect/Light Screen/Aurora Veil, doubles/spread modifiers, special move mechanics (including Tera's conditional 60-power minimum, Tera Blast, multi-hit and fixed damage), Stellar, unsupported abilities/items, healing/chip, integer overflow at extreme inputs, critical chance and move legality. Supply an ordinary single-hit move's already determined type/power/category. Immunities yield zero damage; Shedinja HP is 1. No TCG, GO or Nuzlocke scope.
Mechanics checked against the primary Smogon damage calculator implementation and its rounding/STAB utilities. These references are development evidence; no new runtime dependencies or network calls.
Data provenance
Base facts come from the companion site's local libs/pokemon/data/pokemon.json (1025 records: names, types, stats, introduction generation and image URLs). src/type-chart.ts retains its 18×18 Gen VI+ chart. Original source-byte hashes remain in data/source-sha256.json.
Additional snapshot: PokeAPI, fetched 2026-10-26, covering default Pokémon IDs 1–1025 through https://pokeapi.co/api/v2/pokemon/{id} and https://pokeapi.co/api/v2/pokemon-species/{id}. Referenced /api/v2/move/{id} responses supply type and damage class. data/pokeapi.json stores only abilities, separate classification flags and a sorted set of learnable non-status move types per species, plus provenance. Response SHA-256 hashes are in data/pokeapi-sha256.json. No move names/individual learnsets/version details are bundled: this keeps the package small but cannot validate submitted moves, game legality or infer battle roles. Roles remain explicitly unknown.
Reproduce with Python 3 + requests installed, then python3 scripts/snapshot-pokeapi.py [cache-directory] (default cache /tmp/random-pokemon-pokeapi-cache). Three workers, 200ms pause per request, up to five attempts with exponential backoff, cached raw responses and fail-on-error; output files are written only after every required response succeeds. Keep the cache for raw-data audits; it is excluded from npm. Runtime never calls PokeAPI. No image files are fetched or bundled; artwork stays URL-only. Pokémon names/artwork remain the property of their respective owners. MIT covers this project's code; no ownership of third-party Pokémon material is asserted.
Development and verification
npm ci
npm run build
npm run smoke
node scripts/damage-check.mjs # optional argument: path to a built 0.2.0 dist/index.js
npm pack --dry-run --json > pack-dry-run.json
node scripts/validate-package.mjsSmoke invokes the MCP Inspector CLI for tools/list and each tool, plus the SDK client for successful calls to all five tools, invalid inputs and recovery, deterministic seeds, chart/data invariants and damage declarations. Lockfile pins the dependency tree. Inspector is a development dependency only.
Manual release checklist (not executed)
Review the offline snapshot provenance, limitations and acceptance checks.
Check npm name ownership, run checks above; manually
npm login, thennpm publish --access publicwhen ready.Validate
server.jsonagainst the official Registry schema; after npm publication follow official Registry publishing to verifyio.github.yuren-devownership and publish withmcp-publisher. npmmcpNamematches the manifest.Manually submit/claim GitHub/package details on Glama and mcp.so after checking current submission requirements. No OAuth, registry publishing, directory claim or submission is performed by this repository's scripts.
License: MIT.
Available Tools
5 toolsanalyze_teamARead-only
Analyze 1–6 Showdown sets: defensive weaknesses, learnable damaging-move type coverage, base-speed tiers and evidence gaps. Across all PokeAPI version groups; no submitted-move or current-format legality verification.
Inputs: text (required).
calc_damageARead-only
Regular single-target physical/special damage. No new fields: exact 0.2.0 numeric compatibility. Any new field enables Gen IX modifiers and stepwise rounding. useAbilities=true selects each species' first non-hidden ability; attackerAbility/defenderAbility override (auto/none/API identifier). Weather is current state, not inferred from setters. Explicit move type/power required. 仍未计入项:烧伤、反射壁/光墙/极光幕、双打/多目标、特殊招式机制(太晶威力下限/太晶爆发/多段/固定伤害等)、星晶、未列出的特性/道具、场外持续伤害与回血、极端数值溢出;不是完整对战模拟。
Inputs: power (required), attacker (required), category (required), defender (required), +20 more.
get_pokemonARead-only
Look up a bundled English species name or National Dex ID, with PokeAPI abilities and separate legendary/mythical flags; artwork URL only.
Inputs: pokemon (required).
get_type_effectivenessCRead-only
Gen VI+ 18-type attack groups and/or multiplied defense for one or two distinct types.
Inputs: attacking, defending.
random_teamARead-only
Six unique species; deterministic seed, generation and any-matching type filters. Legendary and mythical inclusion flags independently filter PokeAPI classifications.
Inputs: seed, types, generations, includeMythical, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct task: species lookup, type-chart lookup, random team generation, team analysis, and damage calculation. analyze_team and calc_damage are complementary rather than overlapping, so an agent can tell when to use each.
All names use snake_case, but the action conventions are mixed: get_, random_, analyze_, and calc_. The set is still readable, but it does not follow a uniform verb_noun pattern throughout.
Five tools is well-scoped for a Pokemon lookup and battle-assistance server. Each tool covers a distinct workflow without obvious bloat or excessive fragmentation.
Core workflows are covered, but the surface lacks direct move, ability, and item lookup tools. calc_damage requires explicit move type/power and analyze_team references learnable moves, so agents must rely on prior knowledge or external data for important supporting details.
Maintenance
Related MCP Connectors
Look up Pokémon, moves, abilities, items, natures, and type matchups from PokéAPI v2.
Read-only Pokémon Champions VGC data: legality, usage stats, type analysis and matchup calcs.
Provide detailed Pokémon data and information through a standardized MCP interface. Enable LLMs an…
Pokemon MCP — wraps PokéAPI (free, no auth required)
Related MCP Servers
- FlicenseCqualityDmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceProvides Pokemon Showdown competitive battle data to AI assistants, enabling lookup of Pokemon stats, moves, abilities, items, type matchups, and strategic information through natural language queries.85MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Pokémon battle advising: provides type matchups, damage calculation, party analysis, and move/ability data for AI agents like Claude Code and Codex.23MIT
- AlicenseNot gradedqualityDmaintenanceEnables fetching Pokémon data from PokeAPI, searching for Pokémon and moves, and simulating battles between two Pokémon with type effectiveness and status effects.MIT