list_zones
Filter and prioritize available memory zones by relevance using a specified reason, enabling efficient information retrieval in the MCP Elasticsearch Knowledge Graph.
Instructions
List all available memory zones with metadata. When a reason is provided, zones will be filtered and prioritized based on relevance to your needs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Reason for listing zones. What zones are you looking for? Why are you looking for them? The AI will use this to prioritize and filter relevant zones. |
Implementation Reference
- src/index.ts:1098-1163 (handler)Handler for the list_zones tool. Retrieves memory zones using kgClient.listMemoryZones(reason). If a reason is provided and AI is available, uses GroqAI to classify and prioritize zones by usefulness, formatting the response accordingly. Falls back to listing all zones with full metadata if AI fails or no reason.else if (toolName === "list_zones") { const reason = params.reason; const zones = await kgClient.listMemoryZones(reason); // If reason is provided and GroqAI is available, use AI to score zone usefulness if (reason && GroqAI.isEnabled && zones.length > 0) { try { // Get usefulness scores for each zone const usefulnessScores = await GroqAI.classifyZoneUsefulness(zones, reason); // Process zones based on their usefulness scores const processedZones = zones.map(zone => { const usefulness = usefulnessScores[zone.name] !== undefined ? usefulnessScores[zone.name] : 2; // Default to very useful (2) if not classified // Format zone info based on usefulness score if (usefulness === 0) { // Not useful return { name: zone.name, usefulness: 'not useful' }; } else if (usefulness === 1) { // A little useful return { name: zone.name, description: zone.description, usefulness: 'a little useful' }; } else { // Very useful (2) or default return { name: zone.name, description: zone.description, created_at: zone.createdAt, last_modified: zone.lastModified, config: zone.config, usefulness: 'very useful' }; } }); // Sort zones by usefulness (most useful first) processedZones.sort((a, b) => { const scoreA = usefulnessScores[a.name] !== undefined ? usefulnessScores[a.name] : 2; const scoreB = usefulnessScores[b.name] !== undefined ? usefulnessScores[b.name] : 2; return scoreB - scoreA; // Descending order }); return formatResponse({ zones: processedZones }); } catch (error) { console.error('Error classifying zones:', error); // Fall back to default behavior } } // Default behavior (no reason provided or AI failed) return formatResponse({ zones: zones.map(zone => ({ name: zone.name, description: zone.description, created_at: zone.createdAt, last_modified: zone.lastModified, usefulness: 'very useful' // Default to very useful when no AI filtering is done })) }); }
- src/index.ts:472-486 (registration)Registration of the list_zones tool in the ListToolsRequestSchema handler, including name, description, and input schema.{ name: "list_zones", description: "List all available memory zones with metadata. When a reason is provided, zones will be filtered and prioritized based on relevance to your needs.", inputSchema: { type: "object", properties: { reason: { type: "string", description: "Reason for listing zones. What zones are you looking for? Why are you looking for them? The AI will use this to prioritize and filter relevant zones." } }, additionalProperties: false, "$schema": "http://json-schema.org/draft-07/schema#" } },
- src/index.ts:475-484 (schema)Input schema for the list_zones tool, defining the optional 'reason' parameter.inputSchema: { type: "object", properties: { reason: { type: "string", description: "Reason for listing zones. What zones are you looking for? Why are you looking for them? The AI will use this to prioritize and filter relevant zones." } }, additionalProperties: false, "$schema": "http://json-schema.org/draft-07/schema#"