EVE MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
eve-mcp
A small MCP server that gives Claude (or any other MCP client) live EVE Online data from CCP's ESI API: your own characters, plus public game data. Everything it does is read-only.
Tool | What it does | Needs sign-in |
| Who's signed in | – |
| Skills, levels, SP, unallocated SP (filterable) | yes |
| Queue order, finish times, when it runs out | yes |
| Balance and recent journal entries | yes |
| System, security, station, ship, online | yes |
| Items by station, and what they're inside | yes |
| Best buy/sell at Jita, Amarr, Dodixie, Rens, Hek | no |
| Group, volume, in-game description | no |
| Security, region, last hour's jumps and kills | no |
| Gate route with security for each jump | no |
Files:
server.py: the MCP server. Read this one first: each tool is a short function.eve_common.py: settings, sign-in tokens, talking to ESIauth.py: one-off login per character.env: your app's ID and secret (you make this; git-ignored)tokens.json: sign-in tokens (made byauth.py; git-ignored, keep it private)
Tested with Python 3.13, mcp 2.3.0 and httpx 0.28.1 on Debian 13. It needs
Python 3.10 or later. requirements.lock lists the exact versions of every
package from that test, if you want to reproduce it.
Why MCP
You could give a model the ESI documentation and let it make API calls itself, and for one-off public data (a market price, a route) that works fine. A server earns its place once sign-in is involved:
The server holds the credentials. The model never sees your app's secret or your refresh token; it only sees the results of tool calls.
The docstrings do the steering. Each tool's description tells the model when to use it, so you don't have to explain ESI in every chat.
Results are shaped for a model. Names instead of numeric IDs, prices formatted, long asset lists grouped and cut to a sensible size.
It works across clients. Anything that speaks MCP can use it.
Related MCP server: eve-mentor-mcp
1. Register an EVE application
ESI needs every user to bring their own application. At https://developers.eveonline.com/ create one with:
Callback URL:
http://localhost:8765/callbackScopes (all read-only):
esi-skills.read_skills.v1esi-skills.read_skillqueue.v1esi-wallet.read_character_wallet.v1esi-location.read_location.v1esi-location.read_ship_type.v1esi-location.read_online.v1esi-assets.read_assets.v1
It gives you a client ID and a secret key.
2. Install
From this folder.
Linux or macOS:
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txtOn Debian or Ubuntu, if the first command complains that venv is missing,
run sudo apt install python3-venv and try again.
Windows (PowerShell; if py isn't found, install Python from python.org and
tick "Add to PATH"):
py -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txtThe .venv folder keeps these packages to this project. In the steps below,
"the project's Python" means .venv/bin/python on Linux/macOS and
.venv\Scripts\python on Windows.
3. Fill in .env
Copy .env.example to .env and paste in the client ID and secret. Set
EVE_USER_AGENT to something with a way to contact you (CCP asks API
clients to identify themselves). On Linux/macOS, keep the file to yourself:
cp .env.example .env
chmod 600 .env4. Sign in
.venv/bin/python auth.pyYour browser opens EVE's login. Pick a character and approve. The terminal
should say "Saved" and list any permissions it didn't get. Run it again for
each further character. If you have several, set EVE_DEFAULT_CHARACTER in
.env to the one the tools should use when you don't name one.
On a machine with no browser, open the printed link on another computer, approve, then copy the whole address you land on (the page itself won't load) and paste it into the terminal.
5. Check it works
.venv/bin/python server.py --checkIt should print who is signed in, where your character is, their ship and when their skill queue ends, then "All good."
6. Add it to Claude
Both need absolute paths to the project's Python and to server.py.
Claude Code:
claude mcp add --scope user eve -- /path/to/eve-mcp/.venv/bin/python /path/to/eve-mcp/server.py
claude mcp listclaude mcp list should show eve as connected. The tools only appear in a
new Claude Code session: MCP servers are loaded when a session starts.
Claude Desktop: open Settings > Developer > Edit Config (the file is
claude_desktop_config.json) and add this inside "mcpServers", creating
that section if it isn't there.
macOS:
{
"mcpServers": {
"eve": {
"command": "/path/to/eve-mcp/.venv/bin/python",
"args": ["/path/to/eve-mcp/server.py"]
}
}
}Windows (double backslashes are how JSON writes one backslash):
{
"mcpServers": {
"eve": {
"command": "C:\\path\\to\\eve-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\eve-mcp\\server.py"]
}
}
}Then quit Claude completely (on Windows, right-click the tray icon > Quit, not just closing the window) and start it again.
Security
What it can read: for each character you sign in, their skills and skill queue, wallet balance and journal, location, ship, online status and assets. Nothing else, and only what the seven scopes above allow.
What it can change: nothing. Every scope is read-only and the server makes no writes to EVE.
Where secrets live: your app's ID and secret in
.env, your sign-in tokens intokens.json, both in this folder on your machine and both git-ignored.tokens.jsonis written with mode 600 (owner only) on Linux/macOS. Anyone who gets that file can read the same data until you revoke it, so don't share or commit it.Revoking: remove the application's access at https://community.eveonline.com/support/third-party-applications/.
Not sandboxed: like any MCP server run over stdio, this is an ordinary program running as you, with your access to your files. Read the code before you run it; it's short.
Adding a tool
Copy one of the short tools in server.py, change the ESI path, and start
a new Claude session. The ESI endpoints are listed at
https://developers.eveonline.com/api-explorer. If the new endpoint needs a
new permission, add it to SCOPES in eve_common.py, tick it on the app,
and run auth.py again.
There is a small offline test of the security-status rounding:
.venv/bin/python tests/test_sec.pyIf something goes wrong
"EVE refused ... (403)": the sign-in lacks that permission. Tick the scope on your app (step 1), then sign in again (step 4).
Login page says invalid scope: a scope in
SCOPESisn't ticked on the app."EVE_CLIENT_ID is missing":
.envisn't there or isn't filled in (step 3).Tools don't appear in Claude: check the paths are absolute and correct, run step 5 to see the error in the terminal, and remember a new session (Claude Code) or a full restart (Claude Desktop) is needed. Then look at the MCP logs:
Claude Code on Linux:
~/.cache/claude-cli-nodejs/<project folder>/mcp-logs-eve/Claude Desktop on Windows:
%APPDATA%\Claude\logs\mcp-server-eve.log
Everything fails after an ESI change: the server uses
https://esi.evetech.net/latest(ESIineve_common.py). If CCP changes how the API is versioned, that address may need updating.
Licence
MIT; see LICENSE.
Not affiliated with or endorsed by CCP Games. EVE Online and all related names are trademarks of CCP hf.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted MCP server for live public-data APIs and Skills for AI agents.
Provide detailed Pokémon data and information through a standardized MCP interface. Enable LLMs an…
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- 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-
- AlicenseAqualityDmaintenanceMCP server that turns Claude into an EVE Online mentor, providing tools for loss analysis, system intel, market prices, skill training, and career guidance for new players.2653 npm4MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that connects EVE Online's ESI API to LLM clients, enabling reading private and public EVE data, resolving names and IDs, and optionally executing a small allowlist of write actions.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to discover and invoke read-only EVE Online ESI API endpoints, retrieve public and character data with automatic OAuth, and turn that context into practical adventure plans.348 npm2AGPL 3.0