io.github.henryjrobinson/eve-mentor-mcp

Official

by henryjrobinson · TypeScript

AI mentor for new & returning EVE Online players: losses, skills, fits, ISK, routes, and more.

AI mentor for EVE Online players offering guidance on skills, fits, routes, and ISK management.

README.md8 KBView on GitHub

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

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:

json

{
  "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):

bash

claude mcp add eve-mentor -- npx -y eve-mentor-mcp

<details> <summary>Developing or self-building instead? (clone & build)</summary>

bash

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.

</details>

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)

Go to developers.eveonline.com → log in with your EVE account → Create New Application
Name it anything (e.g. eve-mentor), pick Authentication & API Access
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
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.)
Copy the Client ID and add it to the server's environment:

bash

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

bash

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.

Install

Configuration

Environment variables

EVE_CLIENT_ID

EVE developer application client ID (only needed for character tools; public tools work without it)

claude_desktop_config.json

{
  "mcpServers": {
    "eve-mentor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "eve-mentor-mcp@0.1.2"
      ],
      "env": {
        "EVE_CLIENT_ID": "<YOUR_EVE_CLIENT_ID>"
      }
    }
  }
}