@kontent-ai/mcp-server 0.31.0 → 0.33.0

package/README.md

@@ -39,7 +39,7 @@ Before you can use the MCP server, you need:
 
 1. **A Kontent.ai account** - [Sign up](https://kontent.ai/signup) if you don't have an account.
 1. **A project** - [Create a project](https://kontent.ai/learn/docs/projects#a-create-projects) to work with.
-1. **Management API key** - [Create a Management API key](https://kontent.ai/learn/docs/apis/api-keys#a-create-management-api-keys) with appropriate permissions.
+1. **Management API key** - [Create a key](https://kontent.ai/learn/docs/apis/api-keys#a-create-management-api-keys) with appropriate permissions.
 1. **Environment ID** - [Get your environment ID](https://kontent.ai/learn/docs/environments#a-get-your-environment-id).
 
 ### 🛠 Setup Options
@@ -62,95 +62,91 @@ npx @kontent-ai/mcp-server@latest shttp
 
 ### Patch Operations Guide
 
-* **get-patch-guide** – 🚨 **REQUIRED before any patch operation**. Get patch operations guide for Kontent.ai Management API by entity type
+* **get-patch-guide** – 🚨 **REQUIRED before any patch operation**. Get patch operations guide for Kontent.ai by entity type
 
 ### Content Type Management
 
-* **get-type-mapi** – Get Kontent.ai content type by internal ID from Management API
-* **list-content-types-mapi** – Get all Kontent.ai content types from Management API
-* **add-content-type-mapi** – Add new Kontent.ai content type via Management API
-* **patch-content-type-mapi** – Update an existing Kontent.ai content type by codename using patch operations (move, addInto, remove, replace)
-* **delete-content-type-mapi** – Delete a Kontent.ai content type by codename
+* **get-content-type** – Get Kontent.ai content type by ID
+* **list-content-types** – Get all Kontent.ai content types
+* **create-content-type** – Create new Kontent.ai content type
+* **patch-content-type** – Update an existing Kontent.ai content type by codename using patch operations (move, addInto, remove, replace)
+* **delete-content-type** – Delete a Kontent.ai content type by ID
 
 ### Content Type Snippet Management
 
-* **get-type-snippet-mapi** – Get Kontent.ai content type snippet by internal ID from Management API
-* **list-content-type-snippets-mapi** – Get all Kontent.ai content type snippets from Management API
-* **add-content-type-snippet-mapi** – Add new Kontent.ai content type snippet via Management API
-* **patch-type-snippet-mapi** – Update an existing Kontent.ai content type snippet by internal ID using patch operations (move, addInto, remove, replace)
-* **delete-type-snippet-mapi** – Delete a Kontent.ai content type snippet by codename
+* **get-content-type-snippet** – Get Kontent.ai content type snippet by ID
+* **list-content-type-snippets** – Get all Kontent.ai content type snippets
+* **create-content-type-snippet** – Create new Kontent.ai content type snippet
+* **patch-content-type-snippet** – Update an existing Kontent.ai content type snippet by ID using patch operations (move, addInto, remove, replace)
+* **delete-content-type-snippet** – Delete a Kontent.ai content type snippet by ID
 
 ### Taxonomy Management
 
-* **get-taxonomy-group-mapi** – Get Kontent.ai taxonomy group by internal ID from Management API
-* **list-taxonomy-groups-mapi** – Get all Kontent.ai taxonomy groups from Management API
-* **add-taxonomy-group-mapi** – Add new Kontent.ai taxonomy group via Management API
-* **patch-taxonomy-group-mapi** – Update Kontent.ai taxonomy group using patch operations (addInto, move, remove, replace) via Management API
-* **delete-taxonomy-group-mapi** – Delete Kontent.ai taxonomy group by internal ID
+* **get-taxonomy-group** – Get Kontent.ai taxonomy group by ID
+* **list-taxonomy-groups** – Get all Kontent.ai taxonomy groups
+* **create-taxonomy-group** – Create new Kontent.ai taxonomy group
+* **patch-taxonomy-group** – Update Kontent.ai taxonomy group using patch operations (addInto, move, remove, replace)
+* **delete-taxonomy-group** – Delete Kontent.ai taxonomy group by ID
 
 ### Content Item Management
 
-* **get-item-mapi** – Get Kontent.ai item by internal ID from Management API
-* **get-latest-variant-mapi** – Get latest version of Kontent.ai language variant from Management API
-* **get-published-variant-mapi** – Get published version of Kontent.ai language variant from Management API
-* **list-variants-item-mapi** – List all Kontent.ai language variants of a content item from Management API
-* **list-variants-collection-mapi** – List Kontent.ai language variants by collection from Management API (paginated)
-* **list-variants-type-mapi** – List Kontent.ai language variants by content type from Management API (paginated)
-* **list-variants-components-type-mapi** – List Kontent.ai language variants containing components of a specific content type from Management API (paginated)
-* **list-variants-space-mapi** – List Kontent.ai language variants by space from Management API (paginated)
-* **add-content-item-mapi** – Add new Kontent.ai content item via Management API. This creates the content item structure but does not add content to language variants. Use create-language-variant-mapi to add content to the item
-* **update-content-item-mapi** – Update existing Kontent.ai content item by internal ID via Management API. The content item must already exist - this tool will not create new items
-* **delete-content-item-mapi** – Delete Kontent.ai content item by internal ID from Management API
-* **create-language-variant-mapi** – Create Kontent.ai variant assigning current user as contributor. Element values must fulfill limitations and guidelines defined in content type
-* **update-language-variant-mapi** – Update Kontent.ai language variant of a content item via Management API. Element values must fulfill limitations and guidelines defined in content type. Only provided elements will be modified
-* **create-variant-version-mapi** – Create new version of Kontent.ai language variant via Management API. This operation creates a new version of an existing language variant, useful for content versioning and creating new drafts from published content
-* **delete-language-variant-mapi** – Delete Kontent.ai language variant from Management API
-* **filter-variants-mapi** – Filter Kontent.ai items with variants returning references (item ID + language ID). Use for exact keyword matching and finding specific terms in content. Supports full filtering capabilities (content types, workflow steps, taxonomies, spaces, collections, publishing states, etc.). Returns paginated results with continuation token for fetching subsequent pages. Use bulk-get-items-variants-mapi to retrieve full content for matched items
-* **bulk-get-items-variants-mapi** – Bulk get Kontent.ai content items with their language variants by item and language reference pairs. Use after filter-variants-mapi to retrieve full content data for specific item+language pairs. Items without a variant in the requested language return the item without the variant property. Returns paginated results with continuation token
-* **search-variants-mapi** – AI-powered semantic search for finding content by meaning and concepts in a specific language variant. Use for: conceptual searches when you don't know exact keywords. Limited filtering options (variant ID only)
+* **get-content-item** – Get Kontent.ai content item by ID
+* **get-content-item-variant** – Retrieve Kontent.ai content item variant (language version/translation). Returns the current version — draft if one exists, otherwise published
+* **get-published-content-item-variant-version** – Retrieve the published version of a Kontent.ai content item variant. Use when a newer draft version exists but you need the currently published (live) content
+* **get-content-item-translations** – Get all Kontent.ai content item translations — every language version (variant) of a specific content item
+* **list-content-item-variants** – List, filter, search Kontent.ai content items with content item variants (language versions/translations)
+* **create-content-item** – Create new Kontent.ai content item (creates the container only, use create-content-item-variant to add language versions/translations)
+* **update-content-item** – Update existing Kontent.ai content item by ID. The content item must already exist - this tool will not create new items
+* **delete-content-item** – Delete Kontent.ai content item by ID
+* **create-content-item-variant** – Create Kontent.ai content item variant assigning current user as contributor. Element values must fulfill limitations and guidelines defined in content type
+* **update-content-item-variant** – Update Kontent.ai content item variant of a content item. Element values must fulfill limitations and guidelines defined in content type. Only provided elements will be modified
+* **create-new-content-item-variant-version** – Create new version of Kontent.ai content item variant. This operation creates a new version of an existing content item variant, useful for content versioning and creating new drafts from published content
+* **delete-content-item-variant** – Delete Kontent.ai content item variant
+* **bulk-get-content-item-variants** – Bulk get Kontent.ai content items with their content item variants by item and language reference pairs. Use after list-content-item-variants to retrieve full content data for specific item+language pairs. Items without a variant in the requested language return the item without the variant property. Returns paginated results with continuation token
+* **search-content-item-variants** – AI-powered semantic search for finding content by meaning and concepts in a specific content item variant. Use for: conceptual searches when you don't know exact keywords. Limited filtering options (variant ID only)
 
 ### Asset Management
 
-* **get-asset-mapi** – Get a specific Kontent.ai asset by internal ID from Management API
-* **list-assets-mapi** – Get all Kontent.ai assets from Management API
-* **update-asset-mapi** – Update Kontent.ai asset by internal ID
+* **get-asset** – Get a specific Kontent.ai asset by ID
+* **list-assets** – Get all Kontent.ai assets
+* **update-asset** – Update Kontent.ai asset by ID
 
 ### Asset Folder Management
 
-* **list-asset-folders-mapi** – List all Kontent.ai asset folders
-* **patch-asset-folders-mapi** – Modify Kontent.ai asset folders using patch operations (addInto to add new folders, rename to change names, remove to delete folders)
+* **list-asset-folders** – List all Kontent.ai asset folders
+* **patch-asset-folders** – Modify Kontent.ai asset folders using patch operations (addInto to add new folders, rename to change names, remove to delete folders)
 
 ### Language Management
 
-* **list-languages-mapi** – Get all Kontent.ai languages from Management API (includes both active and inactive - check is_active property)
-* **add-language-mapi** – Add new Kontent.ai language via Management API (languages are always created as active)
-* **patch-language-mapi** – Update Kontent.ai language using replace operations via Management API (only active languages can be modified - to activate/deactivate, use the Kontent.ai web UI)
+* **list-languages** – Get all Kontent.ai languages (includes both active and inactive - check is_active property)
+* **create-language** – Create new Kontent.ai language (languages are always created as active)
+* **patch-language** – Update Kontent.ai language using replace operations (only active languages can be modified - to activate/deactivate, use the Kontent.ai web UI)
 
 ### Collection Management
 
-* **list-collections-mapi** – Get all Kontent.ai collections from Management API. Collections set boundaries for content items in your environment and help organize content by team, brand, or project
-* **patch-collections-mapi** – Update Kontent.ai collections using patch operations (addInto to add new collections, move to reorder, remove to delete empty collections, replace to rename)
+* **list-collections** – Get all Kontent.ai collections. Collections set boundaries for content items in your environment and help organize content by team, brand, or project
+* **patch-collections** – Update Kontent.ai collections using patch operations (addInto to add new collections, move to reorder, remove to delete empty collections, replace to rename)
 
 ### Space Management
 
-* **list-spaces-mapi** – Get all Kontent.ai spaces from Management API
-* **add-space-mapi** – Add Kontent.ai space to environment
-* **patch-space-mapi** – Patch Kontent.ai space using replace operations
-* **delete-space-mapi** – Delete Kontent.ai space
+* **list-spaces** – Get all Kontent.ai spaces
+* **create-space** – Create new Kontent.ai space for managing a website or channel
+* **patch-space** – Patch Kontent.ai space using replace operations
+* **delete-space** – Delete Kontent.ai space
 
 ### Role Management
 
-* **list-roles-mapi** – Get all Kontent.ai roles from Management API. Requires Enterprise or Flex plan with "Manage custom roles" permission
+* **list-roles** – Get all Kontent.ai roles. Requires Enterprise or Flex plan with "Manage custom roles" permission
 
 ### Workflow Management
 
-* **list-workflows-mapi** – Get all Kontent.ai workflows from Management API. Workflows define the content lifecycle stages and transitions between them
-* **add-workflow-mapi** – Create a new Kontent.ai workflow via Management API. Define custom workflow steps, transitions, scopes (content types and collections), and role permissions
-* **update-workflow-mapi** – Update an existing Kontent.ai workflow by ID via Management API. Modify steps, transitions, scopes, and role permissions. Cannot remove steps that are in use
-* **delete-workflow-mapi** – Delete a Kontent.ai workflow by ID via Management API. The workflow must not be in use by any content items
-* **change-variant-workflow-step-mapi** – Change the workflow step of a language variant in Kontent.ai. This operation moves a language variant to a different step in the workflow, enabling content lifecycle management such as moving content from draft to review, review to published, etc.
-* **publish-variant-mapi** – Publish or schedule a language variant of a content item in Kontent.ai. This operation can either immediately publish the variant or schedule it for publication at a specific future date and time with optional timezone specification
-* **unpublish-variant-mapi** – Unpublish or schedule unpublishing of a language variant of a content item in Kontent.ai. This operation can either immediately unpublish the variant (making it unavailable through the Delivery API) or schedule it for unpublishing at a specific future date and time with optional timezone specification
+* **list-workflows** – Get all Kontent.ai workflows. Workflows define the content lifecycle stages and transitions between them
+* **create-workflow** – Create new Kontent.ai workflow with custom steps, transitions, scopes, and role permissions
+* **update-workflow** – Update an existing Kontent.ai workflow by ID. Modify steps, transitions, scopes, and role permissions. Cannot remove steps that are in use
+* **delete-workflow** – Delete a Kontent.ai workflow by ID. The workflow must not be in use by any content items
+* **change-content-item-variant-workflow-step** – Change the workflow step of a content item variant in Kontent.ai. This operation moves a content item variant to a different step in the workflow, enabling content lifecycle management such as moving content from draft to review, review to published, etc.
+* **publish-content-item-variant** – Publish or schedule a content item variant of a content item in Kontent.ai. This operation can either immediately publish the variant or schedule it for publication at a specific future date and time with optional timezone specification
+* **unpublish-content-item-variant** – Unpublish or schedule unpublishing of a content item variant of a content item in Kontent.ai. This operation can either immediately unpublish the variant (making it unavailable through the Delivery API) or schedule it for unpublishing at a specific future date and time with optional timezone specification
 
 ## ⚙️ Configuration
 
@@ -167,11 +163,11 @@ Configure credentials via environment variables:
 
 | Variable | Description | Required |
 |----------|-------------|----------|
-| KONTENT_API_KEY | Your Kontent.ai Management API key | ✅ |
+| KONTENT_API_KEY | Your Kontent.ai key | ✅ |
 | KONTENT_ENVIRONMENT_ID | Your environment ID | ✅ |
 | appInsightsConnectionString | Application Insights connection string for telemetry | ❌ |
 | projectLocation | Project location identifier for telemetry tracking | ❌ |
-| manageApiUrl | Custom Management API base URL (for preview environments) | ❌ |
+| manageApiUrl | Custom base URL (for preview environments) | ❌ |
 
 ### Multi-Tenant Mode (Streamable HTTP)
 
@@ -186,7 +182,7 @@ This allows a single server instance to handle requests for multiple Kontent.ai
 | PORT | Port for HTTP transport (defaults to 3001) | ❌ |
 | appInsightsConnectionString | Application Insights connection string for telemetry | ❌ |
 | projectLocation | Project location identifier for telemetry tracking | ❌ |
-| manageApiUrl | Custom Management API base URL (for preview environments) | ❌ |
+| manageApiUrl | Custom base URL (for preview environments) | ❌ |
 
 ## 🚀 Transport Options
 
@@ -308,7 +304,7 @@ claude mcp add --transport http kontent-ai-multi \
 </details>
 
 > [!IMPORTANT]
-> Replace `<environment-id>` with your Kontent.ai environment ID (GUID) and `<management-api-key>` with your Management API key.
+> Replace `<environment-id>` with your Kontent.ai environment ID (GUID) and `<management-api-key>` with your key.
 
 ## 💻 Development
 

package/build/schemas/bulkGetItemsWithVariantsSchemas.js

@@ -9,6 +9,6 @@ export const bulkGetItemsWithVariantsSchema = z.object({
     }))
         .min(1)
         .max(100)
-        .describe("Array of item and language reference pairs to retrieve (max 100). Use filter-variants-mapi to get item and language references first."),
+        .describe(`Array of item and language reference pairs to retrieve (max 100).`),
     continuation_token: continuationTokenField,
 });

package/build/schemas/contentItemSchemas.js

@@ -116,7 +116,7 @@ const richTextInVariantElementSchema = z
 const elementInComponentSchema = z
     .lazy(() => languageVariantElementSchema)
     .describe("Element value within a component - same structure as top-level variant elements.");
-// Top-level language variant element schema - discriminated by unique fields
+// Top-level item variant element schema - discriminated by unique fields
 export const languageVariantElementSchema = z.union([
     // Most specific schemas first (with unique distinguishing fields)
     urlSlugInVariantElementSchema, // has unique required 'mode' field

package/build/schemas/filterVariantSchemas.js

@@ -19,7 +19,7 @@ export const filterVariantsSchema = z.object({
     search_phrase: z
         .string()
         .optional()
-        .describe("Search phrase to look for in content"),
+        .describe("Specific phrase or keywords to look for in content"),
     content_types: z
         .array(referenceObjectSchema)
         .min(1)
@@ -33,7 +33,7 @@ export const filterVariantsSchema = z.object({
     has_no_contributors: z
         .boolean()
         .optional()
-        .describe("Filter for content item language variants that have no contributors assigned"),
+        .describe("Filter for content item variants that have no contributors assigned"),
     completion_statuses: z
         .array(z.enum(["unfinished", "ready", "not_translated", "all_done"]))
         .min(1)
@@ -63,7 +63,7 @@ export const filterVariantsSchema = z.object({
         include_uncategorized: z
             .boolean()
             .optional()
-            .describe("Whether to include content item language variants that don't have any taxonomy terms assigned in this taxonomy group"),
+            .describe("Whether to include content item variants that don't have any taxonomy terms assigned in this taxonomy group"),
     }))
         .min(1)
         .optional()
@@ -78,6 +78,11 @@ export const filterVariantsSchema = z.object({
         .min(1)
         .optional()
         .describe("Array of references to collections by their id, codename, or external id"),
+    component_types: z
+        .array(referenceObjectSchema)
+        .min(1)
+        .optional()
+        .describe("Array of references to content component types stored in variants by their type id, codename, or external id"),
     publishing_states: z
         .array(z.enum(["published", "unpublished", "not_published_yet"]))
         .min(1)

package/build/schemas/searchOperationSchemas.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { listLanguagesToolName } from "../tools/referencedToolNames.js";
 export const searchOperationSchema = z.object({
     searchPhrase: z
         .string()
@@ -6,6 +7,6 @@ export const searchOperationSchema = z.object({
     filter: z.object({
         variantId: z
             .guid()
-            .describe("Language ID from list-languages-mapi. Use default language (is_default=true) if not specified by user."),
+            .describe(`Language ID from ${listLanguagesToolName}. Use default language (is_default=true) if not specified by user.`),
     }),
 });

package/build/server.js

@@ -1,61 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import packageJson from "../package.json" with { type: "json" };
-import { registerTool as registerAddContentItemMapi } from "./tools/add-content-item-mapi.js";
-import { registerTool as registerAddContentTypeMapi } from "./tools/add-content-type-mapi.js";
-import { registerTool as registerAddContentTypeSnippetMapi } from "./tools/add-content-type-snippet-mapi.js";
-import { registerTool as registerAddLanguageMapi } from "./tools/add-language-mapi.js";
-import { registerTool as registerAddSpaceMapi } from "./tools/add-space-mapi.js";
-import { registerTool as registerAddTaxonomyGroupMapi } from "./tools/add-taxonomy-group-mapi.js";
-import { registerTool as registerAddWorkflowMapi } from "./tools/add-workflow-mapi.js";
-import { registerTool as registerBulkGetItemsVariantsMapi } from "./tools/bulk-get-items-variants-mapi.js";
-import { registerTool as registerChangeVariantWorkflowStepMapi } from "./tools/change-variant-workflow-step-mapi.js";
-import { registerTool as registerCreateLanguageVariantMapi } from "./tools/create-language-variant-mapi.js";
-import { registerTool as registerCreateVariantVersionMapi } from "./tools/create-variant-version-mapi.js";
-import { registerTool as registerDeleteContentItemMapi } from "./tools/delete-content-item-mapi.js";
-import { registerTool as registerDeleteContentTypeMapi } from "./tools/delete-content-type-mapi.js";
-import { registerTool as registerDeleteLanguageVariantMapi } from "./tools/delete-language-variant-mapi.js";
-import { registerTool as registerDeleteSpaceMapi } from "./tools/delete-space-mapi.js";
-import { registerTool as registerDeleteTaxonomyGroupMapi } from "./tools/delete-taxonomy-group-mapi.js";
-import { registerTool as registerDeleteTypeSnippetMapi } from "./tools/delete-type-snippet-mapi.js";
-import { registerTool as registerDeleteWorkflowMapi } from "./tools/delete-workflow-mapi.js";
-import { registerTool as registerFilterVariantsMapi } from "./tools/filter-variants-mapi.js";
-import { registerTool as registerGetAssetMapi } from "./tools/get-asset-mapi.js";
-import { registerTool as registerGetItemMapi } from "./tools/get-item-mapi.js";
-import { registerTool as registerGetLatestVariantMapi } from "./tools/get-latest-variant-mapi.js";
-import { registerTool as registerGetPatchGuide } from "./tools/get-patch-guide.js";
-import { registerTool as registerGetPublishedVariantMapi } from "./tools/get-published-variant-mapi.js";
-import { registerTool as registerGetTaxonomyGroupMapi } from "./tools/get-taxonomy-group-mapi.js";
-import { registerTool as registerGetTypeMapi } from "./tools/get-type-mapi.js";
-import { registerTool as registerGetTypeSnippetMapi } from "./tools/get-type-snippet-mapi.js";
-import { registerTool as registerListAssetFoldersMapi } from "./tools/list-asset-folders-mapi.js";
-import { registerTool as registerListAssetsMapi } from "./tools/list-assets-mapi.js";
-import { registerTool as registerListCollectionsMapi } from "./tools/list-collections-mapi.js";
-import { registerTool as registerListContentTypeSnippetsMapi } from "./tools/list-content-type-snippets-mapi.js";
-import { registerTool as registerListContentTypesMapi } from "./tools/list-content-types-mapi.js";
-import { registerTool as registerListLanguagesMapi } from "./tools/list-languages-mapi.js";
-import { registerTool as registerListRolesMapi } from "./tools/list-roles-mapi.js";
-import { registerTool as registerListSpacesMapi } from "./tools/list-spaces-mapi.js";
-import { registerTool as registerListTaxonomyGroupsMapi } from "./tools/list-taxonomy-groups-mapi.js";
-import { registerTool as registerListVariantsCollectionMapi } from "./tools/list-variants-collection-mapi.js";
-import { registerTool as registerListVariantsComponentsTypeMapi } from "./tools/list-variants-components-type-mapi.js";
-import { registerTool as registerListVariantsItemMapi } from "./tools/list-variants-item-mapi.js";
-import { registerTool as registerListVariantsSpaceMapi } from "./tools/list-variants-space-mapi.js";
-import { registerTool as registerListVariantsTypeMapi } from "./tools/list-variants-type-mapi.js";
-import { registerTool as registerListWorkflowsMapi } from "./tools/list-workflows-mapi.js";
-import { registerTool as registerPatchAssetFoldersMapi } from "./tools/patch-asset-folders-mapi.js";
-import { registerTool as registerPatchCollectionsMapi } from "./tools/patch-collections-mapi.js";
-import { registerTool as registerPatchContentTypeMapi } from "./tools/patch-content-type-mapi.js";
-import { registerTool as registerPatchLanguageMapi } from "./tools/patch-language-mapi.js";
-import { registerTool as registerPatchSpaceMapi } from "./tools/patch-space-mapi.js";
-import { registerTool as registerPatchTaxonomyGroupMapi } from "./tools/patch-taxonomy-group-mapi.js";
-import { registerTool as registerPatchTypeSnippetMapi } from "./tools/patch-type-snippet-mapi.js";
-import { registerTool as registerPublishVariantMapi } from "./tools/publish-variant-mapi.js";
-import { registerTool as registerSearchVariantsMapi } from "./tools/search-variants-mapi.js";
-import { registerTool as registerUnpublishVariantMapi } from "./tools/unpublish-variant-mapi.js";
-import { registerTool as registerUpdateAssetMapi } from "./tools/update-asset-mapi.js";
-import { registerTool as registerUpdateContentItemMapi } from "./tools/update-content-item-mapi.js";
-import { registerTool as registerUpdateLanguageVariantMapi } from "./tools/update-language-variant-mapi.js";
-import { registerTool as registerUpdateWorkflowMapi } from "./tools/update-workflow-mapi.js";
+import { allTools } from "./tools/index.js";
 // Create server instance
 export const createServer = () => {
     const server = new McpServer({
@@ -63,61 +8,8 @@ export const createServer = () => {
         version: packageJson.version,
     });
     // Register all tools
-    registerGetPatchGuide(server);
-    registerGetItemMapi(server);
-    registerGetLatestVariantMapi(server);
-    registerGetPublishedVariantMapi(server);
-    registerListVariantsItemMapi(server);
-    registerListVariantsCollectionMapi(server);
-    registerListVariantsTypeMapi(server);
-    registerListVariantsComponentsTypeMapi(server);
-    registerListVariantsSpaceMapi(server);
-    registerGetTypeMapi(server);
-    registerListContentTypesMapi(server);
-    registerDeleteContentTypeMapi(server);
-    registerListLanguagesMapi(server);
-    registerAddLanguageMapi(server);
-    registerPatchLanguageMapi(server);
-    registerListCollectionsMapi(server);
-    registerPatchCollectionsMapi(server);
-    registerListSpacesMapi(server);
-    registerAddSpaceMapi(server);
-    registerPatchSpaceMapi(server);
-    registerDeleteSpaceMapi(server);
-    registerListRolesMapi(server);
-    registerGetAssetMapi(server);
-    registerListAssetsMapi(server);
-    registerUpdateAssetMapi(server);
-    registerListAssetFoldersMapi(server);
-    registerPatchAssetFoldersMapi(server);
-    registerAddContentTypeMapi(server);
-    registerPatchContentTypeMapi(server);
-    registerAddContentTypeSnippetMapi(server);
-    registerGetTypeSnippetMapi(server);
-    registerListContentTypeSnippetsMapi(server);
-    registerPatchTypeSnippetMapi(server);
-    registerDeleteTypeSnippetMapi(server);
-    registerAddTaxonomyGroupMapi(server);
-    registerListTaxonomyGroupsMapi(server);
-    registerGetTaxonomyGroupMapi(server);
-    registerPatchTaxonomyGroupMapi(server);
-    registerDeleteTaxonomyGroupMapi(server);
-    registerAddContentItemMapi(server);
-    registerUpdateContentItemMapi(server);
-    registerDeleteContentItemMapi(server);
-    registerCreateLanguageVariantMapi(server);
-    registerUpdateLanguageVariantMapi(server);
-    registerCreateVariantVersionMapi(server);
-    registerDeleteLanguageVariantMapi(server);
-    registerListWorkflowsMapi(server);
-    registerAddWorkflowMapi(server);
-    registerUpdateWorkflowMapi(server);
-    registerDeleteWorkflowMapi(server);
-    registerChangeVariantWorkflowStepMapi(server);
-    registerFilterVariantsMapi(server);
-    registerBulkGetItemsVariantsMapi(server);
-    registerSearchVariantsMapi(server);
-    registerPublishVariantMapi(server);
-    registerUnpublishVariantMapi(server);
+    for (const tool of Object.values(allTools)) {
+        server.registerTool(tool.name, { description: tool.description, inputSchema: tool.inputSchema }, tool.handler);
+    }
     return { server };
 };

package/build/test/bm25/bm25.js

@@ -0,0 +1,47 @@
+import MiniSearch from "minisearch";
+/**
+ * Extracts argument names and descriptions from a Zod input schema
+ * to produce a searchable string, matching Anthropic's BM25 tool search
+ * which indexes argument names and argument descriptions.
+ */
+const extractArgs = (inputSchema) => {
+    const parts = [];
+    for (const [argName, zodType] of Object.entries(inputSchema)) {
+        parts.push(argName);
+        const desc = zodType.description;
+        if (desc)
+            parts.push(desc);
+    }
+    return parts.join(" ");
+};
+const tokenize = (text) => text
+    .toLowerCase()
+    .replace(/[^a-z0-9]/g, " ")
+    .split(/\s+/)
+    .filter((t) => t.length > 0);
+export const createToolSearchIndex = (tools) => {
+    const docs = tools.map((t, i) => ({
+        id: i,
+        name: t.name,
+        description: t.description,
+        args: extractArgs(t.inputSchema),
+    }));
+    const index = new MiniSearch({
+        fields: ["name", "description", "args"],
+        storeFields: ["name"],
+        tokenize,
+        searchOptions: {
+            boost: { name: 2, args: 0.5 },
+            prefix: true,
+        },
+    });
+    index.addAll(docs);
+    return index;
+};
+export const searchTools = (index, query, topK) => index
+    .search(query)
+    .slice(0, topK)
+    .map((r) => ({
+    name: r.name,
+    score: r.score,
+}));