@regle/mcp-server 1.14.0 → 1.14.2

package/README.md

@@ -22,7 +22,9 @@ Add to your `claude_desktop_config.json`:
 
 ### Cursor
 
-Add to your MCP settings:
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=regle&config=eyJjb21tYW5kIjoibnB4IEByZWdsZS9tY3Atc2VydmVyIn0%3D)
+
+Or add to your MCP settings:
 
 ```json
 {

package/dist/regle-mcp-server.js

@@ -21,7 +21,7 @@ var docs_data_default = {
 		},
 		{
 			"id": "advanced-usage-immutable-constructors",
-			"title": "immutable-constructors",
+			"title": "markStatic",
 			"category": "advanced-usage",
 			"path": "advanced-usage/immutable-constructors.md",
 			"content": "# Handling immutable constructors\n\nRegle works by tracking changes in the state and updating the validation rules accordingly.\n\nThis works great for objects and arrays, but not for immutable constructors (like `Decimal` from `decimal.js` or `Moment` from `moment.js`, etc...).\n\nThis constructors will be interpreted as regular objects and their properties treated as nested fields.\n\n## Default Usage\n\nTo handle these cases, you can use the `markStatic` helper to mark the value as static and treat the constructor as a regular raw Field.\n\n```vue\n<template>\n  <input :value=\"r$.decimal.$value?.toString()\" @input=\"handleDecimalInput\" />\n</template>\n\n```\n\n## Schema Usage\n\nWhen using Regle with `@regle/schemas`, you will have to also declare the static constructor in the schema.\n\n```ts\nimport { markStatic, useRegleSchema } from '@regle/core'\nimport { z } from 'zod'\n\nconst StaticDecimal = markStatic(Decimal)\n\nconst schema = z.object({\n  decimal: z.instanceof(StaticDecimal).refine((value) => value.toNumber() > 10),\n})\n\nconst { r$ } = useRegleSchema({ decimal: new StaticDecimal(0) }, schema)\n\n```\n\n## `isStatic` helper\n\nYou can use the `isStatic` helper to check if a value is a static value.\n\n```ts\nimport { isStatic } from '@regle/core';\n\nconst isStatic = isStatic(r$.$value.decimal); // true\n```\n\n## `UnwrapStatic` type helper\n\nYou can use the `UnwrapStatic` type to unwrap a static value.\n\n```ts\nimport { type UnwrapStatic } from '@regle/core';\n\ntype value = UnwrapStatic<typeof r$.$value.decimal>; // Decimal\n```\n\n## `isRegleStatic` type helper\n\nYou can use the `isRegleStatic` type helper to check if a value is a static value.\n\n```ts\nimport { type isRegleStatic } from '@regle/core';\n\ntype isStatic = isRegleStatic<typeof state.decimal>; // true\n```"
@@ -236,6 +236,13 @@ var docs_data_default = {
 			"path": "index.md",
 			"content": "<h2 class=\"hidden-title\">Vue validation library</h2>\n<h2 class=\"hidden-title\">Vue form library</h2>\n<h2 class=\"hidden-title\">Vue zod forms</h2>\n<h2 class=\"hidden-title\">Vue zod</h2>\n<h2 class=\"hidden-title\">Vuelidate Zod</h2>\n<h2 class=\"hidden-title\">Vuelidate alternative</h2>\n<h2 class=\"hidden-title\">Veevalidate alternative</h2>\n<h2 class=\"hidden-title\">Vueforms alternative</h2>\n<h2 class=\"hidden-title\">Tanstack forms alternative</h2>"
 		},
