Connect

Every tool, with the arguments it takes. The same list, as JSON Schema, is at /schema/index.json and /schema/mcp/<tool>.json. Tools marked player data state a fact only once three installs agree, say when something is unrecorded, and end their answer with the age of the data and the credit line. The others carry their sources inside the answer. Every tool also returns structuredContent beside the text, of the shape in its schema file; the answer table under each tool lists its top-level fields. Answers built on player data start with connected and dataAsOf, and carry a page only when a corpus was read: an absent page is not a measured zero.

• search_knowledgeSearch the Everloot knowledge base

  Search WoW lore and Forever reference data. Exact-name matches rank first. Every hit carries its source and licence.

  Arguments of search_knowledge

  Parameter	Type	What it is
  queryrequired	string, up to 1000 characters	What to look up: names, questions, keywords. Question words are ignored.
  kind	one of: item, npc, object, quest, zone, spell, lore_page, creator, realm	Narrow to one record kind.
  version	one of: forever, classic, retail, lore	Narrow to one game version.
  limit	integer, 1 to 25, default 8

  Answer

  Answer of search_knowledge, as structuredContent

  Field	Type	What it is
  hitsrequired	array of objects

  Schema: /schema/mcp/search_knowledge.json

• get_entityGet one knowledge record by id

  Fetch the full record behind a search hit id, for page rendering.

  Arguments of get_entity

  Parameter	Type	What it is
  idrequired	integer, -9007199254740991 to 9007199254740991	Record id from a search_knowledge hit.

  Answer

  Answer of get_entity, as structuredContent

  Field	Type	What it is
  hitrequired	object, or null

  Schema: /schema/mcp/get_entity.json

• get_by_nameGet records by exact name

  Exact full-name match (case-insensitive) for disambiguation.

  Arguments of get_by_name

  Parameter	Type	What it is
  namerequired	string, up to 200 characters	Full record name.
  kind	one of: item, npc, object, quest, zone, spell, lore_page, creator, realm	Narrow to one record kind.

  Answer

  Answer of get_by_name, as structuredContent

  Field	Type	What it is
  hitsrequired	array of objects

  Schema: /schema/mcp/get_by_name.json

• searchSearch (ChatGPT connector contract)

  The same search as search_knowledge, in the shape ChatGPT connectors and deep research call by name: up to 10 results, each with an id for fetch, a title and a URL to cite. The text block is the same JSON as a string.

  Arguments of search

  Parameter	Type	What it is
  queryrequired	string, up to 1000 characters	What to look up: names, questions, keywords. Question words are ignored.

  Answer

  Answer of search, as structuredContent

  Field	Type	What it is
  resultsrequired	array of objects

  Schema: /schema/mcp/search.json

• fetchFetch one document (ChatGPT connector contract)

  One knowledge record by the id a search result gave, whole: title, the full text in the source's words, the URL to cite, and metadata with the source, licence and date. The text block is the same JSON as a string.

  Arguments of fetch

  Parameter	Type	What it is
  idrequired	string, up to 20 characters	An id from a search result.

  Answer

  Answer of fetch, as structuredContent

  Field	Type	What it is
  idrequired	string	The record id as a string.
  titlerequired	string	The record's name.
  textrequired	string	The whole record, in the source's words.
  urlrequired	string	Where the record is read, as in search.
  metadatarequired	object

  Schema: /schema/mcp/fetch.json

• answer_sourcesplayer dataEvidence for a question, each piece with its source

  The evidence behind a question about WoW: Forever, for an answer that cites its sources: facts players observed (public after three installs agree, with the install count), curated facts, and the 2023 Warcraft Wiki (marked: may differ in Forever). Every piece carries a claim, its source URL, licence and date. Returns evidence rather than prose. Further-reading links are search URLs on other sites; nothing is fetched from them. Reads Everloot's current authorized public corpus when connected; when it is not, the observed layer is unrecorded, not empty.

  Arguments of answer_sources

  Parameter	Type	What it is
  questionrequired	string, up to 500 characters	The question, with names spelled as in the game.
  limit	integer, 1 to 25, default 8	Most lore and curated pieces.

  Answer

  Answer of answer_sources, as structuredContent

  Field	Type	What it is
  evidencerequired	array of objects	Observed first, then curated, then lore.
  furtherReadingrequired	array of objects	Search links on other sites. Nothing was fetched.
  dataAsOfrequired	string, or null	When the observed layer was current; null when it is not connected.

  Schema: /schema/mcp/answer_sources.json

