solar_system_name_to_id
Convert EVE Online solar system names to their corresponding IDs using the ESI API. Input up to 500 system names for accurate and efficient ID retrieval.
Instructions
Convert EVE Online solar system names to their corresponding IDs using ESI API
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| systemNames | Yes | Array of solar system names to convert to IDs (max 500). Use English proper nouns only (e.g., 'Jita', 'Amarr', 'Dodixie') |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"systemNames": {
"description": "Array of solar system names to convert to IDs (max 500). Use English proper nouns only (e.g., 'Jita', 'Amarr', 'Dodixie')",
"items": {
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"type": "array"
}
},
"required": [
"systemNames"
],
"type": "object"
}
Implementation Reference
- src/name-to-id-tools.ts:20-47 (handler)The execute handler function that implements the core logic of the solar_system_name_to_id tool. It takes system names, queries the ESI client for IDs, handles errors, and returns formatted JSON results.execute: async (args: { systemNames: string[] }) => { try { const results = await esiClient.getSolarSystemIds(args.systemNames); if (results.length === 0) { return JSON.stringify({ success: false, message: "No solar systems found with the provided names", results: [] }); } return JSON.stringify({ success: true, message: `Found ${results.length} solar system(s)`, results: results.map(system => ({ id: system.id, name: system.name, type: "solar_system" })) }); } catch (error) { return JSON.stringify({ success: false, message: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`, results: [] }); }
- src/name-to-id-tools.ts:50-52 (schema)Zod input schema defining the parameters for the tool: an array of up to 500 solar system names.parameters: z.object({ systemNames: z.array(z.string()).min(1).max(500).describe("Array of solar system names to convert to IDs (max 500). Use English proper nouns only (e.g., 'Jita', 'Amarr', 'Dodixie')") }),
- src/server.ts:45-45 (registration)Registration of the solarSystemNameToIdTool with the FastMCP server.server.addTool(solarSystemNameToIdTool);
- src/server.ts:3-6 (registration)Import of the solarSystemNameToIdTool for registration in the MCP server.solarSystemNameToIdTool, stationNameToIdTool, regionNameToIdTool, universalNameToIdTool
- src/esi-client.ts:255-255 (helper)Helper method in ESIClient that performs the actual ESI API search for solar system names to IDs, used by the tool handler.async getSolarSystemIds(systemNames: string[]): Promise<Array<{ id: number; name: string }>> {