chore: update tmcp

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.changeset/thirty-lies-jump.md

@@ -0,0 +1,5 @@
+---
+'@sveltejs/mcp': patch
+---
+
+chore: update tmcp

.github/FUNDING.yml

@@ -0,0 +1 @@
+open_collective: svelte

.github/workflows/check.yml

@@ -18,12 +18,12 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 10.18.3
+          version: 10.20.0
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/lint.yml

@@ -18,12 +18,12 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 10.18.3
+          version: 10.20.0
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies

.github/workflows/publish-mcp.yml

@@ -5,6 +5,7 @@ on:
     secrets:
       MCP_KEY:
         required: true
+  workflow_dispatch:
 
 jobs:
   publish-mcp:
@@ -19,12 +20,12 @@ jobs:
         env:
           MCP_KEY: ${{ secrets.MCP_KEY }}
         run: |
-          NAME=mcp-publisher_1.2.3_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz
-          # Download MCP Publisher pinned to v1.2.3 using latest https for security and save it to a file named mcp-publisher.tar.gz
-          curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fL "https://github.com/modelcontextprotocol/registry/releases/download/v1.2.3/$NAME" -O
+          NAME=mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz
+          # Download MCP Publisher pinned to v1.3.3 using latest https for security and save it to a file named mcp-publisher.tar.gz
+          curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fL "https://github.com/modelcontextprotocol/registry/releases/download/v1.3.3/$NAME" -O
 
           # Verify the SHA256 checksum of the downloaded file
-          sha256sum --ignore-missing -c ./checksums/registry_1.2.3_checksums.txt
+          sha256sum --ignore-missing -c ./checksums/registry_1.3.3_checksums.txt
 
           # Extract the tarball
           mkdir tmp

.github/workflows/test.yml

@@ -18,12 +18,12 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 10.18.3
+          version: 10.20.0
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies

.prettierignore

