Skip to main content
Glama

eve-mentor-mcp

An MCP server that turns Claude into an EVE Online mentor for players trying to learn the game.

EVE has the steepest learning cliff in gaming. Existing tools assume you already know what to ask. This one is built around the questions new players actually have:

  • "Why do I keep getting blown up?" — pulls your real losses from zKillboard with the full fit you were flying, who killed you, and with what, so Claude can explain exactly what went wrong.

  • "Is this system dangerous?" — live kill and traffic data for any system.

  • "What is this thing and what does it cost?" — any ship or module, with live Jita prices.

  • "What should I do next?" — log in with EVE SSO and Claude sees your skills, skill queue, wallet, location, and current ship, and can coach from your actual situation.

Works with Claude Desktop, Claude Code, and any MCP client.

Tools

Tool

Auth

What it does

recent_losses

none

A character's recent losses with full fit detail (zKillboard + ESI)

can_i_fly

optional

Full recursive skill prerequisite tree + ordered training plan for any ship/module; diffed against your real skills when logged in

fit_readiness

optional

Paste an EFT fit → can-fly verdict: missing skills to online every module, in training order, with total time

proven_fits

none

What pilots actually fly on a ship — the most common modules per slot, learned from recent killmails

analyze_fit

none

Mechanical fit check: classifies modules and flags classic mistakes (mixed weapons/tank, no propulsion, dead damage mods)

ammo_advisor

none

Which damage type to shoot and tank against a faction or enemy tank, with concrete ammo names

career_test

none

The EVE career "sorting hat" — Claude interviews you, then matches you to playstyles

isk_guidance

none

Viable income activities by skillpoint tier, with honest ISK/hr ranges and first steps

what_should_i_do_tonight

SSO

Composes your real skills/wallet/location/ship into concrete session suggestions

remember_goal

optional

Save a goal the player states, so it persists across sessions (per character)

recall_pilot_notes

optional

The goals you previously saved, oldest first

system_intel

none

Security status + kills/jumps in the last hour for any system

route_danger

optional

Per-jump security + last-hour kills + named gank chokepoints between two systems

where_to_buy

optional

An item's cheapest of the 5 trade hubs, with jumps from where you are

whats_happening

none

Returning-player briefing: server status, incursions, biggest recent kills, patch-notes link

evaluate_corp

none

Newbie-friendliness signals for a corp (size/age/war/activity) + what to ask

lookup_item

none

Item/ship/module description + live Jita buy/sell prices

cheapest_way_to_play

none

Alpha vs Omega vs PLEX economics with today's live Jita PLEX price

jargon

none

EVE slang glossary — define a term or list everything known

sitrep

optional

One-call session-start orientation: login state, character overview, what's training, last loss

eve_login

—

Browser-based EVE SSO login (OAuth2 PKCE, no secret stored)

eve_auth_status

—

Who's logged in

character_sheet

SSO

Skillpoints, wallet, location, current ship

skill_queue

SSO

What's training and when it finishes

top_skills

SSO

Highest-trained skills

my_assets

SSO

Everything you own grouped by location, flagging stranded/asset-safety items

Related MCP server: EVE Online Companion MCP Server

Install (no coding required)

You need two things: the Claude Desktop app (or Claude Code) and Node.js, a free runtime that this server runs on — installing it is like installing any other app.

Step 1 — Install Node.js (skip if you have it)

Go to nodejs.org, download the LTS version, run the installer, click through with the defaults. Done.

Step 2 — Tell Claude about it (no download needed)

Claude Desktop: open the config file in any text editor —

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

