item_categories

Item categories from the game files (found in game files, unconfirmed, with the build): class and subclass with the client's English names and slugs, slot and quality. With no arguments, the whole tree with item counts. With item, that item's category path. With class (a slug such as weapon or armor), and optionally subclass, slot and quality slugs, the items in it. Ids only: item names come from player uploads (item_page).

Parameters#

iteminteger, 1 to 9007199254740991

An item id: answers its class, subclass, slot and quality.

classstring, up to 40 characters

Class slug, such as weapon, armor, consumable or trade-goods.

subclassstring, up to 40 characters

Subclass slug or number within the class, such as one-handed-swords or cloth.

slotstring, up to 40 characters

Slot slug, such as head, chest, one-hand or trinket.

qualityone of: poor, common, uncommon, rare, epic, legendary, artifact, heirloom

poor, common, uncommon, rare, epic, legendary, artifact or heirloom.

limitinteger, 1 to 100, default 25

Most items listed.

The answer#

Text for the assistant to read, and structuredContent with these top-level fields. The JSON Schema is at /schema/mcp/item_categories.json.

labelstringrequired

No description.

buildstringrequired

No description.

itemobject, or null

With item: its path, or null when the item is not in the build.

classesarray of objects

With no arguments: the whole tree, classes with items only.

itemsarray of objects

With class: the items in the category, up to limit.

totalinteger, -9007199254740991 to 9007199254740991

With class: how many items match, listed or not.

errorstring

A class or subclass that is not in the build.

creditstringrequired

No description.

Without an MCP client#

The same answer is a GET away: /api/tools/item_categories with the arguments in the query string. See the endpoint and the recipe.