@@ -11,4 +11,5 @@ bun.lockb
 /**/.svelte-kit/*
 
 # Claude Code
-.claude/
+.claude/
+.changeset/

apps/mcp-remote/package.json

@@ -59,12 +59,13 @@
 		"typescript": "^5.0.0",
 		"vite": "^7.0.4",
 		"vite-plugin-devtools-json": "^1.0.0",
-		"vitest": "^3.2.3"
+		"vitest": "^4.0.0"
 	},
 	"dependencies": {
 		"@sveltejs/mcp-schema": "workspace:^",
 		"@sveltejs/mcp-server": "workspace:^",
-		"@tmcp/transport-http": "^0.6.3",
-		"tmcp": "^1.15.0"
+		"@tmcp/transport-http": "catalog:mcp",
+		"@vercel/analytics": "^1.5.0",
+		"tmcp": "catalog:mcp"
 	}
 }

apps/mcp-remote/src/hooks.server.ts

@@ -1,8 +1,13 @@
+import { dev } from '$app/environment';
 import { http_transport } from '$lib/mcp/index.js';
 import { db } from '$lib/server/db/index.js';
 import { redirect } from '@sveltejs/kit';
+import { track } from '@vercel/analytics/server';
 
 export async function handle({ event, resolve }) {
+	if (event.request.method === 'POST') {
+		console.log(await event.request.clone().text());
+	}
 	if (event.request.method === 'GET') {
 		const accept = event.request.headers.get('accept');
 		if (accept) {
@@ -16,6 +21,12 @@ export async function handle({ event, resolve }) {
 	}
 	const mcp_response = await http_transport.respond(event.request, {
 		db,
+		// only add analytics in production
+		track: dev
+			? undefined
+			: async (session_id, event, slug) => {
+					await track(event, { session_id, ...(slug ? { slug } : {}) });
+				},
 	});
 	// we are deploying on vercel the SSE connection will timeout after 5 minutes...for
 	// the moment we are not sending back any notifications (logs, or list changed notifications)
@@ -25,11 +36,14 @@ export async function handle({ event, resolve }) {
 	// 200 or the MCP client will complain)
 	if (mcp_response && event.request.method === 'GET') {
 		try {
-			await mcp_response.body?.cancel();
-		} catch {
-			// ignore
+			return mcp_response;
+		} finally {
+			try {
+				await mcp_response.body?.cancel();
+			} catch {
+				// ignore
+			}
 		}
-		return new Response('', { status: 200 });
 	}
 	return mcp_response ?? resolve(event);
 }

apps/mcp-remote/src/lib/mcp/index.ts

@@ -3,4 +3,5 @@ import { HttpTransport } from '@tmcp/transport-http';
 
 export const http_transport = new HttpTransport(server, {
 	cors: true,
+	path: '/mcp',
 });

apps/mcp-remote/src/lib/server/db/index.ts

@@ -1,8 +1,6 @@
 import { createClient } from '@libsql/client';
 import { drizzle } from 'drizzle-orm/libsql';
 import * as schema from './schema.js';
-// let's disable it for the moment...i can't figure out a way to make it wotk with eslint
-// eslint-disable-next-line import/extensions
 import { DATABASE_TOKEN, DATABASE_URL } from '$env/static/private';
 if (!DATABASE_URL) throw new Error('DATABASE_URL is not set');
 if (!DATABASE_TOKEN) throw new Error('DATABASE_TOKEN is not set');

documentation/docs/20-setup/30-remote-setup.md

@@ -96,6 +96,27 @@ It will open a file with your MCP servers where you can add the following config
 }
 ```
 
+## GitHub Coding Agent
+
+- Open your repository in GitHub
+- Go to Settings
+- Open Copilot > Coding agent
+- Edit the MCP configuration
+
+```json
+{
+	"mcpServers": {
+		"svelte": {
+			"type": "http",
+			"url": "https://mcp.svelte.dev/mcp",
+			"tools": ["*"]
+		}
+	}
+}
+```
+
+- Click _Save MCP configuration_
+
 ## Other clients
 
 If we didn't include the MCP client you are using, refer to their documentation for `remote` servers and use `https://mcp.svelte.dev/mcp` as the URL.

documentation/docs/30-capabilities/30-prompts.md

@@ -25,6 +25,7 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: drizzle, use_cases: database setup, sql queries, orm integration, data modeling, postgresql, mysql, sqlite, server-side data access, database migrations, type-safe queries, path: cli/drizzle
 - title: eslint, use_cases: code quality, linting, error detection, project setup, code standards, team collaboration, typescript projects, path: cli/eslint
 - title: lucia, use_cases: authentication, login systems, user management, registration pages, session handling, auth setup, path: cli/lucia
+- title: mcp, use_cases: use title and path to estimate use case, path: cli/mcp
 - title: mdsvex, use_cases: blog, content sites, markdown rendering, documentation sites, technical writing, cms integration, article pages, path: cli/mdsvex
 - title: paraglide, use_cases: internationalization, multi-language sites, i18n, translation, localization, language switching, global apps, multilingual content, path: cli/paraglide
 - title: playwright, use_cases: browser testing, e2e testing, integration testing, test automation, quality assurance, ci/cd pipelines, testing user flows, path: cli/playwright

eslint.config.js

@@ -13,7 +13,7 @@ const gitignore_path = fileURLToPath(new URL('./.gitignore', import.meta.url));
 export default /** @type {import("eslint").Linter.Config} */ ([
 	includeIgnoreFile(gitignore_path),
 	{
-		ignores: ['.claude/**/*'],
+		ignores: ['.claude/**/*', '.changeset/*'],
 	},
 	js.configs.recommended,
 	...ts.configs.recommended,
@@ -48,13 +48,17 @@ export default /** @type {import("eslint").Linter.Config} */ ([
 			'import/no-unresolved': 'off', // this doesn't work well with typescript path mapping
 			'import/extensions': [
 				'error',
-				'ignorePackages',
 				{
-					js: 'always',
-					mjs: 'always',
-					cjs: 'always',
-					ts: 'always',
-					svelte: 'always',
+					ignorePackages: true,
+					pattern: {
+						js: 'always',
+						mjs: 'always',
+						cjs: 'always',
+						ts: 'always',
+						svelte: 'always',
+						svg: 'always',
+						json: 'always',
+					},
 				},
 			],
 		},

package.json

@@ -3,7 +3,7 @@
 	"version": "0.0.1",
 	"description": "The official Svelte MCP server implementation",
 	"type": "module",
-	"packageManager": "pnpm@10.18.3",
+	"packageManager": "pnpm@10.20.0",
 	"scripts": {
 		"build": "pnpm -r run build",
 		"dev": "pnpm --filter @sveltejs/mcp-remote run dev",
@@ -46,7 +46,7 @@
 		"publint": "^0.3.13",
 		"typescript": "^5.0.0",
 		"typescript-eslint": "^8.44.1",
-		"vitest": "^3.2.3"
+		"vitest": "^4.0.0"
 	},
 	"pnpm": {
 		"onlyBuiltDependencies": [

packages/mcp-server/package.json

@@ -20,22 +20,23 @@
 		"drizzle-orm": "^0.44.0"
 	},
 	"dependencies": {
+		"@mcp-ui/server": "^5.12.0",
 		"@sveltejs/mcp-schema": "workspace:^",
-		"@tmcp/adapter-valibot": "^0.1.4",
+		"@tmcp/adapter-valibot": "catalog:mcp",
 		"@typescript-eslint/parser": "^8.44.0",
 		"eslint": "^9.36.0",
-		"eslint-plugin-svelte": "^3.12.3",
+		"eslint-plugin-svelte": "^3.12.5",
 		"svelte": "^5.39.2",
-		"svelte-eslint-parser": "^1.3.2",
-		"tmcp": "^1.15.0",
+		"svelte-eslint-parser": "^1.4.0",
+		"tmcp": "catalog:mcp",
 		"ts-blank-space": "^0.6.2",
 		"typescript-eslint": "^8.44.0",
 		"valibot": "^1.1.0",
-		"vitest": "^3.2.4",
+		"vitest": "^4.0.0",
 		"zimmerframe": "^1.1.4"
 	},
 	"devDependencies": {
-		"@anthropic-ai/sdk": "^0.67.0",
+		"@anthropic-ai/sdk": "^0.68.0",
 		"@sveltejs/kit": "^2.42.2",
 		"@types/eslint-scope": "^8.3.2",
 		"@types/estree": "^1.0.8",

packages/mcp-server/src/constants.ts

@@ -11,6 +11,7 @@ export const base_runes = [
 export const nested_runes = [
 	'$state.raw',
 	'$state.snapshot',
+	'$state.eager',
 	'$effect.pre',
 	'$effect.tracking',
 	'$effect.pending',

packages/mcp-server/src/mcp/autofixers/add-autofixers-issues.ts

@@ -8,6 +8,7 @@ export function add_autofixers_issues(
 	code: string,
 	desired_svelte_version: number,
 	filename = 'Component.svelte',
+	async = false,
 ) {
 	const parsed = parse(code, filename);
 
@@ -15,7 +16,7 @@ export function add_autofixers_issues(
 	for (const autofixer of Object.values(autofixers)) {
 		walk(
 			parsed.ast as unknown as Node,
-			{ output: content, parsed, desired_svelte_version },
+			{ output: content, parsed, desired_svelte_version, async },
 			autofixer,
 		);
 	}

packages/mcp-server/src/mcp/autofixers/add-compile-issues.ts

@@ -7,6 +7,7 @@ export function add_compile_issues(
 	code: string,
 	desired_svelte_version: number,
 	filename = 'Component.svelte',
+	async = false,
 ) {
 	let compile = compile_component;
 	const extension = extname(filename);
@@ -27,6 +28,7 @@ export function add_compile_issues(
 		filename: filename || 'Component.svelte',
 		generate: false,
 		runes: desired_svelte_version >= 5,
+		experimental: { async },
 	});
 
 	for (const warning of compilation_result.warnings) {

packages/mcp-server/src/mcp/autofixers/add-eslint-issues.ts

@@ -51,7 +51,7 @@ function base_config(svelte_config: Config): ESLint.Options['baseConfig'] {
 	];
 }
 
-function get_linter(version: number) {
+function get_linter(version: number, async = false) {
 	if (version < 5) {
 		return (svelte_4_linter ??= new ESLint({
 			overrideConfigFile: true,
@@ -67,6 +67,7 @@ function get_linter(version: number) {
 		baseConfig: base_config({
 			compilerOptions: {
 				runes: true,
+				experimental: { async },
 			},
 		}),
 	}));
@@ -77,8 +78,9 @@ export async function add_eslint_issues(
 	code: string,
 	desired_svelte_version: number,
 	filename = 'Component.svelte',
+	async = false,
 ) {
-	const eslint = get_linter(desired_svelte_version);
+	const eslint = get_linter(desired_svelte_version, async);
 	const results = await eslint.lintText(code, { filePath: filename || './Component.svelte' });
 
 	for (const message of results[0]?.messages ?? []) {

packages/mcp-server/src/mcp/autofixers/visitors/index.ts

@@ -7,6 +7,7 @@ export type AutofixerState = {
 	output: { issues: string[]; suggestions: string[] };
 	parsed: ParseResult;
 	desired_svelte_version: number;
+	async?: boolean;
 };
 
 export type Autofixer = Visitors<Node | AST.SvelteNode, AutofixerState>;

packages/mcp-server/src/mcp/handlers/prompts/svelte-task.ts

@@ -68,6 +68,9 @@ export function setup_svelte_task(server: SvelteMcp) {
 			icons,
 		},
 		async ({ task }) => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(server.ctx.sessionId, 'svelte-task');
+			}
 			const available_docs = await format_sections_list();
 
 			return {

packages/mcp-server/src/mcp/handlers/resources/doc-section.ts

@@ -46,6 +46,13 @@ export async function list_sections(server: SvelteMcp) {
 			icons,
 		},
 		async (uri, { slug }) => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(
+					server.ctx.sessionId,
+					'svelte-doc-section',
+					Array.isArray(slug) ? slug.join(',') : slug,
+				);
+			}
 			const section = sections.find((section) => {
 				return slug === section.slug;
 			});

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

@@ -21,6 +21,9 @@ export function get_documentation(server: SvelteMcp) {
 			icons,
 		},
 		async ({ section }) => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(server.ctx.sessionId, 'get-documentation');
+			}
 			let sections: string[];
 
 			if (Array.isArray(section)) {

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

@@ -12,6 +12,9 @@ export function list_sections(server: SvelteMcp) {
 			icons,
 		},
 		async () => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(server.ctx.sessionId, 'list-sections');
+			}
 			const formatted_sections = await format_sections_list();
 
 			return {

packages/mcp-server/src/mcp/handlers/tools/playground-link.ts

@@ -1,6 +1,7 @@
 import type { SvelteMcp } from '../../index.js';
 import * as v from 'valibot';
 import { icons } from '../../icons/index.js';
+import { createUIResource } from '@mcp-ui/server';
 
 async function compress_and_encode_text(input: string) {
 	const reader = new Blob([input]).stream().pipeThrough(new CompressionStream('gzip')).getReader();
@@ -58,6 +59,9 @@ export function playground_link(server: SvelteMcp) {
 			icons,
 		},
 		async ({ files, name, tailwind }) => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(server.ctx.sessionId, 'playground-link');
+			}
 			const playground_base = new URL('https://svelte.dev/playground');
 			const playground_files: File[] = [];
 
@@ -75,6 +79,9 @@ export function playground_link(server: SvelteMcp) {
 			}
 
 			if (!has_app_svelte) {
+				if (server.ctx.sessionId && server.ctx.custom?.track) {
+					await server.ctx.custom?.track?.(server.ctx.sessionId, 'playground-link-no-app-svelte');
+				}
 				return {
 					isError: true,
 					content: [
@@ -100,12 +107,26 @@ export function playground_link(server: SvelteMcp) {
 				url: playground_base.toString(),
 			};
 
+			// use the embed path to have a cleaner UI for mcp-ui
+			playground_base.pathname = '/playground/embed';
+
 			return {
 				content: [
 					{
 						type: 'text',
 						text: JSON.stringify(content),
 					},
+					createUIResource({
+						uri: 'ui://svelte/playground-link',
+						content: {
+							type: 'externalUrl',
+							iframeUrl: playground_base.toString(),
+						},
+						uiMetadata: {
+							'preferred-frame-size': ['100%', '1200px'],
+						},
+						encoding: 'text',
+					}),
 				],
 				structuredContent: content,
 			};

packages/mcp-server/src/mcp/handlers/tools/svelte-autofixer.test.ts

@@ -0,0 +1,155 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { server } from '../../index.js';
+
+/**
+ * Small utility to create a JSON-RPC request without having to always specify as const
+ */
+function request<const T>(request: T) {
+	return request;
+}
+
+async function autofixer_tool_call(
+	code: string,
+	is_error = false,
+	desired_svelte_version = 5,
+	async = false,
+) {
+	const result = await server.receive({
+		jsonrpc: '2.0',
+		id: 2,
+		method: 'tools/call',
+		params: {
+			name: 'svelte-autofixer',
+			arguments: {
+				code,
+				desired_svelte_version,
+				filename: 'App.svelte',
+				async,
+			},
+		},
+	});
+
+	expect(result).toBeDefined();
+	expect(result.result).toBeDefined();
+	if (is_error) {
+		return result.result;
+	}
+	expect(result.result.structuredContent).toBeDefined();
+	return result.result.structuredContent;
+}
+
+describe('svelte-autofixer tool', () => {
+	beforeEach(async () => {
+		const initialize_request = request({
+			jsonrpc: '2.0',
+			id: 1,
+			method: 'initialize',
+			params: {
+				protocolVersion: '2025-06-18',
+				capabilities: {
+					roots: { listChanged: true },
+				},
+				clientInfo: {
+					name: 'test-client',
+					version: '1.0.0',
+				},
+			},
+		});
+
+		await server.receive(initialize_request, {
+			sessionId: 'svelte-autofixer-session',
+		});
+	});
+
+	it('should add suggestions for js parse errors', async () => {
+		const content = await autofixer_tool_call(`<script>
+			$state count = 0;
+		</script>`);
+		expect(content.issues.length).toBeGreaterThan(0);
+		expect(content.suggestions).toContain(
+			"The code can't be compiled because a Javascript parse error. In case you are using runes like this `$state variable_name = 3;` or `$derived variable_name = 3 * count` that's not how runes are used. You need to use them as function calls without importing them: `const variable_name = $state(3)` and `const variable_name = $derived(3 * count)`.",
+		);
+	});
+
+	it('should error out if async is true with a version less than 5', async () => {
+		const content = await autofixer_tool_call(
+			`<script>
+			$state count = 0;
+		</script>`,
+			true,
+			4,
+			true,
+		);
+		expect(content.isError).toBeTruthy();
+		expect(content.content[0]).toBeDefined();
+		expect(content.content[0].text).toBe(
+			'The async option can only be used with Svelte version 5 or higher.',
+		);
+	});
+
+	it('should not add suggestion/issues if async is true and await is used in the template/derived', async () => {
+		const content = await autofixer_tool_call(
+			`<script>
+			import { slow_double } from './utils.js';
+			let count = $state(0);
+			let double = $derived(await slow_double(count));
+		</script>
+		
+		{double}
+		{await slow_double(count)}`,
+			false,
+			5,
+			true,
+		);
+		expect(content.issues).toHaveLength(0);
+		expect(content.suggestions).toHaveLength(0);
+		expect(content.require_another_tool_call_after_fixing).toBeFalsy();
+	});
+
+	it('should add suggestion/issues if async is false and await is used in the template/derived', async () => {
+		const content = await autofixer_tool_call(
+			`<script>
+			import { slow_double } from './utils.js';
+			let count = $state(0);
+			let double = $derived(await slow_double(count));
+		</script>
+		
+		{double}
+		{await slow_double(count)}`,
+			false,
+			5,
+		);
+		expect(content.issues.length).toBeGreaterThanOrEqual(1);
+		expect(content.issues).toEqual(
+			expect.arrayContaining([expect.stringContaining('experimental_async')]),
+		);
+		expect(content.require_another_tool_call_after_fixing).toBeTruthy();
+	});
+
+	it('should add suggestions for css invalid identifier', async () => {
+		const content = await autofixer_tool_call(`<script>
+				let my_color = $state('red');
+			</script>
+							
+			<style>
+				.my-class {
+					color: {my_color};
+				}
+			</style>`);
+
+		expect(content.issues.length).toBeGreaterThan(0);
+		expect(content.suggestions).toContain(
+			"The code can't be compiled because a valid CSS identifier is expected. This sometimes means you are trying to use a variable in CSS like this: `color: {my_color}` but Svelte doesn't support that. You can use inline CSS variables for that `<div style:--color={my_color}></div>` and then use the variable as usual in CSS with `color: var(--color)`.",
+		);
+	});
+
+	it('should error in case the passed in version is different from 4 or 5', async () => {
+		const content = await autofixer_tool_call(`whatever`, true, 3);
+
+		expect(content.content).toBeDefined();
+		expect(content.content[0]).toBeDefined();
+		expect(content.content[0].text).toContain(
+			'The desired_svelte_version MUST be either 4 or 5 but received "3"',
+		);
+	});
+});

packages/mcp-server/src/mcp/handlers/tools/svelte-autofixer.ts

@@ -21,6 +21,12 @@ export function svelte_autofixer(server: SvelteMcp) {
 						'The desired svelte version...if possible read this from the package.json of the user project, otherwise use some hint from the wording (if the user asks for runes it wants version 5). Default to 5 in case of doubt.',
 					),
 				),
+				async: v.pipe(
+					v.optional(v.boolean()),
+					v.description(
+						'If true the code is an async component/module and might use await in the markup or top-level awaits in the script tag. If possible check the svelte.config.js/svelte.config.ts to check if the option is enabled otherwise asks the user if they prefer using it or not. You can only use this option if the version is 5.',
+					),
+				),
 				filename: v.pipe(
 					v.optional(v.string()),
 					v.description(
@@ -45,13 +51,20 @@ export function svelte_autofixer(server: SvelteMcp) {
 			code,
 			filename: filename_or_path,
 			desired_svelte_version: desired_svelte_version_unchecked,
+			async,
 		}) => {
+			if (server.ctx.sessionId && server.ctx.custom?.track) {
+				await server.ctx.custom?.track?.(server.ctx.sessionId, 'svelte-autofixer');
+			}
 			// we validate manually because some clients don't support union in the input schema (looking at you cursor)
 			const parsed_version = v.safeParse(
 				v.union([v.literal(4), v.literal(5), v.literal('4'), v.literal('5')]),
 				desired_svelte_version_unchecked,
 			);
 			if (parsed_version.success === false) {
+				if (server.ctx.sessionId && server.ctx.custom?.track) {
+					await server.ctx.custom?.track?.(server.ctx.sessionId, 'svelte-autofixer-wrong-version');
+				}
 				return {
 					isError: true,
 					content: [
@@ -65,6 +78,18 @@ export function svelte_autofixer(server: SvelteMcp) {
 
 			const desired_svelte_version = parsed_version.output;
 
+			if (async && +desired_svelte_version < 5) {
+				return {
+					isError: true,
+					content: [
+						{
+							type: 'text',
+							text: `The async option can only be used with Svelte version 5 or higher.`,
+						},
+					],
+				};
+			}
+
 			const content: {
 				issues: string[];
 				suggestions: string[];
@@ -76,11 +101,11 @@ export function svelte_autofixer(server: SvelteMcp) {
 
 				const filename = filename_or_path ? basename(filename_or_path) : 'Component.svelte';
 
-				add_compile_issues(content, code, +desired_svelte_version, filename);
+				add_compile_issues(content, code, +desired_svelte_version, filename, async);
 
-				add_autofixers_issues(content, code, +desired_svelte_version, filename);
+				add_autofixers_issues(content, code, +desired_svelte_version, filename, async);
 
-				await add_eslint_issues(content, code, +desired_svelte_version, filename);
+				await add_eslint_issues(content, code, +desired_svelte_version, filename, async);
 			} catch (e: unknown) {
 				const error = e as Error & { start?: { line: number; column: number } };
 				content.issues.push(
@@ -90,6 +115,10 @@ export function svelte_autofixer(server: SvelteMcp) {
 					content.suggestions.push(
 						"The code can't be compiled because a Javascript parse error. In case you are using runes like this `$state variable_name = 3;` or `$derived variable_name = 3 * count` that's not how runes are used. You need to use them as function calls without importing them: `const variable_name = $state(3)` and `const variable_name = $derived(3 * count)`.",
 					);
+				} else if (error.message.includes('css_expected_identifier')) {
+					content.suggestions.push(
+						"The code can't be compiled because a valid CSS identifier is expected. This sometimes means you are trying to use a variable in CSS like this: `color: {my_color}` but Svelte doesn't support that. You can use inline CSS variables for that `<div style:--color={my_color}></div>` and then use the variable as usual in CSS with `color: var(--color)`.",
+					);
 				}
 			}
 

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

@@ -24,7 +24,10 @@ export const server = new McpServer(
 		instructions:
 			'This is the official Svelte MCP server. It MUST be used whenever svelte development is involved. It can provide official documentation, code examples and correct your code. After you correct the component call this tool again to confirm all the issues are fixed.',
 	},
-).withContext<{ db: LibSQLDatabase<Schema> }>();
+).withContext<{
+	db: LibSQLDatabase<Schema>;
+	track?: (sessionId: string, event: string, slug?: string) => Promise<void>;
+}>();
 
 export type SvelteMcp = typeof server;
 

packages/mcp-stdio/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @sveltejs/mcp
 
+## 0.1.11
+
+### Patch Changes
+
+- fix: add `async` parameter to `svelte-autofixer` ([#94](https://github.com/sveltejs/mcp/pull/94))
+
+- fix: install latest eslint svelte packages to support `$state.eager` ([`f6ce89f`](https://github.com/sveltejs/mcp/commit/f6ce89ff34faabc3d746a350ea347298ecfed2ec))
+
+## 0.1.10
+
+### Patch Changes
+
+- fix: add icons to `server.json` ([`02c951b`](https://github.com/sveltejs/mcp/commit/02c951baa86ac8103ffc158a202c06cfe6b15c01))
+
+- fix: add `preferred-frame-size` to UI resource ([`3fabcc0`](https://github.com/sveltejs/mcp/commit/3fabcc0f9bfee916c0deb9c2ffa931ed2168af2d))
+
+- feat: support: `$state.eager` ([#90](https://github.com/sveltejs/mcp/pull/90))
+
+## 0.1.9
+
+### Patch Changes
+
+- feat: return `mcp-ui` resource from `playground-link` ([#84](https://github.com/sveltejs/mcp/pull/84))
+
+- feat: suggest against js variables in css ([#78](https://github.com/sveltejs/mcp/pull/78))
+
+## 0.1.8
+
+### Patch Changes
+
+- fix: upgrade registry publisher cli ([`5fa2baa`](https://github.com/sveltejs/mcp/commit/5fa2baa27009f01e0e4e91cee7984b81a81c1c29))
+
 ## 0.1.7
 
 ### Patch Changes

packages/mcp-stdio/checksums/registry_1.2.3_checksums.txt

@@ -1,25 +0,0 @@
-4e7c92f289d903d4649c59f82df6e7b014caebb49d8b5c1d2466667fd6caf68c  mcp-publisher_1.2.3_darwin_amd64.tar.gz
-09637600871bec7cce25e098d6ce23b7c7577a8e537f618d24a5630d2d782afa  mcp-publisher_1.2.3_darwin_amd64.tar.gz.sbom.json
-9ac90d3182bae9af4b48fb3cd19c3cade3e52c8ea25d7aa14327326a209bcf71  mcp-publisher_1.2.3_darwin_arm64.tar.gz
-0b2cedf3f42c5a7b33bdd3f72ce7f4c938ff4fe2aca5cabd60094dc4b855c1f6  mcp-publisher_1.2.3_darwin_arm64.tar.gz.sbom.json
-868a54268f21580ec97ec9dfc4fc3442a7f69c241ee7c745c7032f2e43cdf47b  mcp-publisher_1.2.3_linux_amd64.tar.gz
-a7bce190ea1c1b5682d1b5069b20dd9c67f3688e02dbc93e7273e942097dac4d  mcp-publisher_1.2.3_linux_amd64.tar.gz.sbom.json
-319cdefb4c4f19fa35eeb0337e30be3169dbf3107a8c160651691a6342a6783b  mcp-publisher_1.2.3_linux_arm64.tar.gz
-bc9309ab843531e811990dcf637b9912c470fc38eddc13a5af0512fcef498944  mcp-publisher_1.2.3_linux_arm64.tar.gz.sbom.json
-298026e0252547046f50dcb7817239d44107f5a3ae64f4e43b6a31d0c5b89f9b  mcp-publisher_1.2.3_windows_amd64.tar.gz
-971b835ce4df2b37ddcf8591d4400dc94d1e3f730b181b325c905261b75b9e6e  mcp-publisher_1.2.3_windows_amd64.tar.gz.sbom.json
-64da67b451d0fba12f15f7b0f6ab8d71c718bb2263f90f198ff1fe15a5ff2024  mcp-publisher_1.2.3_windows_arm64.tar.gz
-f591b2153f1277cb67817763a23de9e77188fa94b893fac00e91d13160d696e3  mcp-publisher_1.2.3_windows_arm64.tar.gz.sbom.json
-265377b343500898e3c3fea798926ff2695fe7500c1225c8a97f390a5892d849  registry-1.2.3.tar.gz
-a9c03a84d2e30176d6ed7b493e7e3a8a05d446f1611a35bad6007fbe3ba80657  registry_1.2.3_darwin_amd64.tar.gz
-4db4e8a0b1f3d0ca193e5356fef89b74c0666cdf56d6f3c8fc2d0aba1cac3b55  registry_1.2.3_darwin_amd64.tar.gz.sbom.json
-2933a11990db16035e4896f394ada389166046911e6868f79b84636048dfe6fb  registry_1.2.3_darwin_arm64.tar.gz
-edd36e62f4b1c5b857da1862f20cbcf6dd3dfd9717888c08bd5c25740d8b11f6  registry_1.2.3_darwin_arm64.tar.gz.sbom.json
-59bdd9977795891220e6fdb8f79dd7d14f48166362e94699bee59e745f7c7df6  registry_1.2.3_linux_amd64.tar.gz
-7f7efb180aa312f674377e32a92ac3600e50c62e37d697d2d16acfe60227a2fd  registry_1.2.3_linux_amd64.tar.gz.sbom.json
-7fef1088a664850dd75e54a699fce6a5fb32e8ebbdc0d2869b6b34945727ba9c  registry_1.2.3_linux_arm64.tar.gz
-ca0488e5cbb04c8ee515e1b80e08b755a55d6af1784368a2f55e429137359a25  registry_1.2.3_linux_arm64.tar.gz.sbom.json
-5bc29310aacc08437dcc973cfc1e1129f7065d2050396012f5ed98c4eb0ea75b  registry_1.2.3_windows_amd64.tar.gz
-e918c604f23e6d33f9952f18eddf0e50e50d7ce3e87ca5258bf78f4f1da243ab  registry_1.2.3_windows_amd64.tar.gz.sbom.json
-394cad1e6f5e37a583defdd522edbff854de5035d6e025a195664db31b58c0c0  registry_1.2.3_windows_arm64.tar.gz
-c93df66f3257ba4b9c29f7bfded4cf04d712ec220b044ddfa019da3e4bd6475f  registry_1.2.3_windows_arm64.tar.gz.sbom.json

packages/mcp-stdio/checksums/registry_1.3.3_checksums.txt

@@ -0,0 +1,25 @@
+704f15b3ccba80990fbaaeb858e2e893120dea3ebb9340e04a36065987e089c5  mcp-publisher_darwin_amd64.tar.gz
+9eadadeb80998cd5b29e009dd3959634730d3754b9e201c0a3bb39dd6ae85933  mcp-publisher_darwin_amd64.tar.gz.sbom.json
+f80265eadc6b052d2885a7dfa47a1ecc7ca95926c143197ced747317793dcc11  mcp-publisher_darwin_arm64.tar.gz
+f063c462512eed8f2ce9610a6a125534cb552060ddb5364d8d49b32196416fbe  mcp-publisher_darwin_arm64.tar.gz.sbom.json
+1113b9d6bf59b000966c4f17752cf87b51db03dcc5482721421fd843ce3bf048  mcp-publisher_linux_amd64.tar.gz
+d3e46855b3b906aa84571b0d16384ad6074fd08709108a47d724908e91947b9d  mcp-publisher_linux_amd64.tar.gz.sbom.json
+34be13ec07490ab1250194d56820af222b49b85db6062ff848d33f9cf6eb41ce  mcp-publisher_linux_arm64.tar.gz
+a1ff3c26d53007c98301b747f97e5e241bfdb860b6a761db8627c9ba9ba71d88  mcp-publisher_linux_arm64.tar.gz.sbom.json
+9ba8b538744652c4837d08b7b83ae85d2dbea98c897cfcf4d90835df4fe075b3  mcp-publisher_windows_amd64.tar.gz
+924a0adcebd9360aed4ee5959e664e4e99b8259ed871ac91be5ace5657afba7d  mcp-publisher_windows_amd64.tar.gz.sbom.json
+a3eeab18ee6fd1d76d7ec153779ebe1bb404d7ea561f117781174e4396d90565  mcp-publisher_windows_arm64.tar.gz
+9351f3acc39f89402ce5f72be1b45f3bf1b16f8441c97496195188f276e6c227  mcp-publisher_windows_arm64.tar.gz.sbom.json
+9767b6f2afe1b60c597d4c66468d491be3466b25de8b4d4e7a21e61950856ef7  registry-1.3.3.tar.gz
+a7867ff2c15905a765dc77636d86241ea04a17d0a90f086913a3cea4fe899213  registry_darwin_amd64.tar.gz
+f0ed44b6ebdfcba40daefe7ca556f385de0cbae95dca3077c406f75cdb6abb9b  registry_darwin_amd64.tar.gz.sbom.json
+b4d93d6fc2d831d287cde79953822b434cb8406eea4f38f180628df227f6569e  registry_darwin_arm64.tar.gz
+dde0ed7f350eda98eb6f474d19aa0e4c717dd9f120609949acf05d7986cf6fcc  registry_darwin_arm64.tar.gz.sbom.json
+6772a573828f3482a192c88dac4223ee71ff4f521c8819480a194757e46a8272  registry_linux_amd64.tar.gz
+ac177354d5f43f86bdf7f36738837a2792ba136198209eb61d4d4dd9ab408853  registry_linux_amd64.tar.gz.sbom.json
+61c1fb9126977e0694d5aad8990a9d4c2d0e933e6aa469789559fad3865e8b7f  registry_linux_arm64.tar.gz
+9b81dfe2c81c49f7731072b8c217f05d609f7094ea94aaf9491f33880f2dec7f  registry_linux_arm64.tar.gz.sbom.json
+7fb5752de50a841614c6990f20807820bda33a72eaf7be51ae6cbd4e9acb2b87  registry_windows_amd64.tar.gz
+fd44139231d4725c75b2a5a96fb670d3137f628db91c8281f6348e842792d514  registry_windows_amd64.tar.gz.sbom.json
+a85ba7eb1a06a9e668b8a2097e00ab010e454a2afeb4e29ebeb7b702a31cccd3  registry_windows_arm64.tar.gz
+93503683d32a2971b741e87f2879cb2a3f41acd184c618e04d17a98926915f2d  registry_windows_arm64.tar.gz.sbom.json

packages/mcp-stdio/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/mcp",
-	"version": "0.1.7",
+	"version": "0.1.11",
 	"type": "module",
 	"license": "MIT",
 	"mcpName": "dev.svelte/mcp",
@@ -32,15 +32,15 @@
 	},
 	"devDependencies": {
 		"@sveltejs/mcp-server": "workspace:^",
-		"@tmcp/transport-stdio": "^0.3.1",
+		"@tmcp/transport-stdio": "catalog:mcp",
 		"@types/node": "^22.15.17",
 		"publint": "^0.3.13",
 		"tsdown": "^0.15.0",
 		"typescript": "^5.8.3",
-		"vitest": "^3.1.3"
+		"vitest": "^4.0.0"
 	},
 	"dependencies": {
 		"eslint": "^9.36.0",
-		"tmcp": "^1.15.0"
+		"tmcp": "catalog:mcp"
 	}
 }

packages/mcp-stdio/server.json

@@ -8,13 +8,23 @@
 		"subfolder": "packages/mcp-stdio",
 		"source": "github"
 	},
-	"version": "0.1.7",
+	"version": "0.1.11",
 	"websiteUrl": "https://svelte.dev/docs/mcp/overview",
+	"icons": [
+		{
+			"src": "https://mcp.svelte.dev/logo.svg",
+			"mimeType": "image/svg+xml"
+		},
+		{
+			"src": "https://mcp.svelte.dev/logo.png",
+			"mimeType": "image/png"
+		}
+	],
 	"packages": [
 		{
 			"registryType": "npm",
 			"identifier": "@sveltejs/mcp",
-			"version": "0.1.7",
+			"version": "0.1.11",
 			"runtimeHint": "npx",
 			"transport": {
 				"type": "stdio"

pnpm-workspace.yaml

@@ -3,3 +3,10 @@ packages:
   - './apps/*'
 
 useNodeVersion: 22.19.0
+
+catalogs:
+  mcp:
+    tmcp: '^1.16.0'
+    '@tmcp/transport-http': '^0.8.0'
+    '@tmcp/transport-stdio': '^0.4.0'
+    '@tmcp/adapter-valibot': '^0.1.4'