• profession_pathplayer dataProfession leveling path

  Leveling path for one Forever profession from Everloot uploads. A step exists only after 3 installs agree: on a reported recipe, or on the recipe colours that make it orange (a guaranteed skill-up), starting at the trainer's required rank. Gold exists only after 3 price uploads agree. No copied guide. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of profession_path

  Parameter	Type	What it is
  professionrequired	string	Profession name, such as Alchemy.
  fromSkill	integer, 1 to 500, default 1	Skill the character has now.
  toSkillrequired	integer, 1 to 500	Skill to stop at. Must be above fromSkill.

  Answer

  Answer of profession_path, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/profession_path.json

• recipe_thresholdsplayer dataRecipe skill ranges

  Where a Forever profession's recipes turn yellow, green and grey, inferred from the colours players' trade-skill windows showed. A recipe appears only after 3 installs agree, as ranges, never guessed exact numbers. Agreed reagents come with an estimated cost per craft when every reagent has an agreed price. Reads Everloot's current public corpus.

  Arguments of recipe_thresholds

  Parameter	Type	What it is
  professionrequired	string	Profession name, such as Alchemy.
  recipe	string	Optional part of a recipe name to narrow the list.

  Answer

  Answer of recipe_thresholds, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/recipe_thresholds.json

• item_pageplayer dataItem page for a drop

  One Forever item: agreed name, public drop rate with kill count, and an agreed map pin. A rate is public after 3 installs kill the source. A name or pin needs 3 installs agreeing. No Wowhead rows. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of item_page

  Parameter	Type	What it is
  itemIdrequired	integer, 1 to 9007199254740991	Item id from a drop row.

  Answer

  Answer of item_page, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/item_page.json

• npc_pageplayer dataNPC page

  One Forever NPC: agreed name and map pins. A name or pin needs 3 installs agreeing. The pin does not require a drop. No copied spawn list. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of npc_page

  Parameter	Type	What it is
  npcIdrequired	integer, 1 to 9007199254740991	NPC id.

  Answer

  Answer of npc_page, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/npc_page.json

• object_pageplayer dataGame object page

  One game object (a chest, herb, ore vein or fishing pool) by the id in its GUID: the items players looted from it, each with observed loot windows, windows with the item and distinct install reports. A frequency is public after 3 install reports; a public object with nothing in its windows reads as a measured zero. Objects have no names yet. Reads Everloot's current authorized public corpus when connected.

  Arguments of object_page

  Parameter	Type	What it is
  objectIdrequired	integer, 1 to 9007199254740991	The object's entry id, as in /database/objects/1731.

  Answer

  Answer of object_page, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/object_page.json

• quest_pageplayer dataQuest page

  One Forever quest: agreed title, level, giver, turn-in, and rewards. Each fact needs 3 installs agreeing. No copied quest text. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of quest_page

  Parameter	Type	What it is
  questIdrequired	integer, 1 to 9007199254740991	Quest id.

  Answer

  Answer of quest_page, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/quest_page.json

• vendor_pageplayer dataVendor page

  Goods one Forever vendor sells. An item is listed when 3 installs agree on that item and its copper price. Two agreed prices both stay listed. No copied catalog. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of vendor_page

  Parameter	Type	What it is
  vendorNpcIdrequired	integer, 1 to 9007199254740991	Vendor NPC id.

  Answer

  Answer of vendor_page, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/vendor_page.json

