{
  "markdown": "# eve-mentor-mcp\n\nAn MCP server that turns Claude into an **EVE Online mentor for players trying to learn the game**.\n\nEVE 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:\n\n- **\"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.\n- **\"Is this system dangerous?\"** — live kill and traffic data for any system.\n- **\"What is this thing and what does it cost?\"** — any ship or module, with live Jita prices.\n- **\"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.\n\nWorks with Claude Desktop, Claude Code, and any MCP client.\n\n## Tools\n\n| Tool | Auth | What it does |\n|------|------|--------------|\n| `recent_losses` | none | A character's recent losses with full fit detail (zKillboard + ESI) |\n| `can_i_fly` | optional | Full recursive skill prerequisite tree + ordered training plan for any ship/module; diffed against your real skills when logged in |\n| `fit_readiness` | optional | Paste an EFT fit → can-fly verdict: missing skills to online every module, in training order, with total time |\n| `proven_fits` | none | What pilots actually fly on a ship — the most common modules per slot, learned from recent killmails |\n| `analyze_fit` | none | Mechanical fit check: classifies modules and flags classic mistakes (mixed weapons/tank, no propulsion, dead damage mods) |\n| `ammo_advisor` | none | Which damage type to shoot and tank against a faction or enemy tank, with concrete ammo names |\n| `career_test` | none | The EVE career \"sorting hat\" — Claude interviews you, then matches you to playstyles |\n| `isk_guidance` | none | Viable income activities by skillpoint tier, with honest ISK/hr ranges and first steps |\n| `what_should_i_do_tonight` | SSO | Composes your real skills/wallet/location/ship into concrete session suggestions |\n| `remember_goal` | optional | Save a goal the player states, so it persists across sessions (per character) |\n| `recall_pilot_notes` | optional | The goals you previously saved, oldest first |\n| `system_intel` | none | Security status + kills/jumps in the last hour for any system |\n| `route_danger` | optional | Per-jump security + last-hour kills + named gank chokepoints between two systems |\n| `where_to_buy` | optional | An item's cheapest of the 5 trade hubs, with jumps from where you are |\n| `whats_happening` | none | Returning-player briefing: server status, incursions, biggest recent kills, patch-notes link |\n| `evaluate_corp` | none | Newbie-friendliness signals for a corp (size/age/war/activity) + what to ask |\n| `lookup_item` | none | Item/ship/module description + live Jita buy/sell prices |\n| `cheapest_way_to_play` | none | Alpha vs Omega vs PLEX economics with today's live Jita PLEX price |\n| `jargon` | none | EVE slang glossary — define a term or list everything known |\n| `sitrep` | optional | One-call session-start orientation: login state, character overview, what's training, last loss |\n| `eve_login` | — | Browser-based EVE SSO login (OAuth2 PKCE, no secret stored) |\n| `eve_auth_status` | — | Who's logged in |\n| `character_sheet` | SSO | Skillpoints, wallet, location, current ship |\n| `skill_queue` | SSO | What's training and when it finishes |\n| `top_skills` | SSO | Highest-trained skills |\n| `my_assets` | SSO | Everything you own grouped by location, flagging stranded/asset-safety items |\n\n## Install (no coding required)\n\nYou need two things: the **Claude Desktop app** (or Claude Code) and **Node.js**, a free\nruntime that this server runs on — installing it is like installing any other app.\n\n### Step 1 — Install Node.js (skip if you have it)\n\nGo to [nodejs.org](https://nodejs.org), download the **LTS** version, run the installer,\nclick through with the defaults. Done.\n\n### Step 2 — Tell Claude about it (no download needed)\n\n**Claude Desktop:** open the config file in any text editor —\n\n- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n(If it doesn't exist, create it.) Make it look like this:\n\n```json\n{\n  \"mcpServers\": {\n    \"eve-mentor\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"eve-mentor-mcp\"]\n    }\n  }\n}\n```\n\nSave, then fully quit and reopen Claude Desktop. That's it — `npx` downloads and runs the\nserver automatically; updates come free.\n\n**Claude Code** (one line instead):\n\n```bash\nclaude mcp add eve-mentor -- npx -y eve-mentor-mcp\n```\n\n<details>\n<summary>Developing or self-building instead? (clone &amp; build)</summary>\n\n```bash\ngit clone https://github.com/henryjrobinson/eve-mentor-mcp\ncd eve-mentor-mcp\nnpm install && npm run build\n```\n\nThen point your MCP client at `node /FULL/PATH/TO/eve-mentor-mcp/dist/index.js`.\n</details>\n\n### Step 3 — Test it\n\nAsk Claude: *\"Pull the last 3 losses for character `<any EVE character name>` and explain\nwhat went wrong.\"* If it answers with real killmail data, you're live. No EVE login is\nneeded for this — losses, system intel, prices, the career test, and the jargon glossary\nall work immediately.\n\n### Other AI apps\n\nAny MCP-capable client works the same way (Cursor, LM Studio, VS Code, etc. — point them\nat `node /path/dist/index.js`). **ChatGPT** supports MCP but only *remote* servers, not\nlocal ones — a hosted version of the public tools is on the roadmap.\n\n### Character tools (EVE SSO)\n\n1. Go to [developers.eveonline.com](https://developers.eveonline.com) → log in with your EVE account → **Create New Application**\n2. Name it anything (e.g. `eve-mentor`), pick **Authentication & API Access**\n3. Select these scopes:\n   - `esi-skills.read_skills.v1`\n   - `esi-skills.read_skillqueue.v1`\n   - `esi-location.read_location.v1`\n   - `esi-location.read_ship_type.v1`\n   - `esi-wallet.read_character_wallet.v1`\n   - `esi-assets.read_assets.v1`\n4. Set the callback URL to exactly `https://ruby-eve.com/callback` — CCP's portal only accepts\n   https callbacks; this static page (source in `site/callback/`) relays the login code to the\n   local server on port 8484. (Self-hosting? Serve your own copy and set `EVE_REDIRECT_URI`.)\n5. Copy the **Client ID** and add it to the server's environment:\n\n```bash\nclaude mcp add eve-mentor -e EVE_CLIENT_ID=your_client_id -- npx -y eve-mentor-mcp\n```\n\n(or add `\"env\": {\"EVE_CLIENT_ID\": \"your_client_id\"}` to the Claude Desktop config.)\n\nThen 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.\n\n## Try it\n\n> *\"Pull my last 3 losses for character `Your Pilot Name` and explain what I did wrong in each one.\"*\n\n> *\"I'm about to fly through Tama. How dangerous is it right now?\"*\n\n> *\"What should I be training next given my skills and the fact that I want to try small-gang PvP?\"*\n\n## Verify it works\n\n```bash\nnpm run smoke                      # tests ESI name resolution, market, system intel\nnpm run smoke -- \"Pilot Name\"      # also tests the zKillboard loss pipeline\n```\n\n## Notes\n\n- Data comes from [ESI](https://esi.evetech.net) (CCP's official API) and [zKillboard](https://zkillboard.com). Be a good citizen: this server sends a proper User-Agent and caches name lookups.\n- Built under the [CCP Developer License](https://developers.eveonline.com/license-agreement) — non-commercial, as required.\n- EVE Online and all related trademarks are the property of [CCP hf](https://www.ccpgames.com).\n\n## Roadmap\n\nAll 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:\n\n- Registry submissions (official MCP registry, Smithery, Glama) and CCP's third-party directory\n- Remote MCP deployment so no local install is needed (and ChatGPT support)\n\nFull detail in [ROADMAP.md](ROADMAP.md). PRs welcome. MIT licensed.\n",
  "bytes": 8147,
  "sha": "8a417b6660169f36cf2780908146f00ab8182a17ece3f6918758419b72e1673e",
  "repo_slug": "henryjrobinson/eve-mentor-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_henryjrobinson_eve_mentor_mcp_1f74ca42/readme"
}