get-market-groups
Retrieve grouped market data for specific items and regions in EVE Online. Input a region ID and type ID to access organized market information via the MCP server.
Instructions
Get grouped market data for a region and type
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region_id | Yes | Region ID to get market groups from | |
| type_id | Yes | Item type ID to get groups for |
Implementation Reference
- src/index.ts:352-380 (handler)Handler function that fetches grouped market data (buy/sell statistics) from the EVE Online ESI API endpoint /markets/{region_id}/types/{type_id}/ and returns formatted JSON text response.
async ({ region_id, type_id }) => { const groups = await makeESIRequest<MarketGroup>( `/markets/${region_id}/types/${type_id}/` ); return { content: [ { type: "text", text: JSON.stringify({ buy: { volume: groups.buy.volume, weighted_average: groups.buy.weighted_average, max: groups.buy.max, min: groups.buy.min, median: groups.buy.median }, sell: { volume: groups.sell.volume, weighted_average: groups.sell.weighted_average, max: groups.sell.max, min: groups.sell.min, median: groups.sell.median } }, null, 2) } ] }; } - src/index.ts:348-351 (schema)Zod input schema defining parameters: region_id (required number) and type_id (required number).
{ region_id: z.number().describe("Region ID to get market groups from"), type_id: z.number().describe("Item type ID to get groups for"), }, - src/index.ts:345-381 (registration)Registration of the 'get-market-groups' tool using McpServer.tool(), including description, input schema, and handler function.
server.tool( "get-market-groups", "Get grouped market data for a region and type", { region_id: z.number().describe("Region ID to get market groups from"), type_id: z.number().describe("Item type ID to get groups for"), }, async ({ region_id, type_id }) => { const groups = await makeESIRequest<MarketGroup>( `/markets/${region_id}/types/${type_id}/` ); return { content: [ { type: "text", text: JSON.stringify({ buy: { volume: groups.buy.volume, weighted_average: groups.buy.weighted_average, max: groups.buy.max, min: groups.buy.min, median: groups.buy.median }, sell: { volume: groups.sell.volume, weighted_average: groups.sell.weighted_average, max: groups.sell.max, min: groups.sell.min, median: groups.sell.median } }, null, 2) } ] }; } ); - src/index.ts:53-72 (schema)TypeScript interface defining the expected structure of market group data (buy and sell objects with volume, weighted_average, max, min, stddev, median, percentile) from ESI API.
interface MarketGroup { buy: { volume: number; weighted_average: number; max: number; min: number; stddev: number; median: number; percentile: number; }; sell: { volume: number; weighted_average: number; max: number; min: number; stddev: number; median: number; percentile: number; }; }