• world_map_nearplayer dataWhat is near a place on the map

  Entrances, NPCs and vendors near a spot, nearest first, with straight-line distances in yards. Give a zone (name or map id) with x and y from 0 to 100, or an NPC id to start from where that NPC stands. Entrances come from the game files and are unconfirmed. NPCs and vendors are player-observed and listed only where 3 installs agree on the position. Zones the files hold back as possibly unreleased are not offered. Game objects are not listed: no public record gives them a position. Reads Everloot's current authorized public corpus when connected.

  Arguments of world_map_near

  Parameter	Type	What it is
  zone	string, up to 80 characters	Zone name or map id, such as Elwynn Forest or 1429. Needs x and y.
  x	number, 0 to 100	Across the zone map, 0 (west) to 100 (east).
  y	number, 0 to 100	Down the zone map, 0 (north) to 100 (south).
  npcId	integer, 1 to 9007199254740991	Start from this NPC's agreed position instead of a zone and x, y.
  radius	number, above 0, up to 5000, default 500	Search radius in yards.
  limit	integer, 1 to 20, default 5	Most results per list.

  Answer

  Answer of world_map_near, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/world_map_near.json

• entity_relationsplayer dataHow an item, NPC, spell or quest connects to others

  Every typed relation of one entity, both directions: dropped by, sold by, reward from, located in (player-observed, listed where 3 installs agree, with the install count and last seen), and created by, reagent for, part of set, same icon (found in game files, unconfirmed, with the build they came from). Ids are the game's own. Reads Everloot's current authorized public corpus and the committed client layer.

  Arguments of entity_relations

  Parameter	Type	What it is
  kindrequired	one of: item, spell, npc, object, quest, zone, item_set, icon, skill	What the id names. A zone is a UiMap id, as on /map.
  idrequired	integer, 1 to 9007199254740991	The game's id for it, such as item 19019.
  rel	one of: dropped_by, sold_by, reward_from, located_in, created_by, reagent_for, part_of_set, same_icon, in_skill_line	Only this relation.
  direction	one of: from, to, both	from: what this entity points to (an item's sources). to: what points at it (what an NPC drops). Default both.
  limit	integer, 1 to 100, default 25	Most lines per relation.

  Answer

  Answer of entity_relations, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/entity_relations.json

• item_categoriesItem categories: class, subclass, slot and quality

  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).

  Arguments of item_categories

  Parameter	Type	What it is
  item	integer, 1 to 9007199254740991	An item id: answers its class, subclass, slot and quality.
  class	string, up to 40 characters	Class slug, such as weapon, armor, consumable or trade-goods.
  subclass	string, up to 40 characters	Subclass slug or number within the class, such as one-handed-swords or cloth.
  slot	string, up to 40 characters	Slot slug, such as head, chest, one-hand or trinket.
  quality	one of: poor, common, uncommon, rare, epic, legendary, artifact, heirloom	poor, common, uncommon, rare, epic, legendary, artifact or heirloom.
  limit	integer, 1 to 100, default 25	Most items listed.

  Answer

  Answer of item_categories, as structuredContent

  Field	Type	What it is
  labelrequired	string
  buildrequired	string
  item	object, or null	With item: its path, or null when the item is not in the build.
  classes	array of objects	With no arguments: the whole tree, classes with items only.
  items	array of objects	With class: the items in the category, up to limit.
  total	integer, -9007199254740991 to 9007199254740991	With class: how many items match, listed or not.
  error	string	A class or subclass that is not in the build.
  creditrequired	string

  Schema: /schema/mcp/item_categories.json

• talent_treeTalent trees for one class

  The WoW: Forever talent trees of one class from the game files (found in game files, unconfirmed, with the build): every node with its talents, ranks, grid position, prerequisites and row gate, plus the levels talent points arrive at. Node ids are the ids a share code names. Narrow to one tree by name. The calculator is at /tools/talents/<class>.

  Arguments of talent_tree

  Parameter	Type	What it is
  classrequired	one of: warrior, paladin, hunter, rogue, priest, shaman, mage, warlock, druid	Class slug.
  tree	string, up to 40 characters	One tree by name, such as Arcane. Without it, every tree.

  Answer

  Answer of talent_tree, as structuredContent

  Field	Type	What it is
  labelrequired	string
  buildrequired	string	The game build the trees were read from.
  classrequired	one of: warrior, paladin, hunter, rogue, priest, shaman, mage, warlock, druid
  classNamerequired	string
  specIdrequired	integer, -9007199254740991 to 9007199254740991	The client's spec id, or 0 when unknown.
  pointsrequired	object
  treesrequired	array of objects
  nodesrequired	array of objects
  creditrequired	string

  Schema: /schema/mcp/talent_tree.json

