EVE Online Market MCP Server: Your Gateway to Real-Time Market Data with UBOS

In the dynamic universe of EVE Online, accessing accurate and timely market data is crucial for successful trading, logistics, and strategic decision-making. The EVE Online Market MCP (Model Context Protocol) Server, now enhanced for seamless integration with the UBOS AI Agent Development Platform, provides a robust solution for accessing and analyzing market information directly from the EVE Swagger Interface (ESI) API.

This document outlines the key features, setup process, usage examples, and authentication procedures for the EVE Online Market MCP Server. Whether you’re a seasoned EVE Online veteran or a newcomer looking to gain a competitive edge, this server empowers you with the data-driven insights you need to thrive in New Eden.

What is an MCP Server?

At its core, an MCP (Model Context Protocol) Server acts as a bridge between Large Language Models (LLMs) and external data sources. It provides a standardized way for AI models, particularly AI Agents, to access real-time information and interact with the world around them. By adhering to the MCP, applications can provide their models to the UBOS platform, allowing users to extend their agent’s functionality. In the context of EVE Online, the MCP Server enables AI Agents to dynamically access and leverage the game’s massive market data.

Why Integrate with UBOS?

The UBOS platform elevates the utility of the EVE Online Market MCP Server by enabling the creation of sophisticated AI Agents that can autonomously analyze market trends, predict price fluctuations, execute trades, and manage complex logistics operations. UBOS provides the framework for orchestrating these agents, connecting them to enterprise data, and even building custom agents with tailored LLM models. This integration unlocks a new level of automation and strategic advantage within EVE Online.

Key Features of the EVE Online Market MCP Server:

• Real-Time Market Data Access: Access up-to-the-minute market information directly from the EVE Online ESI API, ensuring you have the most current data for your trading decisions.
• Comprehensive Data Coverage: Retrieve data on market prices, orders, historical trends, grouped market statistics, and structure-specific orders, providing a holistic view of the EVE Online economy.
• ESI API Compliance: Adheres to ESI API best practices, including proper user-agent configuration and robust error handling, ensuring reliable and stable data retrieval.
• Rate Limit Management: Automatically monitors ESI rate limits and implements error handling to prevent service disruptions, ensuring continuous data availability.
• Seamless Integration with UBOS: Connects effortlessly with the UBOS AI Agent Development Platform, enabling the creation of sophisticated market analysis and trading agents.
• VS Code Integration: Includes pre-configured VS Code settings and tasks for easy building, running, and debugging of the MCP Server.
• Authentication Support: Supports EVE Online SSO for accessing market data within structures, requiring appropriate scopes for secure data retrieval.

Use Cases:

• Automated Trading Bots: Develop AI Agents that automatically analyze market data, identify profitable trading opportunities, and execute buy/sell orders, maximizing your ISK gains.
• Logistics Optimization: Create agents that monitor market trends to determine the most cost-effective routes for transporting goods, reducing expenses and increasing profit margins.
• Market Trend Analysis: Build agents that analyze historical market data to identify long-term trends and predict future price movements, enabling you to make informed investment decisions.
• Resource Management: Optimize resource allocation by tracking market prices and adjusting production schedules to maximize profitability.
• Competitive Intelligence: Monitor competitor activities and market dynamics to identify opportunities and threats, giving you a strategic advantage in the EVE Online universe.
• Personalized Alerts: Configure AI Agents to send alerts when specific market conditions are met, allowing you to react quickly to changing market dynamics.
• Market Making: Implement market making strategies by automatically placing buy and sell orders to provide liquidity and earn profits from the spread.
• Arbitrage Detection: Develop agents that identify arbitrage opportunities across different regions and structures, allowing you to profit from price discrepancies.

Detailed Functionality:

The EVE Online Market MCP Server offers several core functionalities, each designed to provide specific market insights:

1. get-market-prices:

   • Retrieves the adjusted and average prices for all items in EVE Online.
   • Returns a list of objects, each containing type_id, adjusted_price, and average_price.
   • Use Case: Identify items with the highest price volatility for potential trading opportunities.

2. get-market-orders:

   • Retrieves market orders for a specific region, with options to filter by item type and order type (buy/sell).
   • Returns detailed information about each order, including price, quantity, and location.
   • Use Case: Identify the best buy and sell offers for specific items in a given region.

