familiar

Your familiar across New Eden — an EVE Online MCP server that lets a local AI see your whole account and the universe, and act on your behalf when you ask.

familiar is a Model Context Protocol (MCP) server that gives a local AI (Claude Code, Claude Desktop, Cowork) a complete window into your EVE Online account and the entire game universe — public market & universe lookups plus authenticated character and corp data — with opt-in, audited write actions.

It looks, it finds, it reports back, and it acts when you ask. Ask it where your assets are, what your skill queue looks like, what Tritanium sells for in Jita, the safest route to a lowsec system — and have it set a waypoint or draft a mail when you say so.

Wiki contents

Page	What's in it
Home	This overview
Getting Started	Install, log in, connect to Claude, offline SDE
Architecture	How the server, ESI/zKill clients, auth, and the per-character pattern fit together
Tool Reference	Every MCP tool, grouped by module
Write Safety	The write-action gate: dry-run previews, the global toggle, the audit log
Authentication & Scopes	EVE SSO (PKCE), the multi-character token store, the OAuth scopes
Configuration	Every environment variable and on-disk path
Development & CI	Tests, linting, the Git workflow, and the CI/publish pipeline

At a glance

Language / stack: Python ≥ 3.11, FastMCP, httpx, cryptography (Fernet). Managed with uv.
Data sources: ESI (the EVE Swagger Interface) and the SDE (Static Data Export), plus zKillboard for PvP data.
Auth: EVE SSO via PKCE (no client secret), multi-character, refresh token stored Fernet-encrypted on disk.
Surface: ~80 tools across market, universe, account, industry, trade, structures, killmails, profile, corp, comms, contacts, fittings, fleet, PI and more.
Safety: Reads are free; every write is previewed unless confirm=true, can be globally disabled, and is written to an audit log.

Principles

Safe by default. Reading is free; every write is previewed before it runs and recorded in an audit log. Writes are on by default but can be turned off entirely. The AI sees everything and changes nothing without your explicit confirm.
Local-first. Runs on your own machine. Your refresh token and account data never leave your control.
Everything, eventually. Full coverage is the goal: the ESI scopes you grant (character and corp, read and write), plus the complete static universe. Built in phases so it actually ships.

License

MIT.

familiar

familiar — an EVE Online MCP server · repository · MIT