+		{
+			"id": "integrations-mcp-server",
+			"title": "Regle MCP server",
+			"category": "integrations",
+			"path": "integrations/mcp-server.md",
+			"content": "# MCP Server\n\nRegle offers an MCP server that can be used to get documentation and autocomplete in your favorite AI assistant editor.\n\nThe MCP server provides the following features:\n\n- Create form validation rules\n- Search documentation\n- Get precise information on any rule\n- Create custom rules\n- API information on every Regle helper\n\n## Cursor\n\n<a href=\"https://cursor.com/en-US/install-mcp?name=regle&config=eyJjb21tYW5kIjoibnB4IEByZWdsZS9tY3Atc2VydmVyIn0%3D\">\n  <div class=\"light-only\">\n      <img src=\"https://cursor.com/deeplink/mcp-install-dark.svg\" alt=\"Install MCP Server\" />\n  </div>\n  <div class=\"dark-only\">\n      <img src=\"https://cursor.com/deeplink/mcp-install-light.svg\" alt=\"Install MCP Server\" />\n  </div>\n</a>\n\nOr add to your `.cursor/mcp.json`\n```json\n{\n  \"mcpServers\": {\n    \"regle\": {\n      \"command\": \"npx\",\n      \"args\": [\"@regle/mcp-server\"]\n    }\n  }\n}\n```\n\n## Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"regle\": {\n      \"command\": \"npx\",\n      \"args\": [\"@regle/mcp-server\"]\n    }\n  }\n}\n```"
+		},
 		{
 			"id": "integrations-nuxt",
 			"title": "Nuxt",
@@ -259,7 +266,7 @@ var docs_data_default = {
 		},
 		{
 			"id": "introduction-devtools",
-			"title": "devtools",
+			"title": "Devtools",
 			"category": "introduction",
 			"path": "introduction/devtools.md",
 			"content": "# Regle Devtools\n\nRegle offers a devtools extension for [Vue Devtools](https://devtools.vuejs.org/) to help you debug your validation tree.\n\n![Regle Devtools Screenshot](/screenshots/devtools.png)\n\n## Installation\n\nTo enable devtools, you need to install the Regle plugin in your app.\n\n:::tip\nIf you use the `@regle/nuxt` module, the devtools will be automatically enabled.\n:::\n\n```ts [main.ts]\nimport { createApp } from 'vue';\nimport App from './App.vue';\nimport { RegleVuePlugin } from '@regle/core';\n\nconst app = createApp(App);\n\napp.use(RegleVuePlugin); // <--\n\napp.mount('#app');\n```\n\n## Usage\n\nRegle devtools can inspect every variation of `useRegle`:\n\n- `useRegle`\n- `useRules`\n- `useRegleSchema`\n- `useScopedRegle`\n- `useScopedRegleSchema`\n\nYou can inspect every nested properties and rules of the `r$` instance.\n\n:::warning\nRules details inspection is not available for `useRegleSchema`\n:::\n\n### Actions\n\nYou can perform actions on the `r$` instance by clicking on the actions buttons in the devtools.\n\n![Devtools Actions Screenshot](/screenshots/devtools-actions.png)\n\n- Validate: Validate the `r$` instance (with `$validate` method)\n- Reset validation state: Reset the validation state of the `r$` instance (with `$reset` method)\n- Restore to original state: Restore the `r$` instance to the original state (with `$reset` method)\n\n## Providing custom `r$` ids to devtools\n\nBy default, the devtools will use a generic name to display the `r$` instance. \n\nYou can provide a custom name to the `useRegle` composable to display a more descriptive name in the devtools.\n\n```ts [App.vue]\nimport { useRegle } from '@regle/core';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: { required }\n}, {\n  id: 'my-form'\n});\n```\n\n## Devtools demo\n\nYou can go in any of the [Stablitz exemples](/examples/index) and open the devtools by clicking on the <span data-title=\"vue\"></span> \"Open Devtools\" button in the bottom middle of the page.\n\n### Vite Devtools Integration\n\nRegle devtools also integrate cleanly with [Vite](https://vitejs.dev/) when you're running your app in development mode.\n\nYou should see the Regle panel show up automatically in the Vite devtools if you've installed the plugin correctly.\n\n<img src=\"/screenshots/vite-devtools.png\" alt=\"Vite Devtools with Regle panel\" width=\"100\"/>\n\nYou will see the Regle icon showing in the devtools. Just click on it!\n\n<img src=\"/screenshots/vite-devtools-regle.png\" alt=\"Vite Devtools with Regle panel\" />"
@@ -412,21 +419,21 @@ var docs_data_default = {
 			{
 				"name": "flatErrors",
 				"kind": "function",
-				"description": "Converts a nested $errors object to a flat array of string errors\n\nCan also flatten to an array containing the path of each error with the options.includePath",
+				"description": "Converts a nested `$errors` object to a flat array of error strings.\nUseful for displaying a complete list of form errors or counting total errors.\n\nWith the `includePath` option, returns errors in Standard Schema Issue format\nincluding the path to each error field.",
 				"parameters": [{
 					"name": "errors",
 					"type": "$InternalRegleErrors",
-					"description": "",
+					"description": "- The `$errors` object from a Regle instance (e.g., `r$.$errors`)",
 					"optional": false
 				}, {
 					"name": "options",
 					"type": "{ includePath: true; }",
-					"description": "",
+					"description": "- Configuration options",
 					"optional": false
 				}],
 				"returnType": "StandardSchemaV1.Issue[]",
-				"example": "",
-				"tags": {}
+				"example": "import { flatErrors, useRegle } from '@regle/core';\nimport { required, email, minLength } from '@regle/rules';\n\nconst { r$ } = useRegle(\n  { name: '', email: 'invalid' },\n  { name: { required, minLength: minLength(3) }, email: { email } }\n);\n\nawait r$.$validate();\n\n// Get flat array of error messages\nconst errors = flatErrors(r$.$errors);\n// ['This field is required', 'Value must be a valid email address']\n\n// Get errors with paths (Standard Schema format)\nconst issues = flatErrors(r$.$errors, { includePath: true });\n// [{ message: 'This field is required', path: ['name'] }, ...]",
+				"tags": { "see": "://reglejs.dev/core-concepts/displaying-errors#display-flat-errors Documentation" }
 			},
 			{
 				"name": "inferRules",
@@ -539,11 +546,11 @@ var docs_data_default = {
 			{
 				"name": "RegleVuePlugin",
 				"kind": "const",
-				"description": "",
+				"description": "Vue plugin to enable Regle devtools integration with Vue Devtools.\nProvides debugging capabilities for inspecting validation trees, states, and actions.\n\nSupports inspection of: `useRegle`, `useRules`, `useRegleSchema`, `useScopedRegle`, `useScopedRegleSchema`.\n\nNote: If using `@regle/nuxt`, devtools are automatically enabled.",
 				"parameters": [],
 				"returnType": "",
-				"example": "",
-				"tags": {}
+				"example": "// main.ts\nimport { createApp } from 'vue';\nimport { RegleVuePlugin } from '@regle/core';\nimport App from './App.vue';\n\nconst app = createApp(App);\napp.use(RegleVuePlugin);\napp.mount('#app');",
+				"tags": { "see": "://reglejs.dev/introduction/devtools Documentation" }
 			},
 			{
 				"name": "unwrapRuleParameters",
@@ -562,16 +569,16 @@ var docs_data_default = {
 			{
 				"name": "useCollectScope",
 				"kind": "function",
-				"description": "",
+				"description": "Composable to collect and merge all Regle instances created with the default `useScopedRegle` within the same scope.\nReturns a merged `r$` object allowing validation across multiple components simultaneously.\n\nChildren properties like `$value` and `$errors` are converted to arrays instead of objects.\nYou have access to all validation properties like `$error`, `$invalid`, `$validate()`, etc.",
 				"parameters": [{
 					"name": "namespace",
 					"type": "MaybeRefOrGetter<string | string[]>",
-					"description": "",
+					"description": "- Optional namespace or array of namespaces to filter which scoped instances to collect",
 					"optional": true
 				}],
-				"returnType": "{\n    r$: MergedScopedRegles<Record<string, unknown>[]> | MergedRegles<Record<string, SuperCompatibleRegleRoot>>;\n  }",
-				"example": "",
-				"tags": {}
+				"returnType": "{ r$: MergedScopedRegles<TValue>; }",
+				"example": "// ParentComponent.vue\nimport { useCollectScope } from '@regle/core';\n\nconst { r$ } = useCollectScope();\n// Or with namespace filtering\nconst { r$ } = useCollectScope('contacts');\n\n// Validate all collected forms\nconst { result, data } = await r$.$validate();\n// Access collected errors\nconsole.log(r$.$errors);",
+				"tags": { "see": "://reglejs.dev/advanced-usage/scoped-validation Documentation" }
 			},
 			{
 				"name": "useRegle",
@@ -594,7 +601,7 @@ var docs_data_default = {
 				"parameters": [],
 				"returnType": "{ regle: $InternalRegleStatusType; }",
 				"example": "",
-				"tags": {}
+				"tags": { "internal": "This is the internal function that creates the root storage for the Regle instance.\nThis allows shared logic between all `useRegle` like composables" }
 			},
 			{
 				"name": "useRules",
@@ -617,17 +624,17 @@ var docs_data_default = {
 			},
 			{
 				"name": "useScopedRegle",
-				"kind": "const",
-				"description": "",
+				"kind": "function",
+				"description": "Clone of `useRegle` that automatically registers its instance for collection by `useCollectScope`.\nEvery time it's called, a new instance is added for the parent scope to collect.\n\nCan be called multiple times anywhere in your app - not restricted to components or DOM.\nWhen the component is unmounted or scope is disposed, the instance is automatically unregistered.",
 				"parameters": [{
 					"name": "params",
 					"type": "[state: MaybeRef<TState> | DeepReactiveState<TState>, rulesFactory: TState extends PrimitiveTypes ? MaybeRefOrGetter<TDecl> : TState extends Record<...> ? MaybeRefOrComputedRef<...> | ((...args: any[]...",
 					"description": "",
 					"optional": false
 				}],
-				"returnType": "NonNullable<TState> extends PrimitiveTypes ? { r$: Raw<RegleFieldStatus<PrimitiveTypes & TState & {}, TDecl, any>>; } : { ...; }",
-				"example": "",
-				"tags": {}
+				"returnType": "NonNullable<TState> extends PrimitiveTypes ? RegleSingleField<PrimitiveTypes & TState & {}, TDecl, never, { ...; }> : Regle<...>",
+				"example": "// ChildComponent.vue\nimport { useScopedRegle } from '@regle/core';\n\nconst { r$ } = useScopedRegle(\n  { email: '' },\n  { email: { required, email } },\n  { namespace: 'contacts' }\n);",
+				"tags": { "see": "://reglejs.dev/advanced-usage/scoped-validation Documentation" }
 			},
 			{
 				"name": "variantToRef",
@@ -1656,9 +1663,23 @@ function searchApi(query) {
 	return results;
 }
 
-var version = "1.14.0";
+var version = "1.14.2";
 
-const categories = getCategories();
+function jsonResponse(data$1) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data$1, null, 2)
+	}] };
+}
+function errorResponse(error, extra) {
+	return {
+		...jsonResponse({
+			error,
+			...extra
+		}),
+		isError: true
+	};
+}
 const server = new McpServer({
 	name: "regle-mcp-server",
 	version,
@@ -1666,55 +1687,66 @@ const server = new McpServer({
 	title: "Regle MCP Server",
 	websiteUrl: "https://reglejs.dev"
 });
-server.registerTool("regle-list-docs", {
+server.registerTool("regle-list-documentation", {
 	title: "List all available Regle documentation pages",
 	inputSchema: z.object({ category: z.string().optional().describe("Filter by category (e.g., \"rules\", \"core-concepts\", \"introduction\")") })
 }, async ({ category }) => {
 	const filteredDocs = category ? getDocsByCategory(category) : docs;
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			message: "Available Regle documentation pages",
-			category: category || "all",
-			count: filteredDocs.length,
-			docs: filteredDocs.map((doc) => ({
-				id: doc.id,
-				title: doc.title
-			}))
-		}, null, 2)
-	}] };
+	return jsonResponse({
+		message: "Available Regle documentation pages",
+		category: category || "all",
+		count: filteredDocs.length,
+		docs: filteredDocs.map((doc) => ({
+			id: doc.id,
+			title: doc.title
+		}))
+	});
 });
-server.registerTool("regle-get-doc", {
+server.registerTool("regle-get-documentation", {
 	title: "Get the full content of a specific Regle documentation page",
 	inputSchema: z.object({ id: z.string().describe("The documentation page ID (e.g., \"core-concepts-rules-built-in-rules\")") })
 }, async ({ id }) => {
 	const doc = getDocById(id);
-	if (!doc) {
-		const availableIds = docs.map((d) => d.id);
-		return {
-			content: [{
-				type: "text",
-				text: JSON.stringify({
-					error: "Documentation page not found",
-					requestedId: id,
-					availableIds
-				}, null, 2)
-			}],
-			isError: true
-		};
-	}
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			id: doc.id,
-			title: doc.title,
-			category: doc.category,
-			path: doc.path,
-			content: doc.content
-		}, null, 2)
-	}] };
+	if (!doc) return errorResponse("Documentation page not found", {
+		requestedId: id,
+		availableIds: docs.map((d) => d.id)
+	});
+	return jsonResponse({
+		id: doc.id,
+		title: doc.title,
+		category: doc.category,
+		path: doc.path,
+		content: doc.content
+	});
 });
-server.registerTool("regle-search-docs", {
+server.registerTool("regle-get-usage-guide", {
+	title: "Get a comprehensive guide on how to use the useRegle composable",
+	inputSchema: z.object({})
+}, async () => {
+	const doc = getDocById("core-concepts-index");
+	if (!doc) return errorResponse("useRegle guide not found");
+	return jsonResponse({
+		id: doc.id,
+		title: doc.title,
+		category: doc.category,
+		content: doc.content
+	});
+});
+server.registerTool("regle-get-vuelidate-migration-guide", {
+	title: "Get a guide on how to migrate from Vuelidate to Regle",
+	inputSchema: z.object({})
+}, async () => {
+	const doc = getDocById("introduction-migrate-from-vuelidate");
+	if (!doc) return errorResponse("Vuelidate migration guide not found");
+	return jsonResponse({
+		id: doc.id,
+		title: doc.title,
+		category: doc.category,
+		content: doc.content
+	});
+});
+const categories = getCategories();
+server.registerTool("regle-search-documentation", {
 	title: "Search Regle documentation for specific topics, rules, or concepts",
 	inputSchema: z.object({
 		query: z.string().describe("Search query (e.g., \"required\", \"async validation\", \"useRegle\")"),
@@ -1722,53 +1754,39 @@ server.registerTool("regle-search-docs", {
 	})
 }, async ({ query, limit }) => {
 	const results = searchDocs(query).slice(0, limit);
-	if (results.length === 0) return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			query,
-			resultCount: 0,
-			results: [],
-			suggestions: categories
-		}, null, 2)
-	}] };
+	if (results.length === 0) return jsonResponse({
+		query,
+		resultCount: 0,
+		results: [],
+		suggestions: categories
+	});
 	const formattedResults = results.map((doc) => ({
 		id: doc.id,
 		title: doc.title,
 		category: doc.category,
 		preview: doc.content.substring(0, 300) + "..."
 	}));
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			query,
-			resultCount: results.length,
-			results: formattedResults
-		}, null, 2)
-	}] };
+	return jsonResponse({
+		query,
+		resultCount: results.length,
+		results: formattedResults
+	});
 });
