# EVE-KILL MCP Server - [EVE-KILL](https://eve-kill.com/) — human-friendly killboard - [REST API documentation](https://eve-kill.com/docs) — OpenAPI reference - [MCP endpoint](https://eve-kill.com/api/mcp) — JSON-RPC over streamable HTTP Endpoint: https://eve-kill.com/api/mcp (JSON-RPC over streamable HTTP) Protocol: MCP 2025-06-18 No auth or API key required; send an identifying User-Agent header ## What this server does Exposes EVE-KILL killmail and intel data to AI agents as a set of narrow, purpose-built tools. Covers entity lookup, killmail detail, character/corp/alliance stats, relationship graphs, battle reports, system activity, route danger and personalized queries. ## Connecting a client ### Native HTTP clients {"mcpServers":{"evekill":{"type":"http","url":"https://eve-kill.com/api/mcp"}}} Claude Code: `claude mcp add --scope user --transport http evekill https://eve-kill.com/api/mcp` ### Claude Desktop via mcp-remote {"mcpServers":{"evekill":{"command":"npx","args":["-y","mcp-remote","https://eve-kill.com/api/mcp"]}}} ## How to call it POST /mcp with JSON-RPC 2.0. Call `tools/list` to discover current tools, then `tools/call` with a name and arguments. Example: `POST /mcp {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"Jita"}}}` ## Usage tips for LLMs 1. Resolve named EVE entities with `search` before passing IDs to other tools. 2. Use `me_*` tools for self-identified characters, passing the `me` argument every time. 3. Use `capsuleer_dossier` for a one-shot profile and `find_battles` with `battle_report` for recent fights. 4. `route_danger` supports shortest and safest stargate routes. 5. Entity responses include canonical eve-kill.com URLs for citations. ## Tools ### search Search EVE Online entities by name or ticker across characters, corporations, alliances, ships, items, systems, regions, constellations, and factions. Use this first when an entity is only known by name. Arguments: - limit (optional) [integer] — Maximum number of matches to return. - query (required) [string] — Name or ticker to search for. Three or more characters enable fuzzy matching. - type (optional) [null | string] — Restrict results to one entity type. Returns: see tools/list outputSchema or /api/docs for the full schema ### entity_overview Return lifetime kills, losses, ISK totals, and common breakdowns for a character, corporation, alliance, ship, system, constellation, or region. Arguments: - entity (required) [any] — Entity name or numeric identifier. - format (optional) [string] — Use summary for a concise narrative response. - type (optional) [null | string] — Entity type, recommended for identifiers and ambiguous names. Returns: see tools/list outputSchema or /api/docs for the full schema ### entity_kills Return recent killmails involving an entity, newest first. Filter between kills, losses, or both and paginate with before. Arguments: - before (optional) [null | integer] — Return killmails older than this identifier. - entity (required) [any] — Entity name or numeric identifier. - from (optional) [null | string] — Inclusive ISO date or timestamp lower bound. - limit (optional) [integer] — Maximum number of killmails. - role (optional) [string] — Return kills made, losses suffered, or both. - to (optional) [null | string] — Exclusive ISO date or timestamp upper bound. - type (optional) [null | string] — Entity type, recommended for identifiers and ambiguous names. Returns: see tools/list outputSchema or /api/docs for the full schema ### entity_top Top-N breakdown for a character, corporation, or alliance across ships, locations, prey, or tormentors, with optional date and opponent filters. Arguments: - dimension (required) [string] - entity (required) [any] - limit (optional) [integer] - since (optional) [null | string] - sort_by (optional) [string] - type (optional) [null | string] - until (optional) [null | string] - vs (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### entity_timeline Kills, losses, and ISK activity over time for an entity, bucketed by day, month, or year with optional opponent filtering. Arguments: - bucket (optional) [string] - entity (required) [any] - since (optional) [null | string] - type (optional) [null | string] - until (optional) [null | string] - vs (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### killmail Return full victim, attacker, final blow, location, value, and point details for one killmail. Arguments: - killmail_id (required) [integer] — Numeric killmail identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### killmail_story Render one killmail as a short narrative with the victim, ship, system, attackers, final blow, value, security, and time. Arguments: - killmail_id (required) [integer] — Numeric killmail identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### flies_with Frequent wingmates of a character — who they most often appear alongside on killmails in the last 90 days. Sourced from conservative same-side FLEW_WITH relationships. Arguments: - entity (required) [any] - limit (optional) [integer] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### hunts_in Preferred hunting grounds of a character — systems where they most often appear on killmails in the last 90 days. Weight is distinct killmails observed in that system. Arguments: - entity (required) [any] - limit (optional) [integer] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### hunted_by Characters who most often kill this character in the last 90 days. Weight is the death count by that attacker. Arguments: - entity (required) [any] - limit (optional) [integer] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### preys_on Characters who this character most often kills in the last 90 days. Weight is the kill count against that victim. Arguments: - entity (required) [any] - limit (optional) [integer] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### compare Head-to-head between two characters in the last 90 days. Returns direct kills each way, shared wingmates count, and mutual hunting grounds. Arguments: - a (required) [any] - b (required) [any] Returns: see tools/list outputSchema or /api/docs for the full schema ### kills_with Count killmails where two characters were both attackers, with optional ship, victim, location, time, and breakdown filters. Arguments: - entity (required) [any] - entity_ship (optional) [null] - from (optional) [null | string] - group_by (optional) [string] - limit (optional) [integer] - partner (required) [any] - partner_ship (optional) [null] - region (optional) [null] - system (optional) [null] - to (optional) [null | string] - type (optional) [null | string] - victim_entity (optional) [null] - victim_ship (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### ships_used Analyze kills and losses for a character, corporation, or alliance by ship, victim ship, location, or month with optional filters. Arguments: - entity (required) [any] - from (optional) [null | string] - group_by (optional) [string] - limit (optional) [integer] - region (optional) [null] - role (optional) [string] - ship (optional) [null] - system (optional) [null] - to (optional) [null | string] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### battle_report Break down one battle by team and alliance or corporation, using recomputed final-blow and loss totals from raw killmails. Arguments: - battle_id (required) [integer] - format (optional) [string] - level (optional) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### find_battles Find recent battles by location, size, value, time, participants, opposing-team requirement, and sort order. Arguments: - limit (optional) [integer] - min_isk (optional) [null | number] - min_kills (optional) [null | integer] - opposing (optional) [boolean] - participants (optional) [null | array] - region_id (optional) [null | integer] - since (optional) [null | string] - sort (optional) [string] - system_id (optional) [null | integer] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### system_pulse Activity heat for a solar system over a recent or explicit historical window, including totals and top attackers and ships. Arguments: - hours (optional) [number] - since (optional) [null | string] - system (required) [any] - top_n (optional) [integer] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### expensive_losses Most valuable killmails matching optional time, location, victim, ship, value, and opposing-entity filters. Arguments: - days (optional) [integer] - limit (optional) [integer] - min_value (optional) [null | number] - region_id (optional) [null | integer] - ship_type_id (optional) [null | integer] - system_id (optional) [null | integer] - victim_alliance_id (optional) [null | integer] - victim_character_id (optional) [null | integer] - vs (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### capsuleer_dossier One-shot character intelligence report combining overview stats, archetype tags, top ships and systems, wingmates, and playstyle. Arguments: - entity (required) [any] - format (optional) [string] - type (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### route_danger Build a shortest or security-weighted stargate route between two systems and annotate every hop with recent kills and danger. Arguments: - avoid (optional) [null | array] - from (required) [any] - hours (optional) [number] - prefer (optional) [string] - round_trip (optional) [boolean] - to (required) [any] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_dossier Your own full intelligence dossier with lifetime stats, archetype tags, playstyle, ships, systems, and wingmates. Arguments: - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_overview Your lifetime kill and loss statistics with top ships, systems, prey, and tormentors. Arguments: - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_kills Your recent killmails, optionally filtered to kills or losses and bounded by time or pagination cursor. Arguments: - before (optional) [null | integer] - from (optional) [null | string] - limit (optional) [integer] - me (required) [string] - role (optional) [string] - to (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_flies_with Your frequent wingmates from the last 90 days. Arguments: - limit (optional) [integer] - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_hunts_in Your preferred hunting systems from the last 90 days. Arguments: - limit (optional) [integer] - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_hunted_by Characters who most often killed you in the last 90 days. Arguments: - limit (optional) [integer] - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_preys_on Characters you most often killed in the last 90 days. Arguments: - limit (optional) [integer] - me (required) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_kills_with Count killmails you share with a partner, with optional ship, victim, location, time, and breakdown filters. Arguments: - entity_ship (optional) [null] - from (optional) [null | string] - group_by (optional) [string] - limit (optional) [integer] - me (required) [string] - partner (required) [any] - partner_ship (optional) [null] - region (optional) [null] - system (optional) [null] - to (optional) [null | string] - victim_entity (optional) [null] - victim_ship (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_ships_used Your kills and losses broken down by ship, victim ship, location, or month with optional filters. Arguments: - from (optional) [null | string] - group_by (optional) [string] - limit (optional) [integer] - me (required) [string] - region (optional) [null] - role (optional) [string] - ship (optional) [null] - system (optional) [null] - to (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### me_timeline Your combat activity over time, bucketed by day, month, or year and optionally restricted to one opponent. Arguments: - bucket (optional) [string] - me (required) [string] - since (optional) [null | string] - until (optional) [null | string] - vs (optional) [null] Returns: see tools/list outputSchema or /api/docs for the full schema ### character_history Inferred corporation and alliance membership history for a character, derived from ordered killmails. Dates may be imprecise for inactive pilots. Arguments: - entity (required) [any] - since (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### coalition_graph Time-windowed alliance co-occurrence graph derived from battle teams. Edges count battles where two alliances stood on the same or opposing teams. Arguments: - focus_alliance (optional) [null] - limit_edges (optional) [integer] - min_alliance_battles (optional) [integer] - min_edge_weight (optional) [integer] - since (optional) [null | string] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### doctrine_detect Identify dominant victim-fit families for a character, corporation, or alliance from losses in a time window. Arguments: - entity (required) [any] - include_rookie_ships (optional) [boolean] - limit (optional) [integer] - min_cluster_size (optional) [integer] - since (optional) [null | string] - type (optional) [null | string] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### dogma_eval Compute DPS, alpha, EHP, capacitor, navigation, targeting, and fitting stats for a stored, EFT, or structured fit. Arguments: - drones (optional) [null | array] - eft (optional) [null | string] - fit_hash (optional) [null | string] - killmail_id (optional) [null | integer] - modules (optional) [null | array] - ship_type_id (optional) [null | integer] - skills (optional) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### fit_compare Evaluate and diff two stored, EFT, or structured fits across damage, tank, capacitor, navigation, and signature stats. Arguments: - a (required) [object] - b (required) [object] - skills (optional) [string] Returns: see tools/list outputSchema or /api/docs for the full schema ### global_pulse Global activity firehose: hottest solar systems, most active alliances and corporations over a recent window (default 1 hour). Scouting entry point when you don't know where to start. Use system_pulse to drill into a specific hot system. Arguments: - hours (optional) [number] - top_n (optional) [integer] Returns: see tools/list outputSchema or /api/docs for the full schema ### item_info Return static category, group, physical, fitting, variation, and Jita price data for an EVE item. Arguments: - item (required) [any] — Item name or type identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### killmail_fitting Return a killmail fit grouped by slots, including charges, drones, fit hash, and family hash. It can also render EFT text. Arguments: - format (optional) [string] — Return structured JSON or an EFT text fit. - killmail_id (required) [integer] — Numeric killmail identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### killmail_forensics Run a victim fit through the dogma engine and produce rule-based findings about numbers, capacitor, tank, align time, and doctrine match. Arguments: - killmail_id (required) [integer] — Numeric killmail identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### meta_pulse Find the most frequently lost fit families globally or in a region, optionally filtered by hull category. Arguments: - include_rookie_ships (optional) [boolean] - limit (optional) [integer] - min_cluster_size (optional) [integer] - region_id (optional) [null | integer] - ship_category (optional) [string] - since (optional) [null | string] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### pilot_efficiency Per-pilot performance stats, optionally scoped to a ship type, with ratios, gang sizes, and UTC activity heatmaps over recent history. Arguments: - entity (required) [any] - ship_type_id (optional) [null | integer] - since (optional) [null | string] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ### ship_compare Compare the static hull stats of two ships side by side. Arguments: - a (required) [any] — First hull name or type identifier. - b (required) [any] — Second hull name or type identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### ship_info Return static hull, slot, fitting, tank, mobility, sensor, drone, cargo, and Jita price data. Arguments: - ship (required) [any] — Hull name or type identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### system_info Return security, topology, region, constellation, faction, station, and stargate-neighbor data for a solar system. Arguments: - system (required) [any] — System name or solar system identifier. Returns: see tools/list outputSchema or /api/docs for the full schema ### war_report Head-to-head report between two characters, corporations, or alliances, including directional kills and ISK, a daily timeline, contested systems, and shared battles. Arguments: - a (required) [any] - b (required) [any] - since (optional) [null | string] - top_battles (optional) [integer] - top_systems (optional) [integer] - until (optional) [null | string] Returns: see tools/list outputSchema or /api/docs for the full schema ## Notes and limits - Public read-only killboard data; no authentication or per-user state. - Memgraph relationship edges cover a rolling 90-day window. - ISK values use EVE-KILL price overlays when present, otherwise market prices. - Human-friendly site: https://eve-kill.com · REST API: https://eve-kill.com/api