Disney Parks MCP Server

Instructions

Implementation Reference

• src/tools/attractions.ts:61-106 (handler)

  The async handler function that executes the find_attractions tool logic, including validation, fetching attractions via client, applying filters, formatting, and returning structured response.
  export const handler: ToolHandler = async (args) => { return withTimeout( "find_attractions", async () => { // Validate destination const destination = args.destination as string | undefined; if (!destination || !["wdw", "dlr"].includes(destination)) { return formatErrorResponse( new ValidationError("destination must be 'wdw' or 'dlr'", "destination", destination) ); } const parkId = args.parkId as string | undefined; const filters = (args.filters as Record<string, unknown>) ?? {}; try { const client = getDisneyFinderClient(); let attractions = await client.getAttractions(destination as DestinationId, parkId); // Apply filters attractions = applyFilters(attractions, filters); return { content: [ { type: "text" as const, text: JSON.stringify( { destination, parkId: parkId ?? null, count: attractions.length, attractions: attractions.map(formatAttraction), }, null, 2 ), }, ], }; } catch (error) { return formatErrorResponse(error); } }, TIMEOUTS.DEFAULT ); };
• src/tools/attractions.ts:12-59 (schema)

  ToolDefinition object defining the name, description, and inputSchema (including properties for destination, parkId, and filters) for the find_attractions tool.
  export const definition: ToolDefinition = { name: "find_attractions", description: "Find attractions at Disney parks with filters. " + "Returns ride metadata including height requirements, Lightning Lane status, " + "thrill level, and single rider availability. " + "Use list_parks first to get valid destination and park IDs.", inputSchema: { type: "object" as const, properties: { destination: { type: "string", description: "Destination ID: 'wdw' (Walt Disney World) or 'dlr' (Disneyland Resort)", enum: ["wdw", "dlr"], }, parkId: { type: "string", description: "Filter to a specific park by ID (e.g., '80007944' for Magic Kingdom). " + "Get park IDs from list_parks.", }, filters: { type: "object", description: "Optional filters to narrow results", properties: { hasLightningLane: { type: "boolean", description: "Only show attractions with Lightning Lane", }, maxHeightRequirement: { type: "number", description: "Maximum height requirement in inches (e.g., 40 for kids)", }, thrillLevel: { type: "string", description: "Filter by thrill level", enum: ["family", "moderate", "thrill"], }, hasSingleRider: { type: "boolean", description: "Only show attractions with single rider line", }, }, }, }, required: ["destination"], }, };
• src/tools/index.ts:20-28 (registration)

  Registration of the find_attractions tool (via attractions.definition and attractions.handler) in the central tools array used by registerTools function.
  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 }, ];
• src/tools/attractions.ts:108-138 (helper)

  Helper function that filters the attractions list based on Lightning Lane, height requirements, thrill level, and single rider options.
  function applyFilters( attractions: DisneyAttraction[], filters: Record<string, unknown> ): DisneyAttraction[] { return attractions.filter((attr) => { // Lightning Lane filter if (filters.hasLightningLane === true) { if (!attr.lightningLane?.available) return false; } // Height requirement filter if (typeof filters.maxHeightRequirement === "number") { const maxHeight = filters.maxHeightRequirement; if (attr.heightRequirement && attr.heightRequirement.inches > maxHeight) { return false; } } // Thrill level filter if (filters.thrillLevel) { if (attr.thrillLevel !== filters.thrillLevel) return false; } // Single rider filter if (filters.hasSingleRider === true) { if (!attr.singleRider) return false; } return true; }); }
• src/tools/attractions.ts:140-189 (helper)

  Helper function that formats a raw DisneyAttraction object into a structured response format with metadata, features, accessibility, and tags.
  function formatAttraction(attr: DisneyAttraction): { id: string; name: string; slug: string | null; park: string | null; location: { latitude: number; longitude: number } | null; url: string | null; metadata: { heightRequirement: string | null; thrillLevel: string | null; experienceType: string | null; duration: string | null; }; features: { lightningLane: string; singleRider: boolean; riderSwap: boolean; photopass: boolean; virtualQueue: boolean; }; accessibility: { wheelchairAccessible: boolean; }; tags: string[]; } { return { id: attr.id, name: attr.name, slug: attr.slug, park: attr.parkName, location: attr.location, url: attr.url, metadata: { heightRequirement: attr.heightRequirement?.description ?? null, thrillLevel: attr.thrillLevel, experienceType: attr.experienceType, duration: attr.duration, }, features: { lightningLane: attr.lightningLane?.tier ?? "none", singleRider: attr.singleRider, riderSwap: attr.riderSwap, photopass: attr.photopass, virtualQueue: attr.virtualQueue, }, accessibility: { wheelchairAccessible: attr.wheelchairAccessible, }, tags: attr.tags, };