• talent_planRead a talent share code

  Decodes an Everloot talent share code (EL1-<class>-<spec>-<build>-<payload>, or a calculator link carrying one after #plan=) against the class's trees: the talents and ranks it holds, points per tree, the lowest level that can hold it, and every problem in plain words: a code made on another build, nodes the tree does not have, ranks cut back, points the rules would not place. Nothing is dropped silently. Game-file data, found in game files, unconfirmed.

  Arguments of talent_plan

  Parameter	Type	What it is
  coderequired	string, up to 2000 characters	The share code, or a link that carries one.

  Answer

  Answer of talent_plan, as structuredContent

  Field	Type	What it is
  okrequired	boolean	False when the code could not be read at all; message says why.
  message	string
  class	one of: warrior, paladin, hunter, rogue, priest, shaman, mage, warlock, druid
  className	string
  codeBuild	string	The game build the code was made on.
  treeBuild	string	The build of the trees it was read against.
  pointsSpent	integer, -9007199254740991 to 9007199254740991
  minLevel	integer, -9007199254740991 to 9007199254740991	The lowest level that can hold this many points.
  byTree	array of objects
  talents	array of objects
  problems	array of string	One sentence each. Empty means the code loaded exactly as made.
  link	string	The calculator with this plan loaded.
  labelrequired	string
  creditrequired	string

  Schema: /schema/mcp/talent_plan.json

• collection_gapplayer dataOwned versus missing in a collection

  Missing items in one collection for one install. A list row is public after 3 installs agree on the collection, the source, and the item. Owned is what that install uploaded. Not a Blizzard profile read and not a copied catalog. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of collection_gap

  Parameter	Type	What it is
  collectionrequired	string	Collection name, such as Mounts.
  ownerInstallIdrequired	string	Install id whose owned upload to compare.

  Answer

  Answer of collection_gap, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/collection_gap.json

• completion_progressplayer dataAchievement, reputation, title and quest progress

  What one install's characters have finished, and what is closest to done: achievements with the largest share of criteria or progress met, reputations nearest the next standing, titles known, and quests finished in a chain. A list entry is public after 3 players (installs uploading from different addresses) report it identically. Progress is shown only when that install uploaded it with the collection sharing choice and a verified grant; without it the answer says so. Not a Blizzard profile read and not a copied catalog. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of completion_progress

  Parameter	Type	What it is
  ownerInstallIdrequired	string	Install id whose completion upload to read.
  characterKey	string, up to 8 characters	One character's 8-digit key from the upload, when the install has several.

  Answer

  Answer of completion_progress, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/completion_progress.json

• guild_boardplayer dataOfficer guild board

  Roster, bosses, loot, attendance, and average item level from officer uploads. A figure is public after 2 uploads agree. The average names how many roster members were measured. There is no single score because score_v1 weights are not published. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of guild_board

  Parameter	Type	What it is
  guildNamerequired	string	Guild name.
  realmrequired	string	Realm name.

  Answer

  Answer of guild_board, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/guild_board.json

• auction_historyplayer dataAuction history for one item

  Price history from auction scans players uploaded on purpose. A day is public after 3 installs scanned that item on that realm. Copper is the median. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of auction_history

  Parameter	Type	What it is
  realmrequired	string	Realm name.
  itemIdrequired	integer, 1 to 9007199254740991	Item id.

  Answer

  Answer of auction_history, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/auction_history.json

• market_valueplayer dataForever market value for one item

  Market value, minimum buyout, historical value and units listed for one item on one WoW: Forever realm, from full auction scans players started and uploaded. A day is public after 3 reporters (distinct upload addresses) scanned the item; values are medians, thin days and outlier days are left out of the market value. Market value weights the last 14 public days, historical is the median of 60. Missing or unavailable data is reported explicitly.

  Arguments of market_value

  Parameter	Type	What it is
  realmrequired	string	Realm name.
  itemIdrequired	integer, 1 to 9007199254740991	Item id.

  Answer

  Answer of market_value, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/market_value.json

• gold_ledgerplayer dataGold ledger for one character

  Peak gold and the money events that character's own upload recorded. Loot, quests, vendors, and auction sales stay on the money line. Gameplay stays on its own line. A missing line is unrecorded. The difference is not called bought and is not a ban. Installs are not merged. No scan of a player who did not upload. Reads Everloot's current authorized public corpus when connected. Missing or unavailable data is reported explicitly.

  Arguments of gold_ledger

  Parameter	Type	What it is
  characterrequired	string	Character name.
  realmrequired	string	Realm name.

  Answer

  Answer of gold_ledger, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/gold_ledger.json

• populationplayer dataWho plays what: population by race, class, faction and level

  How many characters play each race, class, race and class, faction and level band on WoW: Forever, from the census of players who turned it on in the Everloot addon. Each character counts once. A count shows only when it covers at least 10 characters reported by at least 3 installs from at least 3 addresses, rounded to the nearest 5, and a count that could be worked out from the others is hidden too. Every answer states its window: active in the last 7 days (default) or since launch. With no arguments, the overview: most played class first. No names, ever. Missing or unavailable data is reported explicitly.

  Arguments of population

  Parameter	Type	What it is
  race	string, up to 40 characters	A race, such as Gnome, Night Elf or Undead.
  class	string, up to 40 characters	A class, such as Priest.
  faction	one of: Alliance, Horde	Alliance or Horde.
  window	one of: week, launch	week: active in the last 7 days. launch: seen since launch.

  Answer

  Answer of population, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when no corpus was read; the page is then absent, which is not a measured zero.
  dataAsOfrequired	string, or null	The corpus snapshot time, or null when unrecorded.
  reason	string	Why nothing was read, when connected is false.
  page	object

  Schema: /schema/mcp/population.json

• recent_changesRecent official changes for WoW: Forever

  Newest first: Blizzard blue posts (title, author, time, a short excerpt and the link to the original), hotfix posts, and new game builds. Excerpts only: Blizzard's post text is Blizzard's; full posts are available at their source URLs. A build's time is when Everloot first saw it, not Blizzard's release time.

  Arguments of recent_changes

  Parameter	Type	What it is
  filter	one of: all, posts, hotfixes, builds	posts (blue posts), hotfixes, builds, or all.
  game	one of: forever, classic	Narrow to one game.
  limit	integer, 1 to 25, default 10

  Answer

  Answer of recent_changes, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when the timeline is not connected: the list is then not a measured zero.
  entriesrequired	array of objects

  Schema: /schema/mcp/recent_changes.json

• ecosystem_projectsWoW: Forever addons and open-source projects

  Forever addons and tools from the community registry, with a board ranking: most installed, rising, most active, freshest release or best maintained. Each project shows its GitHub repository, stars, latest release, last commit, whether its .toc declares a Forever interface number, and installs from Everloot uploads (counted from 3 installs; a missing count means not counted, not zero). Projects are ranked, never people. GitHub facts carry the time they were refreshed.

  Arguments of ecosystem_projects

  Parameter	Type	What it is
  board	one of: all, installed, rising, active, release, maintained	installed, rising, active, release, maintained, or all (A to Z).
  forever_ready_only	boolean	Only projects whose .toc lists a Forever interface number.
  limit	integer, 1 to 25, default 10

  Answer

  Answer of ecosystem_projects, as structuredContent

  Field	Type	What it is
  connectedrequired	boolean	False when the tracker is not connected: the list is then not a measured zero.
  refreshedAtrequired	string, or null	When the GitHub facts were last refreshed.
  installsAvailablerequired	boolean	False when install counts could not be read: a null count then means unknown.
  foreverrequired	object, or null	What Forever-ready compares each .toc with, derived from the build's version and not yet confirmed in the client.
  boardrequired	one of: all, installed, rising, active, release, maintained
  projectsrequired	array of objects

  Schema: /schema/mcp/ecosystem_projects.json

• everloot_planEverloot implementation tracker

  The Everloot feature catalogue: what is live, what is next, what is waiting, and which reference sites are page shapes only.

  No parameters.

  Answer

  Answer of everloot_plan, as structuredContent

  Field	Type	What it is
  rowsrequired	array of objects	Every row, in the tracker's order.
  countsrequired	object

  Schema: /schema/mcp/everloot_plan.json

Every JSON endpoint. The machine-readable description is /api/openapi.json (OpenAPI 3.1), and each response shape is a JSON Schema file under /schema/api/. Load the OpenAPI file into any client generator or API tool to get typed calls. Every answer says which layer it comes from: facts players observed carry the licence and credit; facts read from the game files carry a gameData notice and their build instead.

• GET /corpus/publicThe public corpus: every public record players reported, without install ids

  Anonymous observations as records, so anyone can check the counts behind a published fact. `kinds` narrows the body to the record kinds a reader needs. Named records appear only with a grant.

  Access

  per-IP limit, or a free key

  Data

  observed in play

  Paged

  yes: offset, limit, next

  Responses

  200 The page of records. Shape: corpusPublicResponse.400 A parameter is wrong; `error` says which. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/corpus/public

  Parameter	Type	What it is
  kinds	string	Comma-separated record kinds to include. Unknown kinds are a 400.
  offset	integer, 0 or more	First row to return, 0 or more.
  limit	integer, 1 or more	Rows per page. Capped at the caller's page size when the data guard is on.

• GET /rollups/dropsCorroborated drop rates with loot-window counts

  A rate is public once three installs looted its source. Rates come first, then sources looted with nothing in their windows (measured zeros). `kills` counts loot windows players opened, not kills.

  Access

  per-IP limit, or a free key

  Data

  observed in play

  Paged

  yes: offset, limit, next

  Responses

  200 The page of rates and zeros. Shape: dropsResponse.400 A parameter is wrong; `error` says which. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/rollups/drops

  Parameter	Type	What it is
  offset	integer, 0 or more	First row to return, 0 or more.
  limit	integer, 1 or more	Rows per page. Capped at the caller's page size when the data guard is on.

• GET /edgesTyped relations between items, NPCs, spells, quests, zones and sets

  Observed edges (dropped by, sold by, reward from, located in) come first and carry install counts; game-file edges (created by, reagent for, part of set, same icon) follow and carry the build. With no filter the whole table pages like the corpus.

  Access

  per-IP limit, or a free key

  Data

  both, labelled per row

  Paged

  yes: offset, limit, next

  Responses

  200 The page of edges. Shape: edgesResponse.400 A parameter is wrong; `error` says which. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/edges

  Parameter	Type	What it is
  from_kind	one of: item, spell, npc, object, quest, zone, item_set, icon, skill	Kind of the entity the edge starts from.
  from_id	integer, 1 or more	The game's id of that entity.
  to_kind	one of: item, spell, npc, object, quest, zone, item_set, icon, skill	Kind of the entity the edge points to.
  to_id	integer, 1 or more	The game's id of that entity.
  rel	one of: dropped_by, sold_by, reward_from, located_in, created_by, reagent_for, part_of_set, same_icon, in_skill_line	Only this relation.
  evidence	one of: observed, client	observed (players) or client (game files).
  offset	integer, 0 or more	First row to return, 0 or more.
  limit	integer, 1 or more	Rows per page. Capped at the caller's page size when the data guard is on.

• GET /edges/client-layerThe whole game-file relation layer of the current build

  The committed client layer as one object: Blizzard's data, found in game files, unconfirmed. Public in the repository too, so it is neither paged nor limited. Cached for an hour.

  Access

  open

  Data

  in game files, unconfirmed

  Paged

  no

  Responses

  200 The client layer file.

  No parameters.

• GET /itemsEvery item of the current build with its class, subclass, slot and quality

  From the game files. Filters by one item id, or by class and subclass slugs, slot and quality. Ids only: item names come from player uploads.

  Access

  per-IP limit, or a free key

  Data

  in game files, unconfirmed

  Paged

  yes: offset, limit, next

  Responses

  200 The page of items. Shape: itemsResponse.400 A parameter is wrong; `error` says which. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/items

  Parameter	Type	What it is
  item	integer, 1 or more	One item id.
  class	string	Class slug, such as weapon or armor.
  subclass	string	Subclass slug or number within the class. Needs class.
  slot	string	Slot slug, such as head or trinket.
  quality	one of: poor, common, uncommon, rare, epic, legendary, artifact, heirloom	Quality slug.
  offset	integer, 0 or more	First row to return, 0 or more.
  limit	integer, 1 or more	Rows per page. Capped at the caller's page size when the data guard is on.

• GET /items/categoriesThe item class and subclass tree of the current build, with the slot and quality slugs

  Every class with its subclasses, each with the slug `/api/items` takes and the number of items in the build, plus the slot and quality slugs. From the game files. Public in the repository too, so it is neither paged nor limited. Cached for an hour.

  Access

  open

  Data

  in game files, unconfirmed

  Paged

  no

  Responses

  200 The tree. Shape: itemCategoriesResponse.

  No parameters.

• GET /market/pricesForever market values from full auction scans players started

  Without `realm`, the realms that have public values. With it, the items with the most units listed on that realm as tuples in `fields` order, copper per unit. A day is public when three reporters scanned the item.

  Access

  per-IP limit

  Data

  observed in play

  Paged

  no

  Responses

  200 Realms when `realm` is absent (marketRealmsResponse), prices when present. Shape: marketPricesResponse.400 A parameter is wrong; `error` says which. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/market/prices

  Parameter	Type	What it is
  realm	string, 2 to 40 characters	Realm name. Omit it to list realms.

• POST /intakeUpload records from an Everloot SavedVariables file

  One envelope of at most 2,000 records and 1 MB. Every record is checked against its kind's schema; the receipt lists what was accepted and what was rejected and why. Named categories need the matching sharing choice and a verified grant. Anonymous, keyed by a random install id; quotas per request and per install.

  Access

  per-IP limit

  Data

  no data

  Paged

  no

  Responses

  200 Stored. Shape: intakeReceipt.400 The body is not JSON, or the grants are malformed. Shape: intakeRefused.413 The body is over 1 MB. Shape: intakeRefused.422 The envelope or every record was refused; the receipt says why. Shape: intakeRefused.429 Rate limited; keep the file and retry after `Retry-After`. Shape: intakeRefused.503 Storage could not confirm the write; keep the file and retry. Shape: intakeRefused.

  Body

  intakeRequest

  No parameters.

• GET /tools/{tool}One MCP tool's answer over plain HTTP

  Every tool of the MCP server, callable with a GET: the tool's arguments go in the query string (numbers and booleans as plain text), named and typed as in /schema/mcp/{tool}.json. The answer is the tool's structured content, with the same text an MCP client gets. A wrong argument is a 400 that says which; an unknown tool is a 404 that lists the tools. Answers built on player uploads say how old the data is and carry the credit line; game-file answers are labelled unconfirmed with their build.

  Access

  per-IP limit, or a free key

  Data

  both, labelled per row

  Paged

  no

  Responses

  200 The tool's answer. Shape: toolAnswerResponse.400 A parameter is wrong; `error` says which. Shape: apiError.404 No such tool; `error` lists them. Shape: apiError.429 Rate limited. `Retry-After` says when to try again. Shape: apiError.503 A dependency is unavailable. The answer is unrecorded, not zero. Shape: apiError.

  Parameters of /api/tools/{tool}

  Parameter	Type	What it is
  {tool}required	one of: 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, collection_gap, completion_progress, guild_board, auction_history, market_value, gold_ledger, population, recent_changes, ecosystem_projects, everloot_plan	A tool name from the MCP tool list.

• GET /healthWhether the public snapshot is fresh

  200 when the corpus snapshot was written recently, 503 otherwise. Metadata only.

  Access

  open

  Data

  no data

  Paged

  no

  Responses

  200 Fresh. Shape: healthResponse.503 Stale, missing or unavailable. Shape: healthResponse.

  No parameters.

The contract behind all of this is one package, @everloot/protocol, version 1.1.0: the 33 record kinds the addon writes, the upload envelope and limits, the 17 response shapes above and the tool table. The site validates uploads with it, the MCP server registers its tools from it, and this page is rendered from it.

• https://everloot.app/schema/index.json: what is published, with the protocol version.
• /schema/records/<kind>.json: one JSON Schema (draft 2020-12) per record kind, with the rules the server checks that a schema cannot express written into the description.
• /schema/upload.json and /schema/limits.json: the upload envelope and its sizes (at most 2,000 records and 1 MB per request).
• /schema/api/<name>.json and /schema/mcp/<tool>.json: the response shapes and the tool inputs.
• The source and its changelog: packages/protocol. Semver: a new kind, field or tool is a minor release; a removal, a rename, a new required field or a tighter limit is a major release, and the server accepts the current major and the one before it.