-server.registerTool("regle-get-rules-reference", {
+server.registerTool("regle-list-rules", {
 	title: "Get a quick reference of all built-in validation rules in Regle",
 	inputSchema: z.object({})
 }, async () => {
 	const rules = getRulesFromDocs();
-	if (rules.length === 0) return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: "Built-in rules documentation not found" }, null, 2)
-		}],
-		isError: true
-	};
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			title: "Built-in Rules",
-			package: "@regle/rules",
-			count: rules.length,
-			rules: rules.map((r) => ({
-				name: r.name,
-				description: r.description
-			})),
-			usageExample: `import { useRegle } from '@regle/core';
+	if (rules.length === 0) return errorResponse("Built-in rules documentation not found");
+	return jsonResponse({
+		title: "Built-in Rules",
+		package: "@regle/rules",
+		count: rules.length,
+		rules: rules.map((r) => ({
+			name: r.name,
+			description: r.description
+		})),
+		usageExample: `import { useRegle } from '@regle/core';
 import { required, email, minLength } from '@regle/rules';
 
 const { r$ } = useRegle(
@@ -1778,44 +1796,45 @@ const { r$ } = useRegle(
     password: { required, minLength: minLength(8) }
   }
 );`,
-			fullDocId: "core-concepts-rules-built-in-rules"
-		}, null, 2)
-	}] };
+		fullDocId: "core-concepts-rules-built-in-rules"
+	});
+});
+server.registerTool("regle-get-rule-reference", {
+	title: "Get details about a specific built-in validation rule",
+	inputSchema: z.object({ name: z.string().describe("The rule name (e.g., \"required\", \"email\", \"minLength\")") })
+}, async ({ name }) => {
+	const rule = getApiByName(name);
+	if (!rule) {
+		const allRules = getRulesFromDocs();
+		return errorResponse(`Rule "${name}" not found`, { availableRules: allRules.map((r) => r.name) });
+	}
+	return jsonResponse({
+		name: rule.name,
+		description: rule.description,
+		package: "@regle/rules",
+		usageExample: rule.example,
+		fullDocId: "core-concepts-rules-built-in-rules"
+	});
 });
-server.registerTool("regle-get-validation-properties", {
+server.registerTool("regle-list-validation-properties", {
 	title: "Get documentation on all validation properties available on r$ and field objects",
 	inputSchema: z.object({})
 }, async () => {
 	const doc = getDocById("core-concepts-validation-properties");
-	if (!doc) return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: "Validation properties documentation not found" }, null, 2)
-		}],
-		isError: true
-	};
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			id: doc.id,
-			title: doc.title,
-			category: doc.category,
-			content: doc.content
-		}, null, 2)
-	}] };
+	if (!doc) return errorResponse("Validation properties documentation not found");
+	return jsonResponse({
+		id: doc.id,
+		title: doc.title,
+		category: doc.category,
+		content: doc.content
+	});
 });
-server.registerTool("regle-get-helpers-reference", {
+server.registerTool("regle-list-helpers", {
 	title: "Get a reference of all validation helper utilities available in Regle",
 	inputSchema: z.object({})
 }, async () => {
 	const helpers = getHelpersFromDocs();
-	if (helpers.length === 0) return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: "Validation helpers documentation not found" }, null, 2)
-		}],
-		isError: true
-	};
+	if (helpers.length === 0) return errorResponse("Validation helpers documentation not found");
 	const guards = helpers.filter((h) => h.category === "guard");
 	const operations = helpers.filter((h) => h.category === "operation");
 	const coerces = helpers.filter((h) => h.category === "coerce");
@@ -1823,27 +1842,25 @@ server.registerTool("regle-get-helpers-reference", {
 		name: h.name,
 		description: h.description
 	}));
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			title: "Validation Helpers",
-			package: "@regle/rules",
-			totalCount: helpers.length,
-			categories: {
-				guards: {
-					description: "Runtime and Type Guards",
-					helpers: formatHelpers(guards)
-				},
-				operations: {
-					description: "Operations Utils",
-					helpers: formatHelpers(operations)
-				},
-				coerces: {
-					description: "Coerce Utils",
-					helpers: formatHelpers(coerces)
-				}
-			},
-			usageExample: `import { createRule, type Maybe } from '@regle/core';
+	return jsonResponse({
+		title: "Validation Helpers",
+		package: "@regle/rules",
+		totalCount: helpers.length,
+		categories: {
+			guards: {
+				description: "Runtime and Type Guards",
+				helpers: formatHelpers(guards)
+			},
+			operations: {
+				description: "Operations Utils",
+				helpers: formatHelpers(operations)
+			},
+			coerces: {
+				description: "Coerce Utils",
+				helpers: formatHelpers(coerces)
+			}
+		},
+		usageExample: `import { createRule, type Maybe } from '@regle/core';
 import { isFilled, getSize } from '@regle/rules';
 
 const rule = createRule({
@@ -1855,31 +1872,26 @@ const rule = createRule({
   },
   message: 'Error'
 });`,
-			fullDocId: "core-concepts-rules-validations-helpers"
-		}, null, 2)
-	}] };
+		fullDocId: "core-concepts-rules-validations-helpers"
+	});
 });
