TalentAnvil

List every class/spec available, with the slugs used by the other tools.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List the selectable talents for a class/spec (id, name, effect description, spell id, sub-tree, hero tree, choices). Call this before generate_build so you know the talent names and what each one does. Use get_spell for the full, freshest detail on any spell id.

{
  "type": "object",
  "properties": {
    "class": {
      "type": "string"
    },
    "spec": {
      "type": "string"
    }
  },
  "required": [
    "class",
    "spec"
  ],
  "additionalProperties": false
}

Produce a valid, importable loadout string for a class/spec. Provide talents to include (by name or id), an optional hero tree, and priority talents to fill remaining points. The solver enforces prerequisites, gates, and budgets.

{
  "type": "object",
  "properties": {
    "class": {
      "type": "string"
    },
    "hero_tree": {
      "type": "string"
    },
    "include": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "priorities": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "spec": {
      "type": "string"
    }
  },
  "required": [
    "class",
    "spec"
  ],
  "additionalProperties": false
}

Decode a loadout string into its class/spec and the list of selected talents.

{
  "type": "object",
  "properties": {
    "loadout_string": {
      "type": "string"
    }
  },
  "required": [
    "loadout_string"
  ],
  "additionalProperties": false
}

Get the importable loadout that players actually ran to kill a raid boss (or clear an M+ dungeon), aggregated from Warcraft Logs and the M+ leaderboards, for a class/spec. Pass a boss/dungeon name, or a general all-round build for the whole content: "All Bosses" for a raid (set difficulty to normal/heroic/mythic), or "All Dungeons" for M+ (set difficulty to "mythic_plus"). Returns the modal build string, sample size, and per-choice pick frequencies.

{
  "type": "object",
  "properties": {
    "class": {
      "type": "string"
    },
    "content_name": {
      "description": "Boss or dungeon name (partial match ok). Use \"All Bosses\" for the overall raid build, or \"All Dungeons\" for the overall M+ build.",
      "type": "string"
    },
    "difficulty": {
      "enum": [
        "normal",
        "heroic",
        "mythic",
        "mythic_plus"
      ],
      "type": "string"
    },
    "spec": {
      "type": "string"
    }
  },
  "required": [
    "class",
    "spec",
    "content_name"
  ],
  "additionalProperties": false
}

Get the current Blizzard details for a spell — name and full effect description — by spell id (from get_talents) or by name. Data is refreshed daily, so it reflects the live patch rather than stale training data.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "spell_id": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

Look up a live World of Warcraft character from Blizzard's armory: profile summary (class, spec, level, item level, guild, faction) plus the sections you ask for — gear, talents, stats, M+, raid and dungeon progress, professions, PvP, achievements, collections, and more. Defaults to equipment, talents, stats, mythic_plus. Talents return only the active spec's active loadout: hero tree, the importable talent_loadout_code (pass it to decode_build), and each talent as {node_id, talent_id, name, rank}; set include_inactive_loadouts for every other saved loadout's code. Equipment is compact: equipped item level, then per item slot, name, item level, track (name_description), stats, gems, enchants, spell/proc text, set and bonus_list; set bonuses sit once in equipped_item_sets. mythic_plus returns the current season's rating and the best run per dungeon. raids and dungeons cover the current expansion only, newest release first and Mythic → Raid Finder; use raid_expansions / dungeon_expansions for others. achievements returns a summary (total points, completed count, recent completions, per-category progress); use achievement_category (paged with achievements_limit / achievements_offset) to list completions in one category, or achievement_ids to check specific achievements with criteria progress. achievement_statistics lists its categories; use statistics_category for the values. pets is name/species/level/quality; completed_quests is quest ids. Results are kept under ~20k tokens: anything left out to fit is listed in truncated_sections with the request that fetches it.

{
  "type": "object",
  "properties": {
    "achievement_category": {
      "description": "With the achievements section: list completed achievements (id, name, completed date, points) in this category and its subcategories, newest first. A category name (e.g. \"Midnight Raid\") or id; an ambiguous name returns the matching ids.",
      "type": [
        "string",
        "integer"
      ]
    },
    "achievement_ids": {
      "description": "With the achievements section: completion status and date for each id, plus criteria progress for incomplete ones.",
      "items": {
        "type": "integer"
      },
      "maxItems": 50,
      "minItems": 1,
      "type": "array"
    },
    "achievements_limit": {
      "default": 50,
      "description": "Page size for achievement_category.",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "achievements_offset": {
      "default": 0,
      "description": "Skip this many completions in achievement_category (page on has_more).",
      "minimum": 0,
      "type": "integer"
    },
    "dungeon_expansions": {
      "default": "current",
      "description": "Dungeon progress to include: \"current\" (default, the newest expansion), \"all\", or a list of journal expansion ids.",
      "oneOf": [
        {
          "enum": [
            "current",
            "all"
          ],
          "type": "string"
        },
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        }
      ]
    },
    "include_cosmetic_slots": {
      "default": false,
      "description": "Also include the shirt and tabard slots in equipment.",
      "type": "boolean"
    },
    "include_inactive_loadouts": {
      "default": false,
      "description": "Also list every other saved loadout (all specs) as spec + talent_loadout_code.",
      "type": "boolean"
    },
    "include_mythic_plus_seasons": {
      "default": false,
      "description": "Also list the ids of every M+ season the character has played.",
      "type": "boolean"
    },
    "name": {
      "description": "Character name.",
      "type": "string"
    },
    "raid_expansions": {
      "default": "current",
      "description": "Raid progress to include: \"current\" (default, the newest expansion), \"all\", or a list of journal expansion ids.",
      "oneOf": [
        {
          "enum": [
            "current",
            "all"
          ],
          "type": "string"
        },
        {
          "items": {
            "type": "integer"
          },
          "type": "array"
        }
      ]
    },
    "realm": {
      "description": "Realm name or slug, e.g. \"Area 52\" or \"area-52\".",
      "type": "string"
    },
    "region": {
      "default": "us",
      "enum": [
        "us",
        "eu",
        "kr",
        "tw",
        "cn"
      ],
      "type": "string"
    },
    "sections": {
      "items": {
        "enum": [
          "achievement_statistics",
          "achievements",
          "appearance",
          "completed_quests",
          "dungeons",
          "equipment",
          "heirlooms",
          "hunter_pets",
          "media",
          "mounts",
          "mythic_plus",
          "pets",
          "professions",
          "pvp",
          "raids",
          "reputations",
          "stats",
          "talents",
          "titles",
          "toys"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "statistics_category": {
      "description": "With the achievement_statistics section: return the statistics in this category (name or id).",
      "type": [
        "string",
        "integer"
      ]
    }
  },
  "required": [
    "name",
    "realm"
  ],
  "additionalProperties": false
}