Dusk Reborn RPG MCP server
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Give your AI assistant live, structured access to a fan-made browser RPG: which forms exist, and what they sell for.
Connect · Tools · See it work · How it works · Docs · Play the game
The Dusk Reborn RPG MCP server is a hosted, read-only Model Context Protocol endpoint for Pokemon Dusk Reborn, a free fan-made browser game with a player-run economy. An assistant can ask "does a Frost Mega Lugia exist?" or "what did Shadow Shellder sell for this month?" and get structured JSON back, instead of scraping web pages.
There is nothing to install and nothing to sign up for. It is one URL.
https://pkmnreborn.com/mcpUnofficial fan project. Not affiliated with, endorsed by or connected to Nintendo, The Pokemon Company, Creatures, GAME FREAK or Niantic. This repository holds documentation and examples only: no game code, no game assets and no Pokemon artwork. Prices are in GC coins, the game's fictional currency, and are not financial advice.
⚡ Connect in 30 seconds
Client | How |
Claude Code |
|
VS Code | Add to |
Cursor, Windsurf, Claude Desktop, MCP Inspector | |
Anything else | Add the URL as a remote MCP server (Streamable HTTP, no authentication) |
Or skip the client and call it directly:
curl -s https://pkmnreborn.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_pokedex_variants","arguments":{"species":"Mew"}}}'Related MCP server: Pokemon Showdown MCP Server
🧰 Tools
Seven tools, all annotated readOnlyHint: true and destructiveHint: false, all returning structured JSON.
Pokedex: what exists in the game
Tool | Answers |
| Every registered form of a species, with color, form type and exact in-game name |
| Up to 25 exact form names in one call: is each one registered? |
Stock Market: what forms sell for between players
Tool | Answers |
| Find colored forms by name, with reference price, 30 day change and recent sales |
| The full market record for one colored form |
| Recorded player-to-player sales, newest first, plus a daily reference price series |
| Biggest risers, fallers and most traded forms over the last 30 days |
| Market totals and the game's own plain-language explanation of how prices are made |
Arguments and result fields for each tool: docs/tools.md.
🎬 See it work
Real output from the live server (2026-11-15), trimmed for length.
Prompt: "Which forms of Mew are registered, and how many?"
// get_pokedex_variants { "species": "Mew" }
{
"species": "Mew",
"dex_number": 151,
"count": 11,
"variants": [
{ "name": "Mew", "color": "Normal", "form_type": "base" },
{ "name": "MegaMew", "color": "Normal", "form_type": "mega" },
{ "name": "ShinyMew", "color": "Shiny", "form_type": "base" }
// ...8 more
]
}Prompt: "What does a Shadow Shellder go for?"
// get_pokemon_price { "name": "Shadow Shellder" }
{
"display_name": "Shadow Shellder",
"reference_price": { "amount": 1000, "currency": "GC", "basis": "level_5_copy" },
"recorded_sales": 16,
"copies_in_game": 133,
"color_bonus": { "amount": "15%", "stat": "Attack" },
"price_status": "priced"
}More things to ask: "Does a Frost Mega Lugia exist?", "Which colored forms moved the most in the last 30 days?", "Show the last five sales of Shadow Shellder."
🏗️ How it works
flowchart LR
A["AI client<br/>Claude, VS Code, Cursor, ..."] -- "POST JSON-RPC<br/>Streamable HTTP" --> B["/mcp"]
subgraph Game ["Dusk Reborn RPG (hosted)"]
B --> C["Guard<br/>method, size, rate limit"]
C --> D["Seven read-only tools"]
D --> E[("Registered forms<br/>+ aggregated market data")]
end
F["Server Card<br/>AI Catalog<br/>llms.txt<br/>OpenAPI"] -. discovery .-> A
G["Official MCP Registry"] -. discovery .-> AThe server is part of the live game and shares its data with the public Pokedex and Stock Market pages, so every answer matches what a player sees on the site.
Design decisions
Read-only by construction. No write tools exist. Results contain aggregates and public game records only: no player accounts, inventories, trades or contact details, and sales carry no player names.
Stateless. One JSON response per request, no sessions, no event stream. It scales like a plain HTTP endpoint and needs no sticky routing.
GETandDELETEanswer405.Four protocol revisions. The stateless
2026-07-28revision and the legacy2025-03-26,2025-06-18and2025-11-25revisions all work, so older clients keep working.Errors a model can use. Bad input returns a normal result with
isError: trueand a message such ascolor must be one of Shadow, Haunted, ...; limit must be 1 to 25., not an opaque HTTP error.Protected cheaply. Method, size, content type and rate limits (about 60 a minute and 1,000 an hour per client) are checked before the database is opened. Over the limit:
429withRetry-After.Honest about its data. Reference prices are a weighted middle of completed sales, normalized to a level 5 copy, rebuilt about hourly, with gifts and related-account trades discounted. See docs/data-notes.md.
Discoverable. Listed in the official MCP Registry under a domain-proved name, with a Server Card, an AI Catalog,
llms.txtand an OpenAPI file.
🔌 Also a REST API
The same data is available over plain GET, no key. See docs/api.md for routes, or the
OpenAPI description.
curl -s 'https://pkmnreborn.com/api/v1/market?q=shellder&color=Shadow&per_page=5'📚 Documentation
Arguments and result fields for all seven tools | |
Routes, filters and examples | |
Claude Code, VS Code, Cursor, Windsurf, Claude Desktop, Inspector, curl | |
What the data is, and is not | |
Limits, errors, protocol versions | |
The same information as a web page | |
What changed, and when |
🚦 Limits
About 60 requests a minute and 1,000 an hour per client address. If the game's Stock Market is switched off, /mcp
answers 404.
🤝 Feedback, security and rights holders
Bugs and wrong data: open an issue here, or use #bugs-and-errors on Discord.
Security: see SECURITY.md. Please do not post details publicly.
Contributing: documentation fixes and verified client configs are welcome. See CONTRIBUTING.md.
Rights holders: Pokemon and related names, characters and artwork are trademarks and copyrights of their respective owners, including Nintendo, Creatures, GAME FREAK and The Pokemon Company. This project uses them as a fan project and does not claim them. Questions or requests: admin@pkmnreborn.com.
🎮 About the game
Pokemon Dusk Reborn is a free-to-play browser RPG made by fans, for fans, and run as a not-for-profit hobby project. Play it, read how to play, or join the Discord.
License
The documentation and examples in this repository are released under the MIT License. The game itself and the MCP server's code are not part of this repository and are not covered by that license.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Provide detailed Pokémon data and information through a standardized MCP interface. Enable LLMs an…
Real sold prices, history & PSA population for graded Pokémon cards (EN/JP/CN). Knows nicknames.
Read-only BYO-key MTG/TCG pricing MCP with repricing suggestions. AI-authored.
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables 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.41-
- 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
- AlicenseBqualityDmaintenanceEmpowers AI assistants to fetch and explore comprehensive Pokémon data from PokeAPI via 47 tools covering Pokémon, moves, items, game mechanics, and more.4781 npm2ISC
- FlicenseNot gradedqualityDmaintenanceExposes comprehensive Pokémon data from the main games and Pokémon GO through MCP tools, including stats, evolutions, moves, types, abilities, items, and GO-specific features like raid bosses, Community Days, and IV estimation.-