Disney Parks MCP Server

Instructions

Implementation Reference

• src/tools/discover.ts:55-130 (handler)

  The main execution logic for the 'discover' tool, using semanticSearch to find matching Disney entities based on natural language query.
  export const handler: ToolHandler = async (args) => { return withTimeout( "discover", async () => { const query = args.query as string | undefined; const destination = args.destination as DestinationId | undefined; const entityType = args.entityType as EntityType | undefined; const limit = Math.min( Math.max((args.limit as number | undefined) ?? DEFAULT_DISCOVER_LIMIT, 1), MAX_DISCOVER_LIMIT ); if (!query) { return formatErrorResponse(new ValidationError("'query' is required", "query", null)); } try { const results = await semanticSearch<DisneyEntity>(query, { destinationId: destination, entityType, limit, minScore: DEFAULT_MIN_SIMILARITY_SCORE, }); if (results.length === 0) { return { content: [ { type: "text" as const, text: JSON.stringify( { query, found: false, message: "No matching entities found. Run initialize first to load data and generate embeddings.", }, null, 2 ), }, ], }; } return { content: [ { type: "text" as const, text: JSON.stringify( { query, found: true, count: results.length, results: results.map((r) => ({ name: r.entity.name, id: r.entity.id, type: r.entity.entityType, destination: r.entity.destinationId, park: r.entity.parkName, score: Math.round(r.score * 100) / 100, distance: Math.round(r.distance * 1000) / 1000, })), }, null, 2 ), }, ], }; } catch (error) { return formatErrorResponse(error); } }, TIMEOUTS.SEARCH ); };
• src/tools/discover.ts:20-53 (schema)

  Tool definition and input schema for the 'discover' tool, specifying parameters like query, destination, entityType, and limit.
  export const definition: ToolDefinition = { name: "discover", description: "Discover Disney experiences using natural language. " + "Uses semantic search to find entities matching concepts like 'thrill rides for teenagers', " + "'romantic dinner spots', or 'character breakfast'. " + "Requires initialize to be run first. For exact name lookups, use search instead.", inputSchema: { type: "object" as const, properties: { query: { type: "string", description: "Natural language query describing what you're looking for " + "(e.g., 'thrill rides', 'romantic dinner', 'kid-friendly attractions')", }, destination: { type: "string", description: "Limit search to a destination: 'wdw' or 'dlr'", enum: ["wdw", "dlr"], }, entityType: { type: "string", description: "Filter by entity type", enum: ["ATTRACTION", "RESTAURANT", "SHOW"], }, limit: { type: "number", description: `Maximum number of results (default: ${DEFAULT_DISCOVER_LIMIT}, max: ${MAX_DISCOVER_LIMIT})`, }, }, required: ["query"], }, };
• src/tools/index.ts:19-37 (registration)

  Registration of the 'discover' tool (line 25) in the tools array, along with the registerTools function that adds all tools to a lookup map.
  /** All available tools */ const tools: ToolEntry[] = [ { definition: destinations.definition, handler: destinations.handler }, { definition: attractions.definition, handler: attractions.handler }, { definition: dining.definition, handler: dining.handler }, { definition: search.definition, handler: search.handler }, { definition: discover.definition, handler: discover.handler }, { definition: status.definition, handler: status.handler }, { definition: sync.definition, handler: sync.handler }, ]; /** * Register all tools into a Map for lookup. */ export function registerTools(toolMap: Map<string, ToolEntry>): void { for (const tool of tools) { toolMap.set(tool.definition.name, tool); } }