73,840 Total Trainers

531,442 Total Pokémon

Curious what the game is like before you plug into it?
Read how to play
Create a Trainer

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

Endpointhttps://pkmnreborn.com/mcp
TransportStreamable HTTP. Send a POST with a JSON-RPC message and you get one JSON response back. There are no sessions and no streaming.
LoginNone. No API key, no OAuth.
Protocol versions2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26
LimitsAbout 60 requests a minute per address. Over that you get a 429 with a Retry-After header.
Server Cardhttps://pkmnreborn.com/mcp/server-card
AI Cataloghttps://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.

ToolWhat it answers
get_pokedex_variantsEvery 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_formsDoes 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_pokemonFind colored forms on the Stock Market by name, with reference price and recent sales. Takes query, and optionally color and limit.
get_pokemon_priceThe Stock Market record for one colored form, such as ShadowShellder: reference price, 30 day change, recorded sales and copies in the game.
get_price_historyRecorded player-to-player sales for one form, newest first, plus a daily reference price.
get_market_trendsThe biggest risers, fallers and most traded forms over the last 30 days.
get_market_summaryMarket 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.

More for tools and crawlers

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.

Loading...