Skip to main content
Glama
eve-mcp
by plk3000

eve-mcp

A standalone, self-hosted EVE Online MCP server for multiple independently authorized characters. Its ESI data and fitting-planning tools are read-only; the sole exception is an explicitly labeled, create-only saved-fitting action.

It communicates only with official EVE SSO/ESI endpoints. It never observes, modifies, or controls the EVE client: no process inspection, cache scraping, OCR, input automation, macros, or window control.

Read-only tools and create-only fitting action

  • Authorized-profile list and status.

  • Character summary and public character information.

  • Skills and skill queue.

  • Assets.

  • Mining ledger.

  • Industry jobs.

  • Blueprints.

  • Recent wallet transactions (bounded by days and result limit).

  • Character market orders (order_state defaults to active; historical cancelled, expired, and fulfilled states are available).

  • Saved fittings, offline static-catalog search, fitting context, and deterministic fitting validation.

  • eve_create_fitting can create one new saved fitting for the selected character after exact proposal/hash/confirmation checks; it never updates or deletes.

Blueprint, wallet-transaction, and market-order tools are Phase 2 additions. They are ESI data only—not public-market analysis, recommendations, or any in-game client monitoring or automation.

Fitting validation requires an installed static catalog. Install or update it explicitly with eve-mcp static-data refresh; MCP startup never downloads SDE data. See static-data operations for the official CCP source, cache lifecycle, and validation limits. The fitting write boundary, consent scopes, idempotency, conflict handling, and no-overwrite guarantee are documented in saved fittings.

Every data tool requires a numeric character ID or exact authorized character name. There is no active/default character. Responses include source character, data freshness, counts, and truncation metadata.

Related MCP server: EVE Online MCP

Install for development

uv sync --extra dev --extra keyring
uv run pytest -q
uv run ruff check .
uv run ruff format --check .
uv run mypy src

Run as an MCP server

The default transport is stdio and binds no TCP listener:

uv run eve-mcp serve

See MCP client configuration for a generic client configuration and authorization for self-hosted CCP application setup and multi-character authorization. Existing profiles must be explicitly reauthorized with eve-mcp auth add for any newly granted fitting scopes; MCP tools never initiate that flow.

Security and data handling

  • This repository contains no EVE client credentials or character data.

  • Character metadata/cache are stored locally under ~/.local/share/eve-mcp/.

  • Refresh tokens are stored separately per character in the desktop keyring; they are never stored in SQLite or returned through MCP.

  • Use eve-mcp auth disable to stop local data access for one character, or eve-mcp auth revoke to delete that character's local secret/profile after confirmation.

Read privacy and security before adding a character. Report vulnerabilities according to SECURITY.md.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      3
      48 npm
      2
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP clients to answer Star Citizen crafting, mining and trading questions from public game data: product recipes with quality effects, mining locations, scan signatures and refinery yields, plus terminal prices and UEX player marketplace listings. It is read-only and requires no account.
      14
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to read and act on EVE Online data through the ESI API, handling SSO login for multiple characters and answering in single calls with resolved names, combined requests, and locally indexed static data. Covers fittings (with attributes and EFT/DNA export), skills and skill checks, assets, market prices and orders, industry, mail, and arbitrary ESI routes.
      35
      16 npm
      1
      MIT