-server.registerTool("regle-get-useregle-guide", {
-	title: "Get a comprehensive guide on how to use the useRegle composable",
-	inputSchema: z.object({})
-}, async () => {
-	const doc = getDocById("core-concepts-index");
-	if (!doc) return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: "useRegle guide not found" }, null, 2)
-		}],
-		isError: true
-	};
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			id: doc.id,
-			title: doc.title,
-			category: doc.category,
-			content: doc.content
-		}, null, 2)
-	}] };
+server.registerTool("regle-get-helper-reference", {
+	title: "Get details about a specific validation helper utility",
+	inputSchema: z.object({ name: z.string().describe("The helper name (e.g., \"isFilled\", \"getSize\", \"toNumber\")") })
+}, async ({ name }) => {
+	const helper = getApiByName(name);
+	if (!helper) {
+		const allHelpers = getHelpersFromDocs();
+		return errorResponse(`Helper "${name}" not found`, { availableHelpers: allHelpers.map((h) => h.name) });
+	}
+	return jsonResponse({
+		name: helper.name,
+		description: helper.description,
+		category: helper.tags,
+		package: "@regle/rules",
+		usageExample: helper.example,
+		fullDocId: "core-concepts-rules-validations-helpers"
+	});
 });
 const apiPackages = getApiPackages();
 server.registerTool("regle-get-api-reference", {
@@ -1892,84 +1904,53 @@ server.registerTool("regle-get-api-reference", {
 }, async ({ package: packageName, name, search }) => {
 	if (name) {
 		const apiItem = getApiByName(name, packageName);
-		if (!apiItem) return {
-			content: [{
-				type: "text",
-				text: JSON.stringify({
-					error: `API export "${name}" not found`,
-					availablePackages: apiPackages
-				}, null, 2)
-			}],
-			isError: true
-		};
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({
-				name: apiItem.name,
-				kind: apiItem.kind,
-				description: apiItem.description,
-				parameters: apiItem.parameters,
-				returnType: apiItem.returnType,
-				example: apiItem.example,
-				tags: apiItem.tags
-			}, null, 2)
-		}] };
+		if (!apiItem) return errorResponse(`API export "${name}" not found`, { availablePackages: apiPackages });
+		return jsonResponse({
+			name: apiItem.name,
+			kind: apiItem.kind,
+			description: apiItem.description,
+			parameters: apiItem.parameters,
+			returnType: apiItem.returnType,
+			example: apiItem.example,
+			tags: apiItem.tags
+		});
 	}
 	if (search) {
 		const results = searchApi(search);
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({
-				query: search,
-				resultCount: results.length,
-				results: results.map((r) => ({
-					name: r.name,
-					package: r.package,
-					kind: r.kind,
-					description: r.description.substring(0, 200) + (r.description.length > 200 ? "..." : "")
-				}))
-			}, null, 2)
-		}] };
+		return jsonResponse({
+			query: search,
+			resultCount: results.length,
+			results: results.map((r) => ({
+				name: r.name,
+				package: r.package,
+				kind: r.kind,
+				description: r.description.substring(0, 200) + (r.description.length > 200 ? "..." : "")
+			}))
+		});
 	}
 	if (packageName) {
 		const apis = getApiByPackage(packageName);
-		if (apis.length === 0) return {
-			content: [{
-				type: "text",
-				text: JSON.stringify({
-					error: `Package "${packageName}" not found or has no exports`,
-					availablePackages: apiPackages
-				}, null, 2)
-			}],
-			isError: true
-		};
-		return { content: [{
-			type: "text",
-			text: JSON.stringify({
-				package: packageName,
-				exportCount: apis.length,
-				exports: apis.map((a) => ({
-					name: a.name,
-					kind: a.kind,
-					description: a.description.substring(0, 150) + (a.description.length > 150 ? "..." : ""),
-					hasExample: !!a.example,
-					parameterCount: a.parameters.length
-				}))
-			}, null, 2)
-		}] };
+		if (apis.length === 0) return errorResponse(`Package "${packageName}" not found or has no exports`, { availablePackages: apiPackages });
+		return jsonResponse({
+			package: packageName,
+			exportCount: apis.length,
+			exports: apis.map((a) => ({
+				name: a.name,
+				kind: a.kind,
+				description: a.description.substring(0, 150) + (a.description.length > 150 ? "..." : ""),
+				hasExample: !!a.example,
+				parameterCount: a.parameters.length
+			}))
+		});
 	}
-	const packageSummary = apiPackages.map((pkg) => ({
-		package: pkg,
-		exportCount: getApiByPackage(pkg).length
-	}));
-	return { content: [{
-		type: "text",
-		text: JSON.stringify({
-			message: "Available Regle API packages",
-			packages: packageSummary,
-			usage: "Use \"package\" to list exports, \"name\" to get specific export details, or \"search\" to find exports"
-		}, null, 2)
-	}] };
+	return jsonResponse({
+		message: "Available Regle API packages",
+		packages: apiPackages.map((pkg) => ({
+			package: pkg,
+			exportCount: getApiByPackage(pkg).length
+		})),
+		usage: "Use \"package\" to list exports, \"name\" to get specific export details, or \"search\" to find exports"
+	});
 });
 async function main() {
 	const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@regle/mcp-server",
-  "version": "1.14.0",
+  "version": "1.14.2",
   "description": "MCP Server for Regle",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.24.3",