Evetycoon MCP Server

🚀 EVE Tycoon MCP Server

A Model Context Protocol (MCP) server that provides access to the EVE Tycoon API for EVE Online market data. It allows users to retrieve market data, price statistics, order books, and historical pricing information for EVE Online items across different regions.

🚀 Quick Start

This MCP server enables interaction with the EVE Tycoon API to obtain various market - related data for EVE Online items in different regions.

✨ Features

Tools

• get_market_stats: Retrieve price and volume statistics for an item in a specific region.
• get_market_orders: Fetch the current order book for an item type along with metadata.
• get_market_history: Obtain the price history for an item in a region.
• get_regions: Get the list of all EVE Online regions.
• get_market_groups: Obtain the list of all market groups.
• get_market_group_types: Get the list of item types in a specific market group.

Resources

• EVE Tycoon API Documentation: A quick reference for API endpoints and usage.

Prompts

• market - analysis: Generate queries to find market data for specific items.
• comprehensive - analysis: Perform detailed market analysis for items.

📦 Installation

Installing via Smithery

To automatically install evetycoon - mcp - server for Claude Desktop via Smithery, use the following command:

npx -y @smithery/cli install @kongyo2/evetycoon-mcp-server --client claude

Manual Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

💻 Usage Examples

Development

Run the server in development mode:

npm run dev

Production

Build and start the server:

npm run build
npm start

Testing

Run tests:

npm test

📚 Documentation

API Endpoints Covered

This MCP server provides access to all documented EVE Tycoon API endpoints:

Market APIs

• /v1/market/stats/{regionId}/{typeId} - Market statistics
• /v1/market/orders/{typeId} - Order book data
• /v1/market/history/{regionId}/{typeId} - Price history

Static Data APIs

• /v1/market/regions - All regions
• /v1/market/groups - All market groups
• /v1/market/groups/{groupId}/types - Types in market group

Configuration

The server connects to the EVE Tycoon API at https://evetycoon.com/api. No authentication is required for the public endpoints.

Rate Limiting

Please respect the Expires header returned by the EVE Tycoon API. The server will pass through caching information from the upstream API.

Examples

Basic Usage

Get Market Stats for PLEX in The Forge

// Using the get_market_stats tool
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

Get All Orders for a Specific Item

// Using the get_market_orders tool
{
  "typeId": 44992,       // PLEX
  "regionId": 10000002   // Optional: filter by region
}

Get Price History

// Using the get_market_history tool
{
  "regionId": 10000002,  // The Forge
  "typeId": 44992        // PLEX
}

📄 License

This project is under the MIT License.

💪 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

⚠️ Disclaimer

This is an unofficial tool and is not affiliated with CCP Games or EVE Online. EVE Online is a trademark of CCP hf.