3. get-market-history:

   • Retrieves the historical market data for a specific item in a specific region.
   • Provides daily high, low, average prices, and volume traded.
   • Use Case: Analyze historical price trends to predict future market movements.

4. get-market-groups:

   • Retrieves grouped market data for a specific item type in a specific region.
   • Provides statistics for buy and sell orders, including average price, high/low price, and volume.
   • Use Case: Get a quick overview of the supply and demand dynamics for a particular item.

5. get-structure-orders:

   • Retrieves all market orders for a specific structure (station, citadel, etc.).
   • Supports pagination for efficient retrieval of large datasets.
   • Use Case: Monitor market activity within a specific player-owned structure.

6. get-market-stats:

   • Retrieves market statistics for a specific region.
   • Provides metrics such as trading volume, price trends, and market activity.
   • Use Case: Assess the overall health and activity of a particular regional market.

7. get-structure-type-orders:

   • Retrieves all market orders for a specific item type within a specific structure.
   • Enables detailed market analysis within a particular location.
   • Use Case: Analyze supply and demand dynamics for a specific item within a player-owned structure.

Setting Up the EVE Online Market MCP Server:

1. Installation via Smithery:

   • Use the following command to install the server using Smithery:

     bash npx -y @smithery/cli install @kongyo2/eve-online-mcp --client claude

2. Manual Installation:

   • Clone the repository from GitHub.

   • Install the required dependencies:

     bash npm install

   • Build the project:

     bash npm run build

   • Start the server:

     bash npm start

VS Code Integration:

The project includes pre-configured VS Code settings and tasks for streamlined development:

• .vscode/settings.json: Contains MCP Server settings.
• .vscode/tasks.json: Defines tasks for building and running the server.

The following tasks are available:

• “Build EVE Online Market MCP Server”: Builds the project.
• “Run EVE Online Market MCP Server”: Starts the MCP Server.

Authentication Setup (for Structure Access):

To access market data within structures, you need to configure EVE Online SSO:

1. Register an Application:

   • Register your application on the EVE Online Developers Portal.
   • Request the following scopes:
     • esi-markets.structure_markets.v1
     • esi-markets.read_character_orders.v1

2. Configure Environment Variables:

   • Copy the .env.example file to .env.
   • Edit the .env file and set your client ID and secret.

Authentication Flow:

1. Get Authentication URL:

   typescript const authUrlResponse = await callTool(“get-auth-url”, { state: “unique-state-string” }); // Redirect the user to the URL in authUrlResponse

2. Exchange Authorization Code:

   typescript const authResponse = await callTool(“authenticate”, { code: “authorization-code-from-callback” }); // Save the returned token

3. Refresh Token:

   typescript const refreshResponse = await callTool(“refresh-token”, { refresh_token: “saved-refresh-token” }); // Update with the new token

Accessing Structure Data:

When accessing market data within structures that require authentication:

1. Obtain a token with the appropriate scopes.

2. Specify the token when calling makeESIRequest:

   typescript const structureOrders = await callTool(“get-structure-orders”, { structure_id: 1234567890, page: 1, token: “your-access-token” });

Important Considerations:

• Structure Endpoints: Accessing structure-related endpoints requires an ESI token with the appropriate permissions.
• Pagination: Endpoints that return large amounts of data use pagination. Use the page parameter to specify the desired page (starting from 1).
• Caching: ESI responses are cached on the server-side. The cache duration varies depending on the endpoint. Cache information can be found in the response headers.

The Power of UBOS for AI Agent Development:

The UBOS platform empowers you to build sophisticated AI Agents that leverage the EVE Online Market MCP Server to automate trading strategies, optimize logistics, and gain a competitive edge. With UBOS, you can:

• Orchestrate Complex Agent Workflows: Design and manage multi-agent systems that collaborate to achieve complex goals.
• Connect to Enterprise Data: Integrate market data with your internal data sources to gain a holistic view of your operations.
• Build Custom AI Agents: Tailor AI Agents to your specific needs using custom LLM models.
• Automate Repetitive Tasks: Automate tedious tasks such as market monitoring and order execution, freeing up your time to focus on strategic decision-making.

By combining the EVE Online Market MCP Server with the UBOS AI Agent Development Platform, you can unlock a new level of automation and strategic advantage in the EVE Online universe. Start building your AI-powered trading empire today!