The EVE Online ESI MCP Server provides comprehensive, performance-optimized access to EVE Online's ESI API with MCP-remote compatibility, offering:
Complete API Integration: Access 400+ auto-generated tools from the official ESI swagger specification, covering character, corporation, alliance, market, and universe data with real-time updates.
Enterprise Performance: Features intelligent ETag-based caching, ML-driven optimization, and advanced rate limiting, delivering 50-70% faster response times.
MCP-Remote Compatibility: Seamlessly integrates with MCP clients like Claude Desktop, Cursor, and Windsurf using multiple transport strategies.
Authentication & Security: Implements EVE SSO OAuth 2.0 with PKCE, dynamic client registration, and token management for 67 ESI scopes.
Rich Functionality: Retrieve character information, assets, skills, corporation data, market prices, universe details, and resolve names to IDs, with advanced filtering options.
Monitoring & Management: Includes health checks, performance metrics, cache statistics, and configuration examples for easy server management.
Enables configuration of the EVE Online ESI MCP server through environment variables, including API keys, OAuth settings, and server port options.
Provides installation and package management for the EVE Online ESI MCP server, including automated installation via Smithery.
EVE Online ESI MCP Server
The most comprehensive and performance-optimized EVE Online ESI MCP server available. This enterprise-grade server provides complete access to EVE Online's ESI API through the Model Context Protocol, with advanced performance optimization, full mcp-remote compatibility, and automatic API coverage.
๐ Key Features
Complete ESI Integration
400+ Auto-Generated Tools: Complete API coverage from official ESI swagger specification
Real-time Updates: Tools automatically generated from latest ESI specification
Official ESI Compliance: Implements all CCP Games best practices and rate limiting
Smart Categorization: Tools organized by character, corporation, alliance, market, universe, etc.
Enterprise Performance
Intelligent Caching: ETag-based caching with ESI expires header compliance
ML-Driven Optimization: Predictive resource allocation and performance learning
Advanced Rate Limiting: ESI error-based limiting + endpoint-specific controls
Connection Pooling: HTTP keep-alive and connection reuse optimization
50-70% Performance Improvement: Measured response time enhancements
MCP-Remote Optimized
Full geelen/mcp-remote Support: Seamless integration with Claude Desktop, Cursor, Windsurf
Multiple Transport Strategies: SSE-first, HTTP-only, auto-detection
CORS Optimization: Pre-configured for all major MCP clients
OAuth Integration: Complete EVE SSO authentication flow
Authentication & Security
EVE SSO OAuth 2.0: Full PKCE implementation with 67 available scopes
Dynamic Client Registration: Automatic OAuth client setup
Token Management: Refresh, verify, and exchange capabilities
Security Best Practices: Rate limiting, input validation, secure headers
Installation
Installing via Smithery
To install EVE Online ESI Server for Claude Desktop automatically via Smithery:
Manual Installation
Configuration
Create a .env
file with the following variables:
Running the Server
Local Mode (stdio)
For direct local connections:
Remote Mode (SSE/HTTP)
For remote connections with OAuth:
๐ฏ MCP-Remote Integration
Claude Desktop Configuration
Add to your claude_desktop_config.json
:
Cursor Configuration
Windsurf Configuration
Advanced Transport Strategies
Get Configuration Examples
๐ Available Tools (400+)
Auto-Generated from ESI Swagger Specification
Character Tools (150+ tools, authentication required)
get_characters_character_id
- Character informationget_characters_character_id_assets
- Character assets and locationsget_characters_character_id_location
- Current character locationget_characters_character_id_online
- Online statusget_characters_character_id_ship
- Current ship informationget_characters_character_id_wallet
- Wallet balance and transactionsget_characters_character_id_mail
- Mail headers and messagesget_characters_character_id_skills
- Character skills and skill queueget_characters_character_id_clones
- Clone informationget_characters_character_id_implants
- Active implantsAnd 140+ more character endpoints...
Corporation Tools (50+ tools)
get_corporations_corporation_id
- Corporation informationget_corporations_corporation_id_members
- Corporation membersget_corporations_corporation_id_assets
- Corporation assetsget_corporations_corporation_id_wallets
- Corporation walletsget_corporations_corporation_id_structures
- Corporation structuresAnd 45+ more corporation endpoints...
Alliance Tools (10+ tools)
get_alliances
- List all active alliancesget_alliances_alliance_id
- Alliance informationget_alliances_alliance_id_corporations
- Alliance corporationsget_alliances_alliance_id_icons
- Alliance iconsAnd more alliance endpoints...
Market Tools (20+ tools)
get_markets_region_id_orders
- Market orders by regionget_markets_region_id_history
- Historical market dataget_markets_prices
- Global market pricesget_markets_groups
- Market groups and categoriesAnd more market endpoints...
Universe Tools (200+ tools)
get_universe_regions
- All regionsget_universe_systems
- All solar systemsget_universe_stations
- All stationsget_universe_structures
- Public structuresget_universe_types
- All item typesget_universe_categories
- Item categoriesAnd 194+ more universe endpoints...
Industry Tools (30+ tools)
Manufacturing, research, and blueprints
Industry jobs and facilities
Mining operations and extractions
Other Categories (80+ tools)
Mail System: Character and corporation mail
Calendar: Events and scheduling
Contracts: Contract management
Fittings: Ship fittings and loadouts
Killmails: Combat records
Loyalty Points: LP stores and offers
Planetary Interaction: PI operations
Search: Universal search functionality
Wars: War declarations and status
Enhanced Performance Tools
get_performance_dashboard
- Comprehensive server metricsget_tool_recommendations
- AI-powered optimization suggestionsget_esi_scopes
- Available authentication scopesgenerate_eve_auth_url
- EVE SSO authorization URLs
OAuth Flow
When connecting via mcp-remote, you'll be redirected to authorize
Approve access to grant permissions
The server will issue an access token
All subsequent requests will use this token
Transport Strategies
When using mcp-remote, you can specify transport strategies:
๐ API Endpoints
MCP Transport
SSE:
GET /sse
- Server-Sent Events transport (mcp-remote optimized)HTTP:
POST /mcp
- HTTP transport for single requestsTransport Detection:
GET /transport
- Capability detection for mcp-remote
Authentication
OAuth Registration:
POST /oauth/register
- Dynamic client registrationOAuth Authorization:
GET /oauth/authorize
- OAuth flow initiationOAuth Token:
POST /oauth/token
- Token exchange
EVE SSO Integration
EVE Auth:
GET /auth/eve
- Generate EVE SSO authorization URLEVE Callback:
POST /auth/eve/callback
- Exchange authorization codeEVE Refresh:
POST /auth/eve/refresh
- Refresh access tokensEVE Verify:
POST /auth/eve/verify
- Verify token validity
Monitoring & Management
Health Check:
GET /health
- Enhanced health statusPerformance Metrics:
GET /metrics
- Comprehensive performance dataCache Stats:
GET /cache/stats
- Cache performance metricsCache Clear:
DELETE /cache
- Clear cache (authenticated)MCP Config:
GET /mcp-config
- Client configuration examples
Development
To list all available tools:
Security
OAuth tokens expire after 1 hour
PKCE is supported for enhanced security
All API requests require valid authentication
Client secrets are stored securely
๐ Documentation
ESI Integration Guide - Complete ESI implementation details
MCP-Remote Guide - Full mcp-remote integration guide
Performance Guide - Performance optimization and monitoring
๐ Performance Statistics
Total Tools: 400+ auto-generated from ESI specification
Response Time: 50-70% improvement with intelligent caching
Cache Hit Rate: 80-90% efficiency
API Coverage: 100% of public ESI endpoints
Authentication: 67 ESI scopes supported
Transport Options: SSE, HTTP, auto-detection
๐ก Security & Compliance
ESI Best Practices: Full compliance with CCP Games recommendations
Error-based Rate Limiting: Prevents API abuse and bans
PKCE Support: Enhanced OAuth security
Token Management: Secure refresh and validation
Input Validation: Comprehensive parameter validation
๐ง Development
Running Tests
Docker Support
Environment Variables
See .env
file for all configuration options including performance tuning, authentication, and ESI settings.
๐ค Contributing
This server implements the complete EVE Online ESI specification with enterprise-grade performance and mcp-remote optimization. Contributions are welcome for additional features or optimizations.
๐ License
MIT
Built with โค๏ธ for the EVE Online community. Optimized for Claude Desktop, Cursor, Windsurf, and all MCP clients.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
This is an MCP (Model Context Protocol) server for the EVE Online ESI API that supports both local (stdio) and remote (OAuth-enabled) connections.
Related MCP Servers
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -63MIT License
- -securityAlicense-qualityAn MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.Last updated -8MIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for querying the CVE-Search API. This server provides comprehensive access to CVE-Search, browse vendor and productใget CVE per CVE-IDใget the last updated CVEs.Last updated -656MIT License
- -securityFlicense-qualityA server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.Last updated -24