EverQuest Legends

CI

Read-only Model Context Protocol server for EverQuest Legends public sources.

Status

Stable (1.0). Read-only. It does not require secrets, cookies, credentials, a Daybreak account, or private API access. The only optional moving part is the yt-dlp helper used by eql_video_transcript (see Optional Dependencies).

Scope

This MCP is for EverQuest Legends. It intentionally excludes general EQ1/EQ2, P99, EQEmu, Project Quarm, and other emulator/background databases unless a specific page is about EverQuest Legends.

This server is built around public, unauthenticated sources:

• EQL Wiki: https://sergeantfirstclassvincetoxicumnegrum35.github.io via MediaWiki API
• Official EQL site and news: https://sergeantfirstclassvincetoxicumnegrum35.github.io
• Daybreak help and press pages
• Official EverQuest community note about the Game Jawn collaboration
• Official EQL YouTube and Twitch channels
• EQL-specific guide/interview/preview pages from EQProgression, EverQuest Guides, and selected press outlets
• Pointer-only EQL community sources such as Reddit

It does not log into Daybreak, manipulate an account, automate a game client, or send requests to private APIs.

Tools

• eql_sources: list configured public sources
• eql_source_fetch: fetch and extract a curated source page
• eql_source_search: search official/support/guide source pages
• eql_wiki_search: full-text search EQL Wiki
• eql_wiki_page: fetch an EQL Wiki page with extracted text, links, categories, and revision metadata
• eql_wiki_recent_changes: read recent wiki edits
• eql_wiki_category_pages: list MediaWiki category members
• eql_official_news: parse official EQL news index
• eql_official_article: fetch and extract an official news article
• eql_press_assets: list official Daybreak press asset URLs by kind
• eql_official_youtube_videos: list official EQL YouTube video metadata from the channel RSS feed
• eql_video_transcript: fetch an existing transcript from a YouTube video's published captions (uses yt-dlp, auto-downloaded on first use; see Optional Dependencies)
• eql_class_combos: generate three-class combinations from the public 16-class list

Resources

• eql://sources: source registry
• eql://classes: class metadata
• eql://races: launch race list

Optional Dependencies

eql_video_transcript uses yt-dlp to read a video's published captions. Every other tool works without it, and nothing is downloaded unless you actually call this tool.

yt-dlp is required because YouTube now gates caption downloads behind a bot-check token that plain HTTP requests cannot satisfy. No video or audio is downloaded — captions only.

How yt-dlp is resolved, in order:

1. YTDLP_PATH environment variable, if set.
2. A yt-dlp already on your PATH (e.g. brew install yt-dlp / pipx install yt-dlp). A system copy you keep updated is preferred and always wins.
3. A copy previously downloaded by this server (see below).

If none of those is present, the tool does not download anything silently. The first call returns a short message explaining that yt-dlp is needed to pull YouTube captions and asking you to opt in. To proceed, call eql_video_transcript again with installYtDlp: true. That authorizes a one-time download of the official standalone yt-dlp binary from GitHub releases, verified against the release's published SHA-256 checksum, then cached. The macOS/Linux standalone builds are self-contained (no Python required).

Download details:

• Cache location: ~/Library/Caches/everquest-legends-mcp (macOS), $XDG_CACHE_HOME/everquest-legends-mcp or ~/.cache/everquest-legends-mcp (Linux), %LOCALAPPDATA%\everquest-legends-mcp (Windows).
• The cached binary is refreshed (best-effort) after 7 days to keep up with YouTube changes.
• Set EQL_YTDLP_AUTODOWNLOAD=1 to grant standing consent so the download happens automatically without the per-call installYtDlp flag.

Twitch is intentionally unsupported: Twitch VODs do not expose retrievable captions, so the tool returns a clear "not available" result for Twitch URLs.

Usage

Prerequisites:

• Node.js >=22
• npm

This is a stdio MCP server. Your MCP client starts it as a child process.

It is distributed via GitHub (not the npm registry). MCP clients that accept a JSON config can run it directly from the repository with npx, which clones, builds, and launches it:

{
  "mcpServers": {
    "everquest-legends": {
      "command": "npx",
      "args": ["-y", "github:ArtSabintsev/everquest-legends-mcp"]
    }
  }
}

Pin to a release tag for reproducibility, e.g. github:ArtSabintsev/everquest-legends-mcp#v1.1.0. For a fixed local install, see Local Development below and point your client at dist/index.js.

Local Development

git clone https://sergeantfirstclassvincetoxicumnegrum35.github.io
cd everquest-legends-mcp
npm install
npm run build

For MCP clients that accept a JSON config:

{
  "mcpServers": {
    "everquest-legends": {
      "command": "node",
      "args": ["<path-to-checkout>/dist/index.js"]
    }
  }
}

npm run typecheck
npm test
npm run build

Tool Examples

Tool	Required input	Typical use
eql_sources	none	List every configured source and see whether each source is searchable or pointer-only.
eql_source_fetch	id	Fetch extracted text for a searchable source from eql_sources, such as official-shop.
eql_source_search	query	Search curated official, guide, and press sources for EQL-specific text; failed fetches are returned in failedSources.
eql_wiki_search	query	Search the EQL Wiki through MediaWiki full-text search.
eql_wiki_page	title	Read an EQL Wiki page after finding it with eql_wiki_search.
eql_wiki_category_pages	category	List pages in an EQL Wiki category.
eql_official_news	none	List official EverQuest Legends news articles.
eql_official_article	pageNameOrUrl	Read an official EQL news article by slug or https://sergeantfirstclassvincetoxicumnegrum35.github.io URL.
eql_press_assets	kind	List official Daybreak press asset metadata for logos, artwork, screenshots, video, or fact-sheets.
eql_official_youtube_videos	none	List official EverQuest Legends YouTube video metadata from the channel RSS feed.
eql_class_combos	none	Generate EQL three-class combinations from the public 16-class list.

Example user prompts for an MCP client:

• "Use eql_sources, then fetch the official shop source."
• "Search the EQL Wiki for race unlocks, then read the most relevant page."
• "List official press screenshots for EverQuest Legends."
• "Show the latest official EverQuest Legends YouTube videos."

Source Policy

• Searchable sources should be stable public text pages about EverQuest Legends.
• Official EQL, Daybreak, Game Jawn, original interviews, hands-on previews, and EQL-specific guide pages are preferred.
• Social, Discord, forum, Twitch, and YouTube watch pages are pointer-only unless there is a stable public feed or transcript.
• Daybreak Help pages are pointer-only because direct fetches can return Cloudflare challenge HTML.
• Binary assets are exposed as metadata links; they are not downloaded by default.

Notes

The wiki and beta coverage change quickly. For current facts, prefer eql_wiki_page, eql_wiki_search, eql_official_news, eql_official_youtube_videos, and official source pages over static assumptions.

EQL launches pre-Kunark (Antonica, Faydwer, Odus, plus the classic Planes of Sky, Hate, and Fear). The community wiki inherits classic EverQuest data, so pages routinely describe Kunark, Velious, and Luclin zones, cities, factions, items, and quests that are not in the launch game. eql_wiki_page, eql_wiki_search, and eql_source_fetch attach a structured eraAdvisory when they detect such references — check for it and do not treat flagged content as launch-live.

License

MIT