EverQuest MCP

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to EverQuest game data. Search across 12 online databases, lore/archive sources, and a local game data installation with 412 tools covering spells, items, NPCs, zones, quests, factions, achievements, overseer, mercenaries, lore, archives, and more.

Features

• 412 tools for querying EverQuest data
• Multi-source search — Query 12 online EQ databases, lore sources, and archive sources in parallel
• Local game data — Parse 70K+ spells, 1600+ factions, 2700+ AAs, 800+ overseer quests, and more directly from game files
• Deep spell analysis — Effects, categories, stacking, class comparisons, efficiency rankings, burst/sustained DPS, flexible multi-parameter queries
• Character data — Race/class info, skill caps, base stats, AC mitigation, deities, Drakkin heritages
• Creature encyclopedia — 980+ NPC/monster race types searchable by name
• Overseer system — Agents with archetypes/traits/jobs, quests with slot details and success/failure outcomes
• Zone maps — 34K+ points of interest from Brewall map files, zone search by name/level, teleport spell lookup
• Patch diff detection — Snapshot game data before a patch, then compare after to see exactly what changed
• Quest guides — Epic quest walkthroughs, leveling guides, farming guides

Data Sources

Local Game Data

The primary data source, powering 386 of the 412 tools. The server parses EverQuest game files directly to provide authoritative, offline access to the full game database:

• 70K+ spells with effects, classes, categories, stacking rules, and cast messages
• 1600+ factions with starting values by race, class, and deity
• 2700+ AA abilities with ranks, descriptions, and spell correlations
• 800+ overseer quests and 300+ agents with traits, jobs, and slot requirements
• 4200+ mercenary templates with stances, tiers, and abilities
• 34K+ map points of interest from Brewall map files
• 980+ creature/NPC race types, 550+ in-game events, 50+ lore stories
• Achievement system, skill caps, base stats, AC mitigation tables, and more

Data is parsed on demand and cached in memory. No external network calls required.

Online Databases, Lore, and Archives

External EQ community databases and historical lore/archive sources searched via web scraping, MediaWiki APIs, and bounded archive-search API calls. These provide quest guides, item databases, raid loot tables, original lore, and community-maintained or preserved content not available in local game files.

Installation

git clone https://github.com/ArtSabintsev/everquest1-mcp.git
cd everquest1-mcp
npm install
npm run build

Local Game Data (Optional)

For offline access to comprehensive game data, set the EQ_GAME_PATH environment variable to your EverQuest installation directory. On macOS with CrossOver:

{
  "mcpServers": {
    "everquest": {
      "command": "node",
      "args": ["/absolute/path/to/everquest1-mcp/dist/index.js"],
      "env": {
        "EQ_GAME_PATH": "/path/to/EverQuest"
      }
    }
  }
}

Without this, only online database tools are available.

Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "everquest": {
      "command": "node",
      "args": ["/absolute/path/to/everquest1-mcp/dist/index.js"]
    }
  }
}

Then restart Claude Desktop.

Available Tools (412)

Example Queries

Once configured, you can ask your AI assistant things like:

• "What does the spell Complete Heal do?"
• "Show me all Cleric resurrection spells"
• "What are the Wizard fire spells at level 65?"
• "Find all spells with a stun effect for Enchanter"
• "How do I start the bard epic 1.0 quest?"
• "What are the best leveling spots for level 70-80?"
• "Tell me about the faction Wolves of the North"
• "What overseer quests are available for plunder?"
• "Search EQArchives for Miragul"
• "Read the FVProject lore page Innoruuk (Lore)"
• "Show the official History of Norrath"
• "Show me map locations in Plane of Knowledge near the bank"
• "What AA abilities are available for Shaman?"
• "What are the most mana-efficient Wizard nukes?"
• "Compare burst damage between Wizard and Magician"
• "Which spells are exclusive to Bard?"

Development

npm run dev    # Build and run
npm run build  # Build only
npm run test   # Run tests
npm start      # Run built version

Architecture

src/
├── index.ts          # MCP server entry point
├── tools.ts          # Tool definitions and handlers (412 tools)
├── sources/          # Data source implementations
│   ├── base.ts       # Shared interfaces and fetch utilities
│   ├── index.ts      # Source aggregation
│   ├── localdata.ts  # Local EQ game file parser (40K+ lines)
│   ├── allakhazam.ts # Allakhazam scraper
│   ├── almars.ts     # Almar's Guides
│   ├── eqresource.ts # EQResource
│   ├── fanra.ts      # Fanra's Wiki (MediaWiki API)
│   ├── eqtraders.ts  # EQ Traders
│   ├── zliz.ts       # Zliz's Compendium
│   ├── lucy.ts       # Lucy spell/item database
│   ├── raidloot.ts   # RaidLoot raid drops
│   ├── eqinterface.ts # EQInterface UI mods
│   └── historiclore.ts # Official EQ history, FVProject lore, EQArchives
└── tests/            # Test suite
    └── tools.test.ts

Local Game Data Files Parsed

When EQ_GAME_PATH is set, the server parses these game files on demand:

Adding New Sources

1. Create a new file in src/sources/ implementing the EQDataSource interface
2. Export it from src/sources/index.ts
3. Add to the sources array for multi-source search
4. Optionally add source-specific tools in src/tools.ts

License

MIT