Pokemon Dusk Reborn API and MCP server
We run a free, read-only API and MCP server so AI assistants and developers can check what exists in the game and what colored forms sell for, without scraping pages. It serves the same public data the Pokedex and Stock Market pages show. There's no key and no sign-up.
Pokemon Dusk Reborn is a free, fan-made browser game, run as a not-for-profit hobby project. It isn't an official Pokemon product and isn't connected to Nintendo, The Pokemon Company, Creatures or GAME FREAK. See the legal information.
Connect to the MCP server
| Endpoint | https://pkmnreborn.com/mcp |
|---|---|
| Transport | Streamable HTTP. Send a POST with a JSON-RPC message and you get one JSON response back. There are no sessions and no streaming. |
| Login | None. No API key, no OAuth. |
| Protocol versions | 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26 |
| Limits | About 60 requests a minute per address. Over that you get a 429 with a Retry-After header. |
| Server Card | https://pkmnreborn.com/mcp/server-card |
| AI Catalog | https://pkmnreborn.com/.well-known/ai-catalog.json |
A plain GET to /mcp answers 405, because the endpoint only takes POST requests. If you just want to see it's alive, open the Server Card above in a browser.
Add it to Claude Code with one command:
claude mcp add --transport http dusk-reborn https://pkmnreborn.com/mcp
Most other MCP clients take the same thing as a remote server URL with no authentication:
{
"mcpServers": {
"dusk-reborn": { "type": "http", "url": "https://pkmnreborn.com/mcp" }
}
}
Tools
All seven tools are read-only. A bad argument comes back as a normal result with isError set and a short message, not as an HTTP error.
| Tool | What it answers |
|---|---|
get_pokedex_variants | Every form of one species that is registered in the game, with its color, form type and exact in-game name. Takes a species such as Lugia. |
check_pokedex_forms | Does each of up to 25 exact form names exist in the game? Takes names, an array, and returns registered, registered_artwork_missing or not_registered for each. |
search_pokemon | Find colored forms on the Stock Market by name, with reference price and recent sales. Takes query, and optionally color and limit. |
get_pokemon_price | The Stock Market record for one colored form, such as ShadowShellder: reference price, 30 day change, recorded sales and copies in the game. |
get_price_history | Recorded player-to-player sales for one form, newest first, plus a daily reference price. |
get_market_trends | The biggest risers, fallers and most traded forms over the last 30 days. |
get_market_summary | Market totals and a plain explanation of how reference prices are worked out. |
Example: which forms of Lugia exist in the game?
Request:
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":"Lugia"}}}'
The answer carries a structuredContent object. This is the relevant part, trimmed to three of the 11 forms:
{
"species": "Lugia",
"dex_number": 249,
"count": 11,
"variants": [
{ "name": "Lugia", "label": "Lugia", "color": "Normal", "form_type": "base" },
{ "name": "ShadowLugia", "label": "Shadow Lugia", "color": "Shadow", "form_type": "base" },
{ "name": "FrostMegaLugia", "label": "Frost Mega Lugia", "color": "Frost", "form_type": "mega" }
]
}
Example: does a specific form exist?
Ask with the exact in-game names, with no spaces:
{"name":"check_pokedex_forms",
"arguments":{"names":["FrostMegaLugia","GlitterMegaRegice"]}}
Answer, trimmed:
[
{ "requested": "FrostMegaLugia", "status": "registered" },
{ "requested": "GlitterMegaRegice", "status": "not_registered" }
]
What the answers mean
- Registered means the form exists in the game. It doesn't say how many players own it.
- Prices are in GC coins, the game's fictional currency. They aren't real money and they aren't financial advice.
- Reference prices are rebuilt about once an hour from completed player sales. They aren't live quotes.
- No accounts, inventories, trades or other player data are exposed, and nothing can be changed through the API or MCP server.
REST API
The same data is available as plain JSON over GET. The OpenAPI description lists every route.
- Forms of one species: /api/v1/pokedex/Lugia/variants
- Exact-name check, up to 25 names: /api/v1/pokedex/variants?names=FrostMegaLugia,GlitterMegaRegice
- Stock Market summary: /api/v1/market/summary
- One colored form: /api/v1/market/ShadowShellder
More for tools and crawlers
- llms.txt, a plain-text map of the public pages and endpoints
- The Pokedex, where each entry lists its registered forms as text, and its sitemap
- The Stock Market, the pages behind the price data
- Documentation and client examples on GitHub
Something wrong or missing?
Tell us in the #bugs-and-errors channel on Discord. New to the game? How to play takes a few minutes to read.