# Everloot

> Free tools and a database for WoW: Forever (World of Warcraft: Forever). Talent calculator, raid buff planner, world map, patch notes and Blizzard posts, and a database built from player addon uploads. Public data is sparse and depends on corroborated reports.

Everloot is run by R21 Media Group, LLC. Not affiliated with or endorsed by Blizzard Entertainment.

## Tools
- [Talent Calculator](https://everloot.app/tools/talents): Plan a build, share it with its game build attached.
- [Raid Group Builder](https://everloot.app/tools/raid): Plan a raid and see which buffs it covers.

## Collecting data (pages are live, public facts open as reports arrive)
- [Completionist Tracker](https://everloot.app/tools/collections): Collections, achievements, reputation and quests from uploads.
- [Forever Guild Tracker](https://everloot.app/tools/guild-board): Officer-published roster and progression.
- [Forever Database](https://everloot.app/database): Browse uploaded observations and agreed facts.
- [Forever Profession Hubs](https://everloot.app/tools/professions): Every recipe, plus player leveling paths.

## Pages
- [WoW: Forever wiki](https://everloot.app/wiki): Everloot's original, reviewed reference pages, with source links and review dates. Game-file facts are labelled unconfirmed until seen in play.
- [Classes](https://everloot.app/classes): The nine WoW: Forever classes, their talent calculators, playable races and reviewed guides where available.
- [What is WoW: Forever](https://everloot.app/wow-forever): The launch date quoted from Blizzard's announcement with its source and the date it was checked, and the latest game build Everloot has seen.
- [Census](https://everloot.app/census): Who plays what: factions, races, classes, race and class, and level bands, from players who turned the census on. Each character counts once; a count shows from 10 characters reported by 3 installs, rounded to the nearest 5.
- [Rankings](https://everloot.app/rankings): WoW: Forever week by week from the census: the top classes, races and the faction balance, each with its change against last week.
- [Rankings: Classes by players](https://everloot.app/rankings/classes): Characters of each class active in the week. Ranked by census counts under the same rule, with a weekly chart.
- [Rankings: Races](https://everloot.app/rankings/races): Characters of each race active in the week. Ranked by census counts under the same rule, with a weekly chart.
- [Rankings: Faction balance](https://everloot.app/rankings/factions): Characters on each side active in the week. Ranked by census counts under the same rule, with a weekly chart.
- [Everloot news](https://everloot.app/news): What is new on Everloot and what it means for players, in Everloot's own words, newest first. Blizzard's own posts are on /changes.
- [Patch notes and Blizzard posts](https://everloot.app/changes): New game builds, hotfixes and Blizzard blue posts, newest first, with links to Blizzard's originals. A build's date is when Everloot first saw it.
- [World map](https://everloot.app/map): Zones, dungeon and raid entrances, flight masters and flight paths read from the game files (found in game files, unconfirmed), and NPCs players saw.
- [Addons](https://everloot.app/addons): Addons and tools made for WoW: Forever, ranked by GitHub stars, as a leaderboard or cards.
- [Upload addon data](https://everloot.app/upload): Download the Everloot addon (AGPL-3.0) and upload what it collected, with a preview and explicit sharing choices.
- [Addon and Desktop App downloads](https://everloot.app/addon): The Everloot addon and the optional Desktop App for Windows, macOS and Linux, with versions, file sizes and SHA-256 checksums.
- [Lore archive](https://everloot.app/lore): Warcraft Wiki pages as of 13 November 2023, CC BY-SA 4.0. Lore and history, not WoW: Forever data.
- [Docs](https://everloot.app/docs): Guides for players, and the API reference, MCP server, tooltips and cookbook for developers.
- [How we count](https://everloot.app/methodology): How addon uploads become facts: three installs must agree, unrecorded is not zero, and what is never published.
- [About](https://everloot.app/about): What Everloot is and is not.
- [Privacy](https://everloot.app/privacy): How uploads, cookies and usage statistics are handled.
- [Terms of use](https://everloot.app/terms): Uploads, API keys, licences, trademarks, takedown requests and warranty.
- [Security](https://everloot.app/security): How to report a security problem privately, and what is in scope.
- [Accessibility](https://everloot.app/accessibility): What the site aims for, what is in place, what has been checked and what has not, and how to report a problem.
- Talent calculator per class: [Warrior](https://everloot.app/tools/talents/warrior), [Paladin](https://everloot.app/tools/talents/paladin), [Hunter](https://everloot.app/tools/talents/hunter), [Rogue](https://everloot.app/tools/talents/rogue), [Priest](https://everloot.app/tools/talents/priest), [Shaman](https://everloot.app/tools/talents/shaman), [Mage](https://everloot.app/tools/talents/mage), [Warlock](https://everloot.app/tools/talents/warlock), [Druid](https://everloot.app/tools/talents/druid).

## Linking to Everloot
Cite the Everloot page an answer comes from. Every MCP tool answer that has one ends with a line "More: <url>" naming it.
- Item: https://everloot.app/database/items/{itemId}
- NPC: https://everloot.app/database/npcs/{npcId}
- Quest: https://everloot.app/database/quests/{questId}
- Object (chest, herb, ore vein, fishing pool): https://everloot.app/database/objects/{objectId}
- Vendor: https://everloot.app/database/vendors/{npcId}
- Zone: https://everloot.app/database/zones/{mapId}-{zone-name}, for example https://everloot.app/database/zones/1436-westfall
- Item category: https://everloot.app/database/items/{class}/{subclass}, for example https://everloot.app/database/items/trade-goods/cloth
- Talent calculator: https://everloot.app/tools/talents/{class}, for example https://everloot.app/tools/talents/mage
- MCP server card: https://everloot.app/.well-known/mcp/server-card.json (the registry's server.json)
Credit line for Everloot's own data: Data from Everloot (https://everloot.app), CC BY-SA 4.0.

## For AI assistants and developers
- [MCP server](https://everloot.app/mcp/public): the way for an AI assistant to answer a question from Everloot's data. Read-only, no sign-in, 200 requests per hour per IP. 32 tools: search_knowledge, get_entity, get_by_name, search, fetch, answer_sources, profession_path, recipe_thresholds, item_page, npc_page, object_page, quest_page, vendor_page, world_map_near, entity_relations, item_categories, talent_tree, talent_plan, class_races, collection_gap, completion_progress, guild_board, guild_search, guild_rankings, auction_history, market_value, gold_ledger, coverage, population, recent_changes, ecosystem_projects, everloot_plan. 3 resources, read whole: everloot://builds, everloot://methodology, everloot://data-policy. 3 prompts: answer_with_sources, review_talent_plan, what_changed.
- [Public corpus API](https://everloot.app/api/corpus/public): Raw anonymous addon observations in bulk, for developers building their own datasets; to answer a question, use the MCP server. Filter with ?kinds=npc_sighting,loot. Pages with ?offset= and ?limit=. Without a key: 30 requests per hour per IP, 500 records a page; a free key (https://everloot.app/docs/api/keys) lifts both. Credit: Data from Everloot (https://everloot.app), CC BY-SA 4.0.
- [Relations API](https://everloot.app/api/edges): Typed relations between items, NPCs, spells, professions and quests (dropped by, sold by, created by, reagent for, set, same icon, profession), paged, filterable by entity, relation and evidence. Player-observed rows need 3 installs; game-file rows are labelled found in game files, unconfirmed, with their build, and are Blizzard's, not under our licence. The whole game-file layer: /api/edges/client-layer.
- [Objects](https://everloot.app/database/objects): Chests, herbs, ore veins and fishing pools players looted, by the id in their GUID, with what came out of them; public after 3 install reports.
- [Items by category](https://everloot.app/database/items): Every item in the current build by class and subclass, with slot and quality filters, from the game files (found in game files, unconfirmed). As JSON: /api/items and /api/items/categories.
- [Bulk export](https://data.everloot.app/latest.json): the published data as files, one NDJSON file per dataset (corpus, drops, edges, items) with an index.json naming each file's rows, size, SHA-256, licence and the API response shape its rows follow. For the whole dataset, take this instead of paging the APIs.
- [Embeddable tooltips](https://everloot.app/tooltips.js): A script other sites load so links to Everloot item, NPC, quest and object pages show a hover card. Data from /api/tooltip/<type>/<id>.
- [OpenAPI document](https://everloot.app/api/openapi.json): OpenAPI 3.1 for every JSON endpoint, assembled from the same protocol the routes are tested against.
- [JSON Schema](https://everloot.app/schema/index.json): The protocol: one JSON Schema per upload record kind, the API response shapes (/schema/api/<name>.json) and the MCP tool inputs (/schema/mcp/<tool>.json).
- [MCP docs](https://everloot.app/docs/mcp): Setup for Claude Code and other MCP clients, and a page for every tool, with examples.
- [API reference](https://everloot.app/docs/api): Every endpoint with its parameters, answers and examples.
- [Changes feed (RSS)](https://everloot.app/changes/feed.xml): The newest 50 WoW: Forever builds and Blizzard posts.
- [News feed (RSS)](https://everloot.app/news/feed.xml): Everloot's own news posts, newest first.

## Docs
- [Overview: Overview](https://everloot.app/docs): What Everloot is and where to start, whether you play or build.
- [Overview: Quickstart](https://everloot.app/docs/quickstart): Three ways in: the website, the addon, or the open data.
- [Overview: How Everloot works](https://everloot.app/docs/how-it-works): From a loot window in game to a fact on the site: uploads, the 3-install rule, game files and spoilers.
- [Overview: Embeddable tooltips](https://everloot.app/docs/tooltips): One script tag, and your links to Everloot pages show a game-style card on hover.
- [Overview: Licence and credit](https://everloot.app/docs/licence): What you may do with Everloot's data and code, and the credit line to use.
- [Overview: FAQ](https://everloot.app/docs/faq): Short answers to the questions players and developers ask most.
- [Guides: Install the addon](https://everloot.app/docs/guides/addon): Get the Everloot addon into WoW: Forever and check it is running.
- [Guides: The Desktop App](https://everloot.app/docs/guides/desktop): The optional app that sends your addon data and brings prices back to the game.
- [Guides: Upload your data](https://everloot.app/docs/guides/upload): Share what you saw in game, in the browser or through the Desktop App.
- [Guides: Troubleshooting](https://everloot.app/docs/guides/troubleshooting): The addon will not load, a part is off, an upload is refused, or the API answers 429.
- [Guides: Find things on the site](https://everloot.app/docs/guides/find): Search, the database, zone pages, the world map and the tools.
- [Guides: Your account](https://everloot.app/docs/guides/account): Sign in, and manage your API keys.
- [Guides: Privacy and your data](https://everloot.app/docs/guides/privacy): What an upload carries, what is published, and how to take it back.
- [API Reference: API overview](https://everloot.app/docs/api): Base URL, keys, limits, errors, caching and the OpenAPI document.
- [API Reference: Limits and keys](https://everloot.app/docs/api/keys): How much you can read without a key, and how to get a free one.
- [API Reference: /corpus/public](https://everloot.app/docs/api/corpus-public): The public corpus: every public record players reported, without install ids
- [API Reference: /rollups/drops](https://everloot.app/docs/api/rollups-drops): Corroborated drop rates with loot-window counts
- [API Reference: /coverage/settled](https://everloot.app/docs/api/coverage-settled): The facts that are settled for one client build, so an uploader can skip repeating them
- [API Reference: /market/prices](https://everloot.app/docs/api/market-prices): Forever market values from full auction scans players started
- [API Reference: /items](https://everloot.app/docs/api/items): Every item of the current build with its class, subclass, slot and quality
- [API Reference: /items/categories](https://everloot.app/docs/api/items-categories): The item class and subclass tree of the current build, with the slot and quality slugs
- [API Reference: /edges](https://everloot.app/docs/api/edges): Typed relations between items, NPCs, spells, quests, zones and sets
- [API Reference: /edges/client-layer](https://everloot.app/docs/api/edges-client-layer): The whole game-file relation layer of the current build
- [API Reference: /tools/{tool}](https://everloot.app/docs/api/tools): One MCP tool's answer over plain HTTP
- [API Reference: /tooltip/{type}/{id}](https://everloot.app/docs/api/tooltip): The hover card for one item, NPC, quest or object page, for the embeddable tooltip script
- [API Reference: /intake](https://everloot.app/docs/api/intake): Upload records from an Everloot SavedVariables file
- [API Reference: /health](https://everloot.app/docs/api/health): Whether the public snapshot is fresh
- [API Reference: Schemas and the protocol](https://everloot.app/docs/api/schemas): Every response shape and record kind, and the protocol version.
- [API Reference: Data files](https://everloot.app/docs/api/data-files): Bulk downloads of the open data, and what they hold.
- [MCP: MCP overview](https://everloot.app/docs/mcp): Give an AI assistant Everloot's data, with the source on every answer.
- [MCP: Connect a client](https://everloot.app/docs/mcp/clients): Claude, ChatGPT, Grok, Claude Code and any client that speaks streamable HTTP.
- [MCP: Resources and prompts](https://everloot.app/docs/mcp/resources): The documents and ready-made prompts the server offers beside its tools.
- [MCP: search_knowledge](https://everloot.app/docs/mcp/tools/search-knowledge): Search the Everloot knowledge base
- [MCP: get_entity](https://everloot.app/docs/mcp/tools/get-entity): Get one knowledge record by id
- [MCP: get_by_name](https://everloot.app/docs/mcp/tools/get-by-name): Get records by exact name
- [MCP: answer_sources](https://everloot.app/docs/mcp/tools/answer-sources): Evidence for a question, each piece with its source
- [MCP: search](https://everloot.app/docs/mcp/tools/search): Search (ChatGPT connector contract)
- [MCP: fetch](https://everloot.app/docs/mcp/tools/fetch): Fetch one document (ChatGPT connector contract)
- [MCP: item_page](https://everloot.app/docs/mcp/tools/item-page): Item page for a drop
- [MCP: npc_page](https://everloot.app/docs/mcp/tools/npc-page): NPC page
- [MCP: object_page](https://everloot.app/docs/mcp/tools/object-page): Game object page
- [MCP: quest_page](https://everloot.app/docs/mcp/tools/quest-page): Quest page
- [MCP: vendor_page](https://everloot.app/docs/mcp/tools/vendor-page): Vendor page
- [MCP: entity_relations](https://everloot.app/docs/mcp/tools/entity-relations): How an item, NPC, spell or quest connects to others
- [MCP: item_categories](https://everloot.app/docs/mcp/tools/item-categories): Item categories: class, subclass, slot and quality
- [MCP: world_map_near](https://everloot.app/docs/mcp/tools/world-map-near): What is near a place on the map
- [MCP: talent_tree](https://everloot.app/docs/mcp/tools/talent-tree): Talent trees for one class
- [MCP: talent_plan](https://everloot.app/docs/mcp/tools/talent-plan): Read a talent share code
- [MCP: class_races](https://everloot.app/docs/mcp/tools/class-races): Races that can be a class, with their racial traits
- [MCP: profession_path](https://everloot.app/docs/mcp/tools/profession-path): Profession leveling path
- [MCP: recipe_thresholds](https://everloot.app/docs/mcp/tools/recipe-thresholds): Recipe skill ranges
- [MCP: market_value](https://everloot.app/docs/mcp/tools/market-value): Forever market value for one item
- [MCP: auction_history](https://everloot.app/docs/mcp/tools/auction-history): Auction history for one item
- [MCP: gold_ledger](https://everloot.app/docs/mcp/tools/gold-ledger): Gold ledger for one character
- [MCP: collection_gap](https://everloot.app/docs/mcp/tools/collection-gap): Owned versus missing in a collection
- [MCP: completion_progress](https://everloot.app/docs/mcp/tools/completion-progress): Achievement, reputation, title and quest progress
- [MCP: guild_board](https://everloot.app/docs/mcp/tools/guild-board): Guild board its officers published
- [MCP: guild_search](https://everloot.app/docs/mcp/tools/guild-search): Find a guild by the start of its name
- [MCP: guild_rankings](https://everloot.app/docs/mcp/tools/guild-rankings): Guild ladder for one raid or dungeon
- [MCP: coverage](https://everloot.app/docs/mcp/tools/coverage): Database coverage by zone, type and field
- [MCP: population](https://everloot.app/docs/mcp/tools/population): Who plays what: population by race, class, faction and level
- [MCP: recent_changes](https://everloot.app/docs/mcp/tools/recent-changes): Recent official changes for WoW: Forever
- [MCP: ecosystem_projects](https://everloot.app/docs/mcp/tools/ecosystem-projects): WoW: Forever addons and open-source projects
- [MCP: everloot_plan](https://everloot.app/docs/mcp/tools/everloot-plan): Everloot implementation tracker
- [Cookbook: All recipes](https://everloot.app/docs/cookbook): Short, tested walkthroughs for common jobs.
- [Cookbook: Tooltips on your site](https://everloot.app/docs/cookbook/tooltips-on-your-site): Add Everloot hover cards to a blog, guild site or forum theme.
- [Cookbook: Ask Claude about WoW: Forever](https://everloot.app/docs/cookbook/ask-claude): Connect Everloot to Claude and ask questions with sources.
- [Cookbook: Market prices in a script](https://everloot.app/docs/cookbook/prices-in-a-script): Read Forever market values from JavaScript or Python.
- [Cookbook: Drop rates to a spreadsheet](https://everloot.app/docs/cookbook/drop-rates-spreadsheet): Page through corroborated drop rates and save them as CSV.
- [Cookbook: MCP tools over plain HTTP](https://everloot.app/docs/cookbook/tools-over-http): Call any MCP tool with a GET request, no MCP client needed.

## Data limitations
- Everloot is a fan project. Not affiliated with or endorsed by Blizzard Entertainment.
- Data read from the game files is Blizzard's, not under Everloot's licence, and is labelled found in game files, unconfirmed until seen in play.
- A build's date on /changes is when Everloot first saw it, not when Blizzard shipped it.
- The level the second talent set unlocks (40) comes from the beta notes, not from the game files, and is unconfirmed.
- Public database facts appear only when enough install reports agree. Distinct addon install IDs are not proof of independent people.
- Loot-window observations are not verified kills and are not kill-based drop probabilities.
- No actual beta-client collection trial has been verified yet. Empty storage and unavailable storage are different states.
- No number, name or position is invented for an unknown entity. Farming routes and respawn optimization are planned, not built.
- The lore archive is a 2023 Warcraft Wiki snapshot and predates WoW: Forever.

## Full version
- [llms-full.txt](https://everloot.app/llms-full.txt): Everything in this file, plus what Everloot is, the launch date, the latest build, every MCP tool described and the licences.

Code AGPL-3.0, Everloot's own data CC BY-SA 4.0.