D3 Ladder MCP Server
Diablo 3 game data and players' live gear, for Claude and other AI assistants
What it does
The D3 Ladder MCP server lets an AI assistant answer Diablo 3 questions with data from Blizzard's official API instead of outdated wikis: every class skill and rune, a search over every equippable item by name or by what its legendary power and set bonuses do, the current season's theme, and what a player's heroes are wearing right now.
It is free and read-only. There is no account, no API key and no sign-in.
Connect
Server URL (Streamable HTTP):
https://www.d3ladder.com/mcp
- Claude (web and desktop): open Settings, then Connectors, choose Add custom connector, name it D3 Ladder and paste the URL. No authentication is needed.
-
Claude Code:
run
claude mcp add --transport http d3ladder https://www.d3ladder.com/mcp - Other MCP clients: add it as a remote HTTP server with no authentication. It speaks protocol versions 2025-06-18 and 2024-11-05.
Things to ask
What legendary items and set bonuses make Whirlwind stronger?
List every Necromancer skill and rune, and which ones unlock by level 30.
What is this season's theme, and what does it give a Wizard?
Look up Name#1234's heroes and review the gear on their highest-paragon one.
Tools
Class skills get_class_skills
Every active skill of a class with all its runes, and every passive, each with the level it unlocks at and its in-game description.
-
class(string, required): one of barbarian, crusader, demon-hunter, monk, necromancer, witch-doctor, wizard
Search items search_items
Search every equippable item, gem and follower token. Name matches come first, then items whose legendary power, set bonuses or affixes mention the query. Returns summaries (id, name, type, slots, legendary power, set name) and the total number of matches; call get_item for an item's full details.
-
limit(integer, optional): Most results to return (default 25). -
query(string, optional): Case-insensitive text matched against item names, legendary powers, set names, set bonuses and affixes, e.g. a skill name like "Whirlwind". -
slot(string, optional): Only items worn in this slot: head, shoulders, neck, torso, hands, bracers, waist, legs, feet, left-finger, right-finger, left-hand, right-hand, follower-neck, follower-left-finger, follower-right-finger, follower-left-hand, follower-right-hand, follower-special. left-hand is the main hand, right-hand the off hand. Gems have no slot.
Item details get_item
One item's full details: affixes with their roll ranges, random affix choices, legendary power, and set bonuses with the set's pieces.
-
item(string, required): An item id from search_items, an exact item name, or a unique part of one.
Season theme get_season_theme
The season's theme: its seasonal mechanic, the rules around it and, when it grants powers, each class's powers. Defaults to the current season. Seasonal heroes have it; non-seasonal heroes don't.
-
season(integer, optional): A season number; omit for the current season.
List a player's heroes list_heroes
A player's heroes, refreshed from Blizzard (at most every 10 minutes): hero ids for get_hero plus class, level, paragon and the seasonal, hardcore and dead flags.
-
battletag(string, required): The player's BattleTag, e.g. Name#1234. Any capitalization works, except a mixed-case one (LikeThis#1234) for a player on no ladder, which must be exact.
A hero's live gear get_hero
What a hero is wearing right now, live from Blizzard: gear per slot with affixes, gems and set bonuses, active skills with runes, passives, Kanai's Cube powers, follower gear and key stats. Call list_heroes first.
-
battletag(string, required): The player's BattleTag, e.g. Name#1234. Any capitalization works, except a mixed-case one (LikeThis#1234) for a player on no ladder, which must be exact. -
hero_id(integer, required): From list_heroes.
Limits
- Game data is current to the live game. Item search covers every equippable item, gem and follower token.
- A player's hero list is refreshed from Blizzard at most every 10 minutes. Gear is fetched live on every call.
- Requests to Blizzard are capped across everyone using the site. When the cap is hit, a tool says the server is busy; try again a few seconds later.
- Season themes are recorded from Season 40 on; Blizzard's API has none, so they are added by hand.
- Only what Blizzard publishes is available. BattleTags need the number after the hash. Capitalization doesn't matter, except for one that mixes capitals and lowercase, like LikeThis#1234, whose player isn't on a ladder yet: that has to be exact.
Privacy and support
There are no accounts, so nothing is tied to you. A BattleTag you look up is stored the same way as a profile lookup on the website: the player's public hero list. Gear is never stored. Server request logs, which include IP addresses, are deleted every two weeks; see the privacy policy.
Something broken or missing? Get in touch. D3 Ladder is an unofficial fan site with no connection to Blizzard Entertainment.