eve-mentor-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@eve-mentor-mcp Why do I keep dying in lowsec?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| none | A character's recent losses with full fit detail (zKillboard + ESI) |
| optional | Full recursive skill prerequisite tree + ordered training plan for any ship/module; diffed against your real skills when logged in |
| optional | Paste an EFT fit → can-fly verdict: missing skills to online every module, in training order, with total time |
| none | What pilots actually fly on a ship — the most common modules per slot, learned from recent killmails |
| none | Mechanical fit check: classifies modules and flags classic mistakes (mixed weapons/tank, no propulsion, dead damage mods) |
| none | Which damage type to shoot and tank against a faction or enemy tank, with concrete ammo names |
| none | The EVE career "sorting hat" — Claude interviews you, then matches you to playstyles |
| none | Viable income activities by skillpoint tier, with honest ISK/hr ranges and first steps |
| SSO | Composes your real skills/wallet/location/ship into concrete session suggestions |
| optional | Save a goal the player states, so it persists across sessions (per character) |
| optional | The goals you previously saved, oldest first |
| none | Security status + kills/jumps in the last hour for any system |
| optional | Per-jump security + last-hour kills + named gank chokepoints between two systems |
| optional | An item's cheapest of the 5 trade hubs, with jumps from where you are |
| none | Returning-player briefing: server status, incursions, biggest recent kills, patch-notes link |
| none | Newbie-friendliness signals for a corp (size/age/war/activity) + what to ask |
| none | Item/ship/module description + live Jita buy/sell prices |
| none | Alpha vs Omega vs PLEX economics with today's live Jita PLEX price |
| none | EVE slang glossary — define a term or list everything known |
| optional | One-call session-start orientation: login state, character overview, what's training, last loss |
| — | Browser-based EVE SSO login (OAuth2 PKCE, no secret stored) |
| — | Who's logged in |
| SSO | Skillpoints, wallet, location, current ship |
| SSO | What's training and when it finishes |
| SSO | Highest-trained skills |
| 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.jsonWindows:
%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-mcpgit clone https://github.com/henryjrobinson/eve-mentor-mcp
cd eve-mentor-mcp
npm install && npm run buildThen 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)
Go to developers.eveonline.com → log in with your EVE account → Create New Application
Name it anything (e.g.
eve-mentor), pick Authentication & API AccessSelect these scopes:
esi-skills.read_skills.v1esi-skills.read_skillqueue.v1esi-location.read_location.v1esi-location.read_ship_type.v1esi-wallet.read_character_wallet.v1esi-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 insite/callback/) relays the login code to the local server on port 8484. (Self-hosting? Serve your own copy and setEVE_REDIRECT_URI.)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 Nameand 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 pipelineNotes
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 toolsammo_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
Scored across 26 tools
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 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.
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.
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
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.2MIT
- FlicenseAqualityNot gradedmaintenanceAn 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-
- AlicenseNot gradedqualityDmaintenanceRemote 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
- AlicenseBqualityDmaintenanceAn MCP server that gives Claude and other LLM agents programmatic access to EVE-NG network labs, enabling creation, configuration, and management of virtual network topologies through natural language.142Apache 2.0