feat: simplified documentation listing

CLAUDE.md

@@ -90,12 +90,12 @@ When connected to the svelte-llm MCP server, you have access to comprehensive Sv
 
 ## Available MCP Tools:
 
-### 1. list_sections
+### 1. list-sections
 
 Use this FIRST to discover all available documentation sections. Returns a structured list with titles and paths.
 When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.
 
-### 2. get_documentation
+### 2. get-documentation
 
 Retrieves full documentation content for specific sections. Accepts single or multiple sections.
-After calling the list_sections tool, you MUST analyze the returned documentation sections and then use the get_documentation tool to fetch ALL documentation sections that are relevant for the users task.
+After calling the list-sections tool, you MUST analyze the returned documentation sections and then use the get_documentation tool to fetch ALL documentation sections that are relevant for the users task.

README.md

@@ -6,7 +6,7 @@ Repo for the official Svelte MCP server.
 
 ```
 pnpm i
-cp .env.example .env
+cp apps/mcp-remote/.env.example apps/mcp-remote/.env
 pnpm dev
 ```
 

package.json

@@ -5,6 +5,7 @@
 	"type": "module",
 	"scripts": {
 		"build": "pnpm -r run build",
+		"dev": "pnpm --filter @sveltejs/mcp-remote run dev",
 		"check": "pnpm -r run check",
 		"format": "prettier --write .",
 		"lint": "prettier --check . && eslint .",

packages/mcp-server/src/mcp/handlers/tools/get-documentation.ts

@@ -1,13 +1,14 @@
 import type { SvelteMcp } from '../../index.js';
 import * as v from 'valibot';
+import { getSections, fetchWithTimeout } from '../../utils.js';
 
 export function get_documentation(server: SvelteMcp) {
 	server.tool(
 		{
 			name: 'get-documentation',
-			enabled: () => false,
+			enabled: () => true,
 			description:
-				'Retrieves full documentation content for Svelte 5 or SvelteKit sections. Supports flexible search by title (e.g., "$state", "routing") or file path (e.g., "docs/svelte/state.md"). Can accept a single section name or an array of sections. Before running this, make sure to analyze the users query, as well as the output from list_sections (which should be called first). Then ask for ALL relevant sections the user might require. For example, if the user asks to build anything interactive, you will need to fetch all relevant runes, and so on.',
+				'Retrieves full documentation content for Svelte 5 or SvelteKit sections. Supports flexible search by title (e.g., "$state", "routing") or file path (e.g., "docs/svelte/state.md"). Can accept a single section name or an array of sections. Before running this, make sure to analyze the users query, as well as the output from list-sections (which should be called first). Then ask for ALL relevant sections the user might require. For example, if the user asks to build anything interactive, you will need to fetch all relevant runes, and so on.',
 			schema: v.object({
 				section: v.pipe(
 					v.union([v.string(), v.array(v.string())]),
@@ -17,7 +18,7 @@ export function get_documentation(server: SvelteMcp) {
 				),
 			}),
 		},
-		({ section }) => {
+		async ({ section }) => {
 			let sections: string[];
 
 			if (Array.isArray(section)) {
@@ -43,13 +44,57 @@ export function get_documentation(server: SvelteMcp) {
 				sections = [];
 			}
 
-			const sections_list = sections.length > 0 ? sections.join(', ') : 'no sections';
+			const availableSections = await getSections();
+
+			const results = await Promise.all(
+				sections.map(async (requestedSection) => {
+					const matchedSection = availableSections.find(
+						s => s.title.toLowerCase() === requestedSection.toLowerCase() ||
+						     s.url === requestedSection
+					);
+
+					if (matchedSection) {
+						try {
+							const response = await fetchWithTimeout(matchedSection.url);
+							if (response.ok) {
+								const content = await response.text();
+								return { success: true, content: `## ${matchedSection.title}\n\n${content}` };
+							} else {
+								return { success: false, content: `## ${matchedSection.title}\n\nError: Could not fetch documentation (HTTP ${response.status})` };
+							}
+						} catch (error) {
+							return { success: false, content: `## ${matchedSection.title}\n\nError: Failed to fetch documentation - ${error}` };
+						}
+					} else {
+						return { success: false, content: `## ${requestedSection}\n\nError: Section not found.` };
+					}
+				})
+			);
+
+			const hasAnySuccess = results.some(result => result.success);
+			let finalText = results.map(r => r.content).join('\n\n---\n\n');
+
+			if (!hasAnySuccess) {
+				const formattedSections = availableSections
+					.map(
+						(section) =>
+							`* title: ${section.title}, use_cases: ${section.use_cases}, path: ${section.url}`,
+					)
+					.join('\n');
+
+				const introText = 'List of available Svelte documentation sections and its inteneded uses:';
+
+				const outroText =
+					'Use the title or path with the get-documentation tool to get more details about a specific section.';
+
+				finalText += `\n\n---\n\n${introText}\n\n${formattedSections}\n\n${outroText}`;
+			}
 
 			return {
 				content: [
 					{
 						type: 'text',
-						text: `called for sections: ${sections_list}`,
+						text: finalText,
 					},
 				],
 			};

packages/mcp-server/src/mcp/handlers/tools/list-sections.ts

@@ -1,19 +1,33 @@
 import type { SvelteMcp } from '../../index.js';
+import { getSections } from '../../utils.js';
 
 export function list_sections(server: SvelteMcp) {
 	server.tool(
 		{
 			name: 'list-sections',
-			enabled: () => false,
+			enabled: () => true,
 			description:
-				'Lists all available Svelte 5 and SvelteKit documentation sections in a structured format. Returns sections as a list of "* title: [section_title], path: [file_path]" - you can use either the title or path when querying a specific section via the get_documentation tool. Always run list_sections first for any query related to Svelte development to discover available content.',
+				'Lists all available Svelte 5 and SvelteKit documentation sections in a structured format. Returns sections as a list of "* title: [section_title], use_cases: [use_cases], path: [file_path]" - you can use either the title or path when querying a specific section via the get_documentation tool. Always run list-sections first for any query related to Svelte development to discover available content.',
 		},
-		() => {
+		async () => {
+			const sections = await getSections();
+			const formattedSections = sections
+				.map(
+					(section) =>
+						`* title: ${section.title}, use_cases: ${section.use_cases}, path: ${section.url}`,
+				)
+				.join('\n');
+
+			const introText = 'List of available Svelte documentation sections and its inteneded uses:';
+
+			const outroText =
+				'Use the title or path with the get-documentation tool to get more details about a specific section.';
+
 			return {
 				content: [
 					{
 						type: 'text',
-						text: 'tool list_sections called',
+						text: `${introText}\n\n${formattedSections}\n\n${outroText}`,
 					},
 				],
 			};

packages/mcp-server/src/mcp/utils.ts

@@ -0,0 +1,36 @@
+export async function fetchWithTimeout(url: string, timeoutMs: number = 10000): Promise<Response> {
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+
+	try {
+		const response = await fetch(url, { signal: controller.signal });
+		clearTimeout(timeoutId);
+		return response;
+	} catch (error) {
+		clearTimeout(timeoutId);
+		if (error instanceof Error && error.name === 'AbortError') {
+			throw new Error(`Request timed out after ${timeoutMs}ms`);
+		}
+		throw error;
+	}
+}
+
+export async function getSections() {
+	return [
+		{
+			title: 'Overview',
+			url: 'https://svelte.dev/docs/svelte/overview/llms.txt',
+			use_cases: 'Useful when a beginner learns about Svelte',
+		},
+		{
+			title: 'Getting Started',
+			url: 'https://svelte.dev/docs/svelte/getting-started/llms.txt',
+			use_cases: 'Useful when a beginner is starting a new Svelte project',
+		},
+		{
+			title: 'Svelte Files',
+			url: 'https://svelte.dev/docs/svelte/svelte-files/llms.txt',
+			use_cases: 'Useful when a beginner is learning about Svelte files',
+		},
+	];
+}