(If it doesn't exist, create it.) Make it look like this:

{
  "mcpServers": {
    "eve-mentor": {
      "command": "npx",
      "args": ["-y", "eve-mentor-mcp"]
    }
  }
}

Save, then fully quit and reopen Claude Desktop. That's it — npx downloads and runs the server automatically; updates come free.

Claude Code (one line instead):

claude mcp add eve-mentor -- npx -y eve-mentor-mcp
git clone https://github.com/henryjrobinson/eve-mentor-mcp
cd eve-mentor-mcp
npm install && npm run build

Then point your MCP client at node /FULL/PATH/TO/eve-mentor-mcp/dist/index.js.

Step 3 — Test it

Ask Claude: "Pull the last 3 losses for character <any EVE character name> and explain what went wrong." If it answers with real killmail data, you're live. No EVE login is needed for this — losses, system intel, prices, the career test, and the jargon glossary all work immediately.

Other AI apps

Any MCP-capable client works the same way (Cursor, LM Studio, VS Code, etc. — point them at node /path/dist/index.js). ChatGPT supports MCP but only remote servers, not local ones — a hosted version of the public tools is on the roadmap.

Character tools (EVE SSO)

  1. Go to developers.eveonline.com → log in with your EVE account → Create New Application

  2. Name it anything (e.g. eve-mentor), pick Authentication & API Access

  3. Select these scopes:

    • esi-skills.read_skills.v1

    • esi-skills.read_skillqueue.v1

    • esi-location.read_location.v1

    • esi-location.read_ship_type.v1

    • esi-wallet.read_character_wallet.v1

    • esi-assets.read_assets.v1

  4. Set the callback URL to exactly https://ruby-eve.com/callback — CCP's portal only accepts https callbacks; this static page (source in site/callback/) relays the login code to the local server on port 8484. (Self-hosting? Serve your own copy and set EVE_REDIRECT_URI.)

  5. Copy the Client ID and add it to the server's environment:

claude mcp add eve-mentor -e EVE_CLIENT_ID=your_client_id -- npx -y eve-mentor-mcp

(or add "env": {"EVE_CLIENT_ID": "your_client_id"} to the Claude Desktop config.)

Then ask Claude to log you in to EVE — a browser opens, you authorize, done. Tokens are stored in ~/.config/eve-mentor/tokens.json (mode 600) and refresh automatically.

Try it

"Pull my last 3 losses for character Your Pilot Name and explain what I did wrong in each one."

"I'm about to fly through Tama. How dangerous is it right now?"

"What should I be training next given my skills and the fact that I want to try small-gang PvP?"

Verify it works

npm run smoke                      # tests ESI name resolution, market, system intel
npm run smoke -- "Pilot Name"      # also tests the zKillboard loss pipeline

Notes

  • Data comes from ESI (CCP's official API) and zKillboard. Be a good citizen: this server sends a proper User-Agent and caches name lookups.

  • Built under the CCP Developer License — non-commercial, as required.

  • EVE Online and all related trademarks are the property of CCP hf.

Roadmap

All five feature releases (v0.1–v0.5) are shipped — loss analysis, "can I fly it?", career sorting hat, fitting & combat coaching, direction & ISK guidance, pilot memory, and safety/logistics/news. What's left is distribution:

  • Registry submissions (official MCP registry, Smithery, Glama) and CCP's third-party directory

  • Remote MCP deployment so no local install is needed (and ChatGPT support)

Full detail in ROADMAP.md. PRs welcome. MIT licensed.

Available Tools

26 tools
ammo_advisorA

Which damage type to shoot (and tank) against a target: NPC pirate factions (Guristas, Serpentis, Angels, Blood Raiders, Sansha, Rogue Drones, Triglavians) or shield/armor-tanked players. Includes concrete ammo names per weapon system.

Inputs: target (required).

analyze_fitA

Mechanical fit check: classifies each module by type and detects classic mistakes (mixed weapon systems, mixed shield+armor tank, no propulsion, damage mods without matching weapons). Feed it module names from a loss report or a pasted fit, then explain the findings to the player.

Inputs: module_names (required).

can_i_flyA

What does it take to fly/use a ship or module? Returns the full recursive skill prerequisite tree, an ordered training plan, total skillpoints, and estimated training time. If a character is logged in, the plan is diffed against their actual trained skills.

Inputs: item_name (required).

career_testA

Data for the EVE career 'sorting hat'. Returns all recognized career paths with traits (social/risk/income/activity, who it appeals to, first ship, first steps). To use: interview the player about what they enjoy (solo vs group, risk appetite, building vs fighting vs exploring, active vs idle, how much structure they want), THEN call this and match their answers to 2-3 paths. Recommend concrete first steps, not just labels.

Inputs: no named parameters.

character_sheetA

The logged-in character's overview: total skillpoints, wallet, current location, and ship.

Inputs: no named parameters.

cheapest_way_to_playA

EVE's pay-vs-play economy explained with live numbers: Alpha (free) vs Omega (subscribed), how PLEX lets you buy game time with ISK instead of money, today's actual Jita price for an Omega month, and an honest grind-hours-vs-cash recommendation.

Inputs: no named parameters.

evaluate_corpA

Newbie-friendliness signals for a corporation by exact name: size, age, war exposure, and recent activity from ESI + zKillboard, plus the questions to ask that no API can answer. Use it to sanity-check a corp before the player applies. The API can't see recruitment status or culture — be honest about that.

Inputs: corp_name (required).

eve_auth_statusB

Check whether an EVE character is currently logged in.

Inputs: no named parameters.

eve_loginA

Start the EVE Online login flow. Opens a browser for SSO; the user must complete it within 3 minutes.

Inputs: no named parameters.

fit_readinessA

Paste an EFT-format fit (the text every fitting site, PyFA, and the in-game fitting window export) and get a can-fly verdict: which skills are missing to online every module and the hull, in training order, with total skillpoints and days. Personalized against the logged-in character; when not logged in it lists every skill the fit requires.

Inputs: fit (required).

isk_guidanceA

Viable ways to make ISK matched to a player's skillpoint tier (0-1M, 1-5M, 5-20M, 20M+), each with an honest ISK/hour range, what it requires, and a first step. Use it to answer 'how do I make money?' for someone's actual stage — point new players at the high-ratio activities (exploration ≫ mining) and away from grinds that only pay at high skillpoints. Ranges are rough community consensus, not live data; never present them as guarantees.

Inputs: no named parameters.

jargonA

EVE slang glossary. Pass a term to define it, or no term to list everything known. Use whenever the player hits a word like 'krab', 'tidi', 'doctrine', or 'asset safety'.

Inputs: term.

lookup_itemB

Look up any EVE item, ship, or module by exact name. Returns its description and Jita market prices.

Inputs: name (required).

my_assetsA

Everything the logged-in character owns, grouped by location. Flags asset-safety wraps and structures the character can no longer dock at — use this to find stuff stranded from years ago.

Inputs: no named parameters.

proven_fitsA

What modules pilots actually fly on a given ship, learned from recent killmails: the most common modules per slot with how often each appears. Use it to propose a realistic starter fit, then sanity-check that fit with analyze_fit and can_i_fly.

Inputs: ship_name (required), sample.

recall_pilot_notesA

The goals this player has previously asked you to remember, oldest first. Call it at the start of a session (or alongside what_should_i_do_tonight) to pick up where you left off and steer coaching toward what they actually want.

Inputs: no named parameters.

recent_lossesA

A character's recent ship losses from zKillboard with full fit detail — the raw material for explaining why they died. Works for any character name, no login needed.

Inputs: character_name (required), limit.

remember_goalA

Save a goal or ambition the player states ('I want to fly a Gila', 'aiming for nullsec exploration', 'save up for a freighter') so it persists across sessions. Call this whenever the player expresses a direction worth steering toward later. Stored per character.

Inputs: goal (required).

route_dangerA

Per-jump safety report for a journey between two systems: each system's security and last-hour kill activity, plus the notorious high-sec gank chokepoints (Uedama, Niarja, Sivala...) a new player wouldn't know to avoid. Use it before anyone undocks for a long haul.

Inputs: origin (required), destination (required), prefer_safer.

sitrepA

Session-start situation report in one call: login state, character overview (skillpoints/wallet/location/ship), what's training, and the most recent loss. Call this at the start of a mentoring session to orient.

Inputs: no named parameters.

skill_queueB

The logged-in character's current skill training queue.

Inputs: no named parameters.

system_intelA

Danger report for a solar system: security status, ship/pod kills and traffic in the last hour.

Inputs: system_name (required).

top_skillsB

The logged-in character's highest-trained skills — useful for judging what they can fly well.

Inputs: limit.

whats_happeningA

A 'what's going on in EVE right now?' briefing for new or returning players: live server status, active incursions (which make whole regions dangerous), the biggest recent kills galaxy-wide, and where to read the latest patch notes. Good for someone logging back in after time away.

Inputs: no named parameters.

what_should_i_do_tonightA

Answers 'what should I actually do right now?' by composing the logged-in character's real situation — skillpoints, wallet, location security, current ship, what's training — with the income options for their skillpoint tier. Returns the building blocks; you turn them into 2-3 concrete, situation-aware session suggestions. Requires login.

Inputs: no named parameters.

where_to_buyA

Compares an item's cheapest sell price across EVE's five major trade hubs (Jita, Amarr, Dodixie, Rens, Hek), and — when logged in — how many jumps each hub is from where the player is sitting, so you can weigh price against the haul.

Inputs: item_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 26 tools

    Disambiguation4/5

    Each tool has a clear, distinct purpose, but a few pairs could be confused at a glance (e.g., system_intel vs route_danger, or lookup_item vs where_to_buy). Descriptions are detailed enough to resolve ambiguity in practice.

    Naming Consistency3/5

    Naming mixes verb-first (lookup_item, analyze_fit, remember_goal) with noun-first (system_intel, recent_losses, character_sheet) and even full phrases (what_should_i_do_tonight, cheapest_way_to_play). All use snake_case, but the lack of a consistent verb_noun pattern is noticeable.

    Tool Count2/5

    At 26 tools, the set is just over the typical 'heavy' threshold. While the broad scope of EVE mentoring justifies many tools, the count edges into bloat territory and could overwhelm an agent.

    Completeness5/5

    The tool surface covers the full mentoring lifecycle: character awareness, skill planning, fit analysis, market/economy, navigation safety, corp evaluation, and session guidance. Obvious gaps are minor (e.g., no direct 'find a corp' finder, but evaluate_corp supports vetting).

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates EVE Online's ESI API with AI assistants to enable natural language interaction with character data, market information, and assets. It provides 22 tools for managing skills, wallet balances, ship fittings, and more directly through AI-powered clients.
      2
      MIT
    • F
      license
      A
      quality
      Not graded
      maintenance
      An MCP server that provides Claude with direct access to EVE Online character data, market prices, killboard intelligence, wiki knowledge, and game mechanics. It enables natural language interaction for checking skills, analyzing fittings, setting in-game destinations, and accessing real-time EVE Online information.
      37
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Remote MCP server for EVE Online that validates ship fittings with actual stats, DPS/EHP, and live market prices, enabling LLMs to answer whether a fit works and what it costs.
      GPL 3.0