@codeqr/ts-mcp 0.2.1 → 0.4.0

package/server.mjs

@@ -6,11 +6,12 @@ import Codeqr from '@codeqr/ts';
 import { applyCompatibilityTransformations, defaultClientCapabilities, knownClients, parseEmbeddedJSON, } from "./compat.mjs";
 import { dynamicTools } from "./dynamic-tools.mjs";
 import { codeTool } from "./code-tool.mjs";
+import docsSearchTool from "./docs-search-tool.mjs";
 export { ClientType } from "./compat.mjs";
 export { endpoints } from "./tools.mjs";
 export const newMcpServer = () => new McpServer({
     name: 'codeqr_ts_api',
-    version: '0.2.1',
+    version: '0.4.0',
 }, { capabilities: { tools: {}, logging: {} } });
 // Create server instance
 export const server = newMcpServer();
@@ -104,7 +105,7 @@ export function initMcpServer(params) {
  */
 export async function selectTools(endpoints, options) {
     const filteredEndpoints = query(options?.filters ?? [], endpoints);
-    let includedTools = filteredEndpoints;
+    let includedTools = filteredEndpoints.slice();
     if (includedTools.length > 0) {
         if (options?.includeDynamicTools) {
             includedTools = dynamicTools(includedTools);
@@ -112,7 +113,7 @@ export async function selectTools(endpoints, options) {
     }
     else {
         if (options?.includeAllTools) {
-            includedTools = endpoints;
+            includedTools = endpoints.slice();
         }
         else if (options?.includeDynamicTools) {
             includedTools = dynamicTools(endpoints);
@@ -121,9 +122,12 @@ export async function selectTools(endpoints, options) {
             includedTools = [await codeTool()];
         }
         else {
-            includedTools = endpoints;
+            includedTools = endpoints.slice();
         }
     }
+    if (options?.includeDocsTools ?? true) {
+        includedTools.push(docsSearchTool);
+    }
     const capabilities = { ...defaultClientCapabilities, ...options?.capabilities };
     return applyCompatibilityTransformations(includedTools, capabilities);
 }

package/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.mjs","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}

package/src/docs-search-tool.ts

@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from './tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+export const metadata: Metadata = {
+  resource: 'all',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+};
+
+export const tool: Tool = {
+  name: 'search_docs',
+  description:
+    'Search for documentation for how to use the client to interact with the API.\nThe tool will return an array of Markdown-formatted documentation pages.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        type: 'string',
+        description: 'The query to search for.',
+      },
+      language: {
+        type: 'string',
+        description: 'The language for the SDK to search for.',
+        enum: ['http', 'python', 'go', 'typescript', 'terraform', 'ruby', 'java', 'kotlin'],
+      },
+    },
+    required: ['query', 'language'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+const docsSearchURL =
+  process.env['DOCS_SEARCH_URL'] || 'https://api.stainless.com/api/projects/codeqr/docs/search';
+
+export const handler = async (_: unknown, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const query = new URLSearchParams(body).toString();
+  const result = await fetch(`${docsSearchURL}?${query}`);
+  return asTextContentResult(await result.json());
+};
+
+export default { metadata, tool, handler };

package/src/options.ts

@@ -17,6 +17,7 @@ export type McpOptions = {
   includeDynamicTools?: boolean | undefined;
   includeAllTools?: boolean | undefined;
   includeCodeTools?: boolean | undefined;
+  includeDocsTools?: boolean | undefined;
   filters?: Filter[] | undefined;
   capabilities?: Partial<ClientCapabilities> | undefined;
 };
@@ -55,13 +56,13 @@ export function parseCLIOptions(): CLIOptions {
     .option('tools', {
       type: 'string',
       array: true,
-      choices: ['dynamic', 'all', 'code'],
+      choices: ['dynamic', 'all', 'code', 'docs'],
       description: 'Use dynamic tools or all tools',
     })
     .option('no-tools', {
       type: 'string',
       array: true,
-      choices: ['dynamic', 'all', 'code'],
+      choices: ['dynamic', 'all', 'code', 'docs'],
       description: 'Do not use any dynamic or all tools',
     })
     .option('tool', {
@@ -245,13 +246,15 @@ export function parseCLIOptions(): CLIOptions {
     }
   }
 
-  const shouldIncludeToolType = (toolType: 'dynamic' | 'all' | 'code') =>
-    explicitTools ? argv.tools?.includes(toolType) && !argv.noTools?.includes(toolType) : undefined;
+  const shouldIncludeToolType = (toolType: 'dynamic' | 'all' | 'code' | 'docs') =>
+    argv.noTools?.includes(toolType) ? false
+    : argv.tools?.includes(toolType) ? true
+    : undefined;
 
-  const explicitTools = Boolean(argv.tools || argv.noTools);
   const includeDynamicTools = shouldIncludeToolType('dynamic');
   const includeAllTools = shouldIncludeToolType('all');
   const includeCodeTools = shouldIncludeToolType('code');
+  const includeDocsTools = shouldIncludeToolType('docs');
 
   const transport = argv.transport as 'stdio' | 'http';
 
@@ -261,6 +264,7 @@ export function parseCLIOptions(): CLIOptions {
     includeDynamicTools,
     includeAllTools,
     includeCodeTools,
+    includeDocsTools,
     filters,
     capabilities: clientCapabilities,
     list: argv.list || false,
@@ -280,8 +284,8 @@ const coerceArray = <T extends z.ZodTypeAny>(zodType: T) =>
   );
 
 const QueryOptions = z.object({
-  tools: coerceArray(z.enum(['dynamic', 'all'])).describe('Use dynamic tools or all tools'),
-  no_tools: coerceArray(z.enum(['dynamic', 'all'])).describe('Do not use dynamic tools or all tools'),
+  tools: coerceArray(z.enum(['dynamic', 'all', 'docs'])).describe('Use dynamic tools or all tools'),
+  no_tools: coerceArray(z.enum(['dynamic', 'all', 'docs'])).describe('Do not use dynamic tools or all tools'),
   tool: coerceArray(z.string()).describe('Include tools matching the specified names'),
   resource: coerceArray(z.string()).describe('Include tools matching the specified resources'),
   operation: coerceArray(z.enum(['read', 'write'])).describe(
@@ -376,11 +380,17 @@ export function parseQueryOptions(defaultOptions: McpOptions, query: unknown): M
     : queryOptions.tools?.includes('all') ? true
     : defaultOptions.includeAllTools;
 
+  let docsTools: boolean | undefined =
+    queryOptions.no_tools && queryOptions.no_tools?.includes('docs') ? false
+    : queryOptions.tools?.includes('docs') ? true
+    : defaultOptions.includeDocsTools;
+
   return {
     client: queryOptions.client ?? defaultOptions.client,
     includeDynamicTools: dynamicTools,
     includeAllTools: allTools,
     includeCodeTools: undefined,
+    includeDocsTools: docsTools,
     filters,
     capabilities: clientCapabilities,
   };

package/src/server.ts

@@ -21,6 +21,7 @@ import {
 } from './compat';
 import { dynamicTools } from './dynamic-tools';
 import { codeTool } from './code-tool';
+import docsSearchTool from './docs-search-tool';
 import { McpOptions } from './options';
 
 export { McpOptions } from './options';
@@ -33,7 +34,7 @@ export const newMcpServer = () =>
   new McpServer(
     {
       name: 'codeqr_ts_api',
-      version: '0.2.1',
+      version: '0.4.0',
     },
     { capabilities: { tools: {}, logging: {} } },
   );
@@ -147,7 +148,7 @@ export function initMcpServer(params: {
 export async function selectTools(endpoints: Endpoint[], options?: McpOptions): Promise<Endpoint[]> {
   const filteredEndpoints = query(options?.filters ?? [], endpoints);
 
-  let includedTools = filteredEndpoints;
+  let includedTools = filteredEndpoints.slice();
 
   if (includedTools.length > 0) {
     if (options?.includeDynamicTools) {
@@ -155,16 +156,18 @@ export async function selectTools(endpoints: Endpoint[], options?: McpOptions):
     }
   } else {
     if (options?.includeAllTools) {
-      includedTools = endpoints;
+      includedTools = endpoints.slice();
     } else if (options?.includeDynamicTools) {
       includedTools = dynamicTools(endpoints);
     } else if (options?.includeCodeTools) {
       includedTools = [await codeTool()];
     } else {
-      includedTools = endpoints;
+      includedTools = endpoints.slice();
     }
   }
-
+  if (options?.includeDocsTools ?? true) {
+    includedTools.push(docsSearchTool);
+  }
   const capabilities = { ...defaultClientCapabilities, ...options?.capabilities };
   return applyCompatibilityTransformations(includedTools, capabilities);
 }

package/src/tools/links/bulk/create-links-bulk.ts

@@ -75,6 +75,10 @@ export const tool: Tool = {
               type: 'boolean',
               description: 'Whether the short link is flexible.',
             },
+            folderId: {
+              type: 'string',
+              description: 'The unique ID existing folder to assign the short link to.',
+            },
             geo: {
               type: 'object',
               description:

package/src/tools/links/count-links.ts

@@ -67,6 +67,10 @@ export const tool: Tool = {
         description: 'Expires before date (ISO string)',
         format: 'date-time',
       },
+      folderId: {
+        type: 'string',
+        description: 'The folder ID to filter the links by.',
+      },
       geo: {
         type: 'object',
         description:
@@ -827,7 +831,7 @@ export const tool: Tool = {
       groupBy: {
         type: 'string',
         description: 'The field to group the links by.',
-        enum: ['domain', 'tagId', 'userId'],
+        enum: ['domain', 'tagId', 'userId', 'folderId'],
       },
       hasComments: {
         type: 'boolean',

package/src/tools/links/create-links.ts

@@ -70,6 +70,10 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'Whether the short link is flexible.',
       },
+      folderId: {
+        type: 'string',
+        description: 'The unique ID existing folder to assign the short link to.',
+      },
       geo: {
         type: 'object',
         description:

package/src/tools/links/list-links.ts

@@ -67,6 +67,10 @@ export const tool: Tool = {
         description: 'Expires before date (ISO string)',
         format: 'date-time',
       },
+      folderId: {
+        type: 'string',
+        description: 'The folder ID to filter the links by.',
+      },
       geo: {
         type: 'object',
         description:

package/src/tools/links/retrieve-info-links.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_info_links',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve the info for a link.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/link',\n  $defs: {\n    link: {\n      type: 'object',\n      title: 'Link',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the short link.'\n        },\n        android: {\n          type: 'string',\n          description: 'The Android destination URL for the short link for Android device targeting.'\n        },\n        archived: {\n          type: 'boolean',\n          description: 'Whether the short link is archived.'\n        },\n        clicks: {\n          type: 'number',\n          description: 'The number of clicks on the short link.'\n        },\n        comments: {\n          type: 'string',\n          description: 'The comments for the short link.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the short link was created.'\n        },\n        description: {\n          type: 'string',\n          description: 'The description of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        doIndex: {\n          type: 'boolean',\n          description: 'Whether search engines can index the short link.'\n        },\n        domain: {\n          type: 'string',\n          description: 'The domain of the short link. If not provided, the main domain of the project will be used (or `codeqr.link` if the project has no domains).'\n        },\n        expiredUrl: {\n          type: 'string',\n          description: 'The URL to redirect to when the short link expires.'\n        },\n        expiresAt: {\n          type: 'string',\n          description: 'The date and time when the short link will expire in ISO-8601 format. Must be in the future.'\n        },\n        externalId: {\n          type: 'string',\n          description: 'This is the ID of the link in your database.'\n        },\n        filled: {\n          type: 'boolean',\n          description: 'Whether the link is filled or not.'\n        },\n        flexible: {\n          type: 'boolean',\n          description: 'Whether the short link is flexible.'\n        },\n        geo: {\n          type: 'object',\n          description: 'Geographic targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://codeqr.link/geo',\n          additionalProperties: true\n        },\n        image: {\n          type: 'string',\n          description: 'The image of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        ios: {\n          type: 'string',\n          description: 'The iOS destination URL for the short link for iOS device targeting.'\n        },\n        isFormMandatory: {\n          type: 'boolean',\n          description: 'If the form is mandatory for the page.'\n        },\n        key: {\n          type: 'string',\n          description: 'The slug of the short link. If not provided, a random 7-character slug will be generated.'\n        },\n        lastClicked: {\n          type: 'string',\n          description: 'The date and time when the short link was last clicked.'\n        },\n        leads: {\n          type: 'number',\n          description: 'The number of leads generated by the short link.'\n        },\n        notificationToken: {\n          type: 'string',\n          description: 'The notification token of the short link.'\n        },\n        password: {\n          type: 'string',\n          description: 'The password required to access the short link destination URL.'\n        },\n        preRedirection: {\n          type: 'boolean',\n          description: 'Whether the short link has pre-redirection.'\n        },\n        projectId: {\n          type: 'string',\n          description: 'The ID of the project of the short link.'\n        },\n        proxy: {\n          type: 'boolean',\n          description: 'Whether the short link uses the custom link preview feature.'\n        },\n        publicStats: {\n          type: 'boolean',\n          description: 'Whether the short link statistics are publicly accessible.'\n        },\n        rewrite: {\n          type: 'boolean',\n          description: 'Whether the short link uses link cloaking.'\n        },\n        saleAmount: {\n          type: 'number',\n          description: 'The amount of the sale generated by the link.'\n        },\n        sales: {\n          type: 'number',\n          description: 'The number of sales generated by the short link.'\n        },\n        tagId: {\n          type: 'string',\n          description: '[DEPRECATED (use `tags` instead)]: The unique ID of the tag assigned to the short link.'\n        },\n        tags: {\n          type: 'array',\n          description: 'The tags assigned to the short link.',\n          items: {\n            $ref: '#/$defs/tag'\n          }\n        },\n        title: {\n          type: 'string',\n          description: 'The title of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        trackConversion: {\n          type: 'boolean',\n          description: '[BETA] Whether to track conversions for the short link.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when the short link was last updated.'\n        },\n        url: {\n          type: 'string',\n          description: 'The destination URL of the short link.'\n        },\n        userId: {\n          type: 'string',\n          description: 'The ID of the user who created the short link.'\n        },\n        utm_campaign: {\n          type: 'string',\n          description: 'The UTM campaign of the short link.'\n        },\n        utm_content: {\n          type: 'string',\n          description: 'The UTM content of the short link.'\n        },\n        utm_medium: {\n          type: 'string',\n          description: 'The UTM medium of the short link.'\n        },\n        utm_source: {\n          type: 'string',\n          description: 'The UTM source of the short link.'\n        },\n        utm_term: {\n          type: 'string',\n          description: 'The UTM term of the short link.'\n        },\n        video: {\n          type: 'string',\n          description: 'The video of the short link.'\n        },\n        pageId: {\n          type: 'string',\n          description: 'The ID of the page to redirect to before the link destination.'\n        },\n        pageUrl: {\n          type: 'string',\n          description: 'The URL of the page to redirect to before the link destination.'\n        },\n        qrCode: {\n          type: 'string',\n          description: 'The complete QR code URL for the short link (for example, `https://api.codeqr.io/qr?url=https://codeqr.link/try`).'\n        },\n        shortLink: {\n          type: 'string',\n          description: 'The complete URL of the short link, including the https protocol (for example, `https://codeqr.link/try`).'\n        }\n      },\n      required: [        'id',\n        'android',\n        'archived',\n        'clicks',\n        'comments',\n        'createdAt',\n        'description',\n        'doIndex',\n        'domain',\n        'expiredUrl',\n        'expiresAt',\n        'externalId',\n        'filled',\n        'flexible',\n        'geo',\n        'image',\n        'ios',\n        'isFormMandatory',\n        'key',\n        'lastClicked',\n        'leads',\n        'notificationToken',\n        'password',\n        'preRedirection',\n        'projectId',\n        'proxy',\n        'publicStats',\n        'rewrite',\n        'saleAmount',\n        'sales',\n        'tagId',\n        'tags',\n        'title',\n        'trackConversion',\n        'updatedAt',\n        'url',\n        'userId',\n        'utm_campaign',\n        'utm_content',\n        'utm_medium',\n        'utm_source',\n        'utm_term',\n        'video'\n      ]\n    },\n    tag: {\n      type: 'object',\n      title: 'Tag',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the tag.'\n        },\n        color: {\n          type: 'string',\n          description: 'The color of the tag.',\n          enum: [            'red',\n            'yellow',\n            'green',\n            'blue',\n            'purple',\n            'pink',\n            'brown'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the tag.'\n        }\n      },\n      required: [        'id',\n        'color',\n        'name'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve the info for a link.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/link',\n  $defs: {\n    link: {\n      type: 'object',\n      title: 'Link',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the short link.'\n        },\n        android: {\n          type: 'string',\n          description: 'The Android destination URL for the short link for Android device targeting.'\n        },\n        archived: {\n          type: 'boolean',\n          description: 'Whether the short link is archived.'\n        },\n        clicks: {\n          type: 'number',\n          description: 'The number of clicks on the short link.'\n        },\n        comments: {\n          type: 'string',\n          description: 'The comments for the short link.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the short link was created.'\n        },\n        description: {\n          type: 'string',\n          description: 'The description of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        doIndex: {\n          type: 'boolean',\n          description: 'Whether search engines can index the short link.'\n        },\n        domain: {\n          type: 'string',\n          description: 'The domain of the short link. If not provided, the main domain of the project will be used (or `codeqr.link` if the project has no domains).'\n        },\n        expiredUrl: {\n          type: 'string',\n          description: 'The URL to redirect to when the short link expires.'\n        },\n        expiresAt: {\n          type: 'string',\n          description: 'The date and time when the short link will expire in ISO-8601 format. Must be in the future.'\n        },\n        externalId: {\n          type: 'string',\n          description: 'This is the ID of the link in your database.'\n        },\n        filled: {\n          type: 'boolean',\n          description: 'Whether the link is filled or not.'\n        },\n        flexible: {\n          type: 'boolean',\n          description: 'Whether the short link is flexible.'\n        },\n        folderId: {\n          type: 'string',\n          description: 'The unique ID of the folder assigned to the short link.'\n        },\n        geo: {\n          type: 'object',\n          description: 'Geographic targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://codeqr.link/geo',\n          additionalProperties: true\n        },\n        image: {\n          type: 'string',\n          description: 'The image of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        ios: {\n          type: 'string',\n          description: 'The iOS destination URL for the short link for iOS device targeting.'\n        },\n        isFormMandatory: {\n          type: 'boolean',\n          description: 'If the form is mandatory for the page.'\n        },\n        key: {\n          type: 'string',\n          description: 'The slug of the short link. If not provided, a random 7-character slug will be generated.'\n        },\n        lastClicked: {\n          type: 'string',\n          description: 'The date and time when the short link was last clicked.'\n        },\n        leads: {\n          type: 'number',\n          description: 'The number of leads generated by the short link.'\n        },\n        notificationToken: {\n          type: 'string',\n          description: 'The notification token of the short link.'\n        },\n        password: {\n          type: 'string',\n          description: 'The password required to access the short link destination URL.'\n        },\n        preRedirection: {\n          type: 'boolean',\n          description: 'Whether the short link has pre-redirection.'\n        },\n        projectId: {\n          type: 'string',\n          description: 'The ID of the project of the short link.'\n        },\n        proxy: {\n          type: 'boolean',\n          description: 'Whether the short link uses the custom link preview feature.'\n        },\n        publicStats: {\n          type: 'boolean',\n          description: 'Whether the short link statistics are publicly accessible.'\n        },\n        rewrite: {\n          type: 'boolean',\n          description: 'Whether the short link uses link cloaking.'\n        },\n        saleAmount: {\n          type: 'number',\n          description: 'The amount of the sale generated by the link.'\n        },\n        sales: {\n          type: 'number',\n          description: 'The number of sales generated by the short link.'\n        },\n        tagId: {\n          type: 'string',\n          description: '[DEPRECATED (use `tags` instead)]: The unique ID of the tag assigned to the short link.'\n        },\n        tags: {\n          type: 'array',\n          description: 'The tags assigned to the short link.',\n          items: {\n            $ref: '#/$defs/tag'\n          }\n        },\n        title: {\n          type: 'string',\n          description: 'The title of the short link generated via `api.codeqr.io/metatags`. Will be used for custom link preview if `proxy` is true.'\n        },\n        trackConversion: {\n          type: 'boolean',\n          description: '[BETA] Whether to track conversions for the short link.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when the short link was last updated.'\n        },\n        url: {\n          type: 'string',\n          description: 'The destination URL of the short link.'\n        },\n        userId: {\n          type: 'string',\n          description: 'The ID of the user who created the short link.'\n        },\n        utm_campaign: {\n          type: 'string',\n          description: 'The UTM campaign of the short link.'\n        },\n        utm_content: {\n          type: 'string',\n          description: 'The UTM content of the short link.'\n        },\n        utm_medium: {\n          type: 'string',\n          description: 'The UTM medium of the short link.'\n        },\n        utm_source: {\n          type: 'string',\n          description: 'The UTM source of the short link.'\n        },\n        utm_term: {\n          type: 'string',\n          description: 'The UTM term of the short link.'\n        },\n        video: {\n          type: 'string',\n          description: 'The video of the short link.'\n        },\n        pageId: {\n          type: 'string',\n          description: 'The ID of the page to redirect to before the link destination.'\n        },\n        pageUrl: {\n          type: 'string',\n          description: 'The URL of the page to redirect to before the link destination.'\n        },\n        qrCode: {\n          type: 'string',\n          description: 'The complete QR code URL for the short link (for example, `https://api.codeqr.io/qr?url=https://codeqr.link/try`).'\n        },\n        shortLink: {\n          type: 'string',\n          description: 'The complete URL of the short link, including the https protocol (for example, `https://codeqr.link/try`).'\n        }\n      },\n      required: [        'id',\n        'android',\n        'archived',\n        'clicks',\n        'comments',\n        'createdAt',\n        'description',\n        'doIndex',\n        'domain',\n        'expiredUrl',\n        'expiresAt',\n        'externalId',\n        'filled',\n        'flexible',\n        'folderId',\n        'geo',\n        'image',\n        'ios',\n        'isFormMandatory',\n        'key',\n        'lastClicked',\n        'leads',\n        'notificationToken',\n        'password',\n        'preRedirection',\n        'projectId',\n        'proxy',\n        'publicStats',\n        'rewrite',\n        'saleAmount',\n        'sales',\n        'tagId',\n        'tags',\n        'title',\n        'trackConversion',\n        'updatedAt',\n        'url',\n        'userId',\n        'utm_campaign',\n        'utm_content',\n        'utm_medium',\n        'utm_source',\n        'utm_term',\n        'video'\n      ]\n    },\n    tag: {\n      type: 'object',\n      title: 'Tag',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the tag.'\n        },\n        color: {\n          type: 'string',\n          description: 'The color of the tag.',\n          enum: [            'red',\n            'yellow',\n            'green',\n            'blue',\n            'purple',\n            'pink',\n            'brown'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the tag.'\n        }\n      },\n      required: [        'id',\n        'color',\n        'name'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/links/update-links.ts

@@ -71,6 +71,10 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'Whether the short link is flexible.',
       },
+      folderId: {
+        type: 'string',
+        description: 'The unique ID existing folder to assign the short link to.',
+      },
       geo: {
         type: 'object',
         description:

package/src/tools/links/upsert-links.ts

@@ -71,6 +71,10 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'Whether the short link is flexible.',
       },
+      folderId: {
+        type: 'string',
+        description: 'The unique ID existing folder to assign the short link to.',
+      },
       geo: {
         type: 'object',
         description:

package/src/tools/projects/list-projects.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_projects',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve a list of projects for the authenticated user.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/project'\n  },\n  $defs: {\n    project: {\n      type: 'object',\n      title: 'Project',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the project.'\n        },\n        billingCycleStart: {\n          type: 'number',\n          description: 'The date and time when the billing cycle starts for the project.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the project was created.'\n        },\n        domains: {\n          type: 'array',\n          description: 'The domains of the project.',\n          items: {\n            type: 'object',\n            properties: {\n              slug: {\n                type: 'string',\n                description: 'The domain of the project.'\n              }\n            },\n            required: [              'slug'\n            ]\n          }\n        },\n        domainsLimit: {\n          type: 'number',\n          description: 'The domains limit of the project.'\n        },\n        linksLimit: {\n          type: 'number',\n          description: 'The links limit of the project.'\n        },\n        linksUsage: {\n          type: 'number',\n          description: 'The links usage of the project.'\n        },\n        logo: {\n          type: 'string',\n          description: 'The logo of the project.'\n        },\n        metadata: {\n          type: 'object',\n          properties: {\n            defaultDomains: {\n              type: 'array',\n              items: {\n                type: 'string'\n              }\n            }\n          },\n          required: [            'defaultDomains'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the project.'\n        },\n        plan: {\n          type: 'string',\n          description: 'The plan of the project.',\n          enum: [            'free',\n            'starter',\n            'pro',\n            'business',\n            'business plus',\n            'business extra',\n            'business max',\n            'enterprise'\n          ]\n        },\n        slug: {\n          type: 'string',\n          description: 'The slug of the project.'\n        },\n        stripeConnectId: {\n          type: 'string',\n          description: '[BETA]: The Stripe Connect ID of the project.'\n        },\n        stripeId: {\n          type: 'string',\n          description: 'The Stripe ID of the project.'\n        },\n        tagsLimit: {\n          type: 'number',\n          description: 'The tags limit of the project.'\n        },\n        usage: {\n          type: 'number',\n          description: 'The usage of the project.'\n        },\n        usageLimit: {\n          type: 'number',\n          description: 'The usage limit of the project.'\n        },\n        users: {\n          type: 'array',\n          description: 'The role of the authenticated user in the project.',\n          items: {\n            type: 'object',\n            properties: {\n              role: {\n                type: 'string',\n                description: 'The role of the authenticated user in the project.',\n                enum: [                  'owner',\n                  'member'\n                ]\n              }\n            },\n            required: [              'role'\n            ]\n          }\n        },\n        usersLimit: {\n          type: 'number',\n          description: 'The users limit of the project.'\n        }\n      },\n      required: [        'id',\n        'billingCycleStart',\n        'createdAt',\n        'domains',\n        'domainsLimit',\n        'linksLimit',\n        'linksUsage',\n        'logo',\n        'metadata',\n        'name',\n        'plan',\n        'slug',\n        'stripeConnectId',\n        'stripeId',\n        'tagsLimit',\n        'usage',\n        'usageLimit',\n        'users',\n        'usersLimit'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve a list of projects for the authenticated user.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/project'\n  },\n  $defs: {\n    project: {\n      type: 'object',\n      title: 'Project',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the project.'\n        },\n        billingCycleStart: {\n          type: 'number',\n          description: 'The date and time when the billing cycle starts for the project.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the project was created.'\n        },\n        domains: {\n          type: 'array',\n          description: 'The domains of the project.',\n          items: {\n            type: 'object',\n            properties: {\n              slug: {\n                type: 'string',\n                description: 'The domain of the project.'\n              }\n            },\n            required: [              'slug'\n            ]\n          }\n        },\n        domainsLimit: {\n          type: 'number',\n          description: 'The domains limit of the project.'\n        },\n        linksLimit: {\n          type: 'number',\n          description: 'The links limit of the project.'\n        },\n        linksUsage: {\n          type: 'number',\n          description: 'The links usage of the project.'\n        },\n        logo: {\n          type: 'string',\n          description: 'The logo of the project.'\n        },\n        metadata: {\n          type: 'object',\n          properties: {\n            defaultDomains: {\n              type: 'array',\n              items: {\n                type: 'string'\n              }\n            }\n          },\n          required: [            'defaultDomains'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the project.'\n        },\n        plan: {\n          type: 'string',\n          description: 'The plan of the project.',\n          enum: [            'free',\n            'starter',\n            'pro',\n            'business',\n            'scale',\n            'enterprise'\n          ]\n        },\n        slug: {\n          type: 'string',\n          description: 'The slug of the project.'\n        },\n        stripeConnectId: {\n          type: 'string',\n          description: '[BETA]: The Stripe Connect ID of the project.'\n        },\n        stripeId: {\n          type: 'string',\n          description: 'The Stripe ID of the project.'\n        },\n        tagsLimit: {\n          type: 'number',\n          description: 'The tags limit of the project.'\n        },\n        usage: {\n          type: 'number',\n          description: 'The usage of the project.'\n        },\n        usageLimit: {\n          type: 'number',\n          description: 'The usage limit of the project.'\n        },\n        users: {\n          type: 'array',\n          description: 'The role of the authenticated user in the project.',\n          items: {\n            type: 'object',\n            properties: {\n              role: {\n                type: 'string',\n                description: 'The role of the authenticated user in the project.',\n                enum: [                  'owner',\n                  'member'\n                ]\n              }\n            },\n            required: [              'role'\n            ]\n          }\n        },\n        usersLimit: {\n          type: 'number',\n          description: 'The users limit of the project.'\n        }\n      },\n      required: [        'id',\n        'billingCycleStart',\n        'createdAt',\n        'domains',\n        'domainsLimit',\n        'linksLimit',\n        'linksUsage',\n        'logo',\n        'metadata',\n        'name',\n        'plan',\n        'slug',\n        'stripeConnectId',\n        'stripeId',\n        'tagsLimit',\n        'usage',\n        'usageLimit',\n        'users',\n        'usersLimit'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/projects/retrieve-projects.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_projects',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve a project for the authenticated user.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/project',\n  $defs: {\n    project: {\n      type: 'object',\n      title: 'Project',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the project.'\n        },\n        billingCycleStart: {\n          type: 'number',\n          description: 'The date and time when the billing cycle starts for the project.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the project was created.'\n        },\n        domains: {\n          type: 'array',\n          description: 'The domains of the project.',\n          items: {\n            type: 'object',\n            properties: {\n              slug: {\n                type: 'string',\n                description: 'The domain of the project.'\n              }\n            },\n            required: [              'slug'\n            ]\n          }\n        },\n        domainsLimit: {\n          type: 'number',\n          description: 'The domains limit of the project.'\n        },\n        linksLimit: {\n          type: 'number',\n          description: 'The links limit of the project.'\n        },\n        linksUsage: {\n          type: 'number',\n          description: 'The links usage of the project.'\n        },\n        logo: {\n          type: 'string',\n          description: 'The logo of the project.'\n        },\n        metadata: {\n          type: 'object',\n          properties: {\n            defaultDomains: {\n              type: 'array',\n              items: {\n                type: 'string'\n              }\n            }\n          },\n          required: [            'defaultDomains'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the project.'\n        },\n        plan: {\n          type: 'string',\n          description: 'The plan of the project.',\n          enum: [            'free',\n            'starter',\n            'pro',\n            'business',\n            'business plus',\n            'business extra',\n            'business max',\n            'enterprise'\n          ]\n        },\n        slug: {\n          type: 'string',\n          description: 'The slug of the project.'\n        },\n        stripeConnectId: {\n          type: 'string',\n          description: '[BETA]: The Stripe Connect ID of the project.'\n        },\n        stripeId: {\n          type: 'string',\n          description: 'The Stripe ID of the project.'\n        },\n        tagsLimit: {\n          type: 'number',\n          description: 'The tags limit of the project.'\n        },\n        usage: {\n          type: 'number',\n          description: 'The usage of the project.'\n        },\n        usageLimit: {\n          type: 'number',\n          description: 'The usage limit of the project.'\n        },\n        users: {\n          type: 'array',\n          description: 'The role of the authenticated user in the project.',\n          items: {\n            type: 'object',\n            properties: {\n              role: {\n                type: 'string',\n                description: 'The role of the authenticated user in the project.',\n                enum: [                  'owner',\n                  'member'\n                ]\n              }\n            },\n            required: [              'role'\n            ]\n          }\n        },\n        usersLimit: {\n          type: 'number',\n          description: 'The users limit of the project.'\n        }\n      },\n      required: [        'id',\n        'billingCycleStart',\n        'createdAt',\n        'domains',\n        'domainsLimit',\n        'linksLimit',\n        'linksUsage',\n        'logo',\n        'metadata',\n        'name',\n        'plan',\n        'slug',\n        'stripeConnectId',\n        'stripeId',\n        'tagsLimit',\n        'usage',\n        'usageLimit',\n        'users',\n        'usersLimit'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve a project for the authenticated user.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/project',\n  $defs: {\n    project: {\n      type: 'object',\n      title: 'Project',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique ID of the project.'\n        },\n        billingCycleStart: {\n          type: 'number',\n          description: 'The date and time when the billing cycle starts for the project.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when the project was created.'\n        },\n        domains: {\n          type: 'array',\n          description: 'The domains of the project.',\n          items: {\n            type: 'object',\n            properties: {\n              slug: {\n                type: 'string',\n                description: 'The domain of the project.'\n              }\n            },\n            required: [              'slug'\n            ]\n          }\n        },\n        domainsLimit: {\n          type: 'number',\n          description: 'The domains limit of the project.'\n        },\n        linksLimit: {\n          type: 'number',\n          description: 'The links limit of the project.'\n        },\n        linksUsage: {\n          type: 'number',\n          description: 'The links usage of the project.'\n        },\n        logo: {\n          type: 'string',\n          description: 'The logo of the project.'\n        },\n        metadata: {\n          type: 'object',\n          properties: {\n            defaultDomains: {\n              type: 'array',\n              items: {\n                type: 'string'\n              }\n            }\n          },\n          required: [            'defaultDomains'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the project.'\n        },\n        plan: {\n          type: 'string',\n          description: 'The plan of the project.',\n          enum: [            'free',\n            'starter',\n            'pro',\n            'business',\n            'scale',\n            'enterprise'\n          ]\n        },\n        slug: {\n          type: 'string',\n          description: 'The slug of the project.'\n        },\n        stripeConnectId: {\n          type: 'string',\n          description: '[BETA]: The Stripe Connect ID of the project.'\n        },\n        stripeId: {\n          type: 'string',\n          description: 'The Stripe ID of the project.'\n        },\n        tagsLimit: {\n          type: 'number',\n          description: 'The tags limit of the project.'\n        },\n        usage: {\n          type: 'number',\n          description: 'The usage of the project.'\n        },\n        usageLimit: {\n          type: 'number',\n          description: 'The usage limit of the project.'\n        },\n        users: {\n          type: 'array',\n          description: 'The role of the authenticated user in the project.',\n          items: {\n            type: 'object',\n            properties: {\n              role: {\n                type: 'string',\n                description: 'The role of the authenticated user in the project.',\n                enum: [                  'owner',\n                  'member'\n                ]\n              }\n            },\n            required: [              'role'\n            ]\n          }\n        },\n        usersLimit: {\n          type: 'number',\n          description: 'The users limit of the project.'\n        }\n      },\n      required: [        'id',\n        'billingCycleStart',\n        'createdAt',\n        'domains',\n        'domainsLimit',\n        'linksLimit',\n        'linksUsage',\n        'logo',\n        'metadata',\n        'name',\n        'plan',\n        'slug',\n        'stripeConnectId',\n        'stripeId',\n        'tagsLimit',\n        'usage',\n        'usageLimit',\n        'users',\n        'usersLimit'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qrcodes/bulk/create-qrcodes-bulk.ts

@@ -25,6 +25,10 @@ export const tool: Tool = {
         items: {
           type: 'object',
           properties: {
+            folderId: {
+              type: 'string',
+              description: 'The unique ID of the folder assigned to the QR code.',
+            },
             type: {
               type: 'string',
               description: 'The type of content of the QR code.',
@@ -1049,7 +1053,7 @@ export const tool: Tool = {
               additionalProperties: true,
             },
           },
-          required: ['type'],
+          required: ['folderId', 'type'],
         },
       },
     },

package/src/tools/qrcodes/count-qrcodes.ts

@@ -56,6 +56,10 @@ export const tool: Tool = {
         description: 'Filter QR codes expiring before this date',
         format: 'date-time',
       },
+      folderId: {
+        type: 'string',
+        description: 'The folder ID to filter the QR codes by.',
+      },
       format: {
         type: 'string',
         description: 'Filter by QR code format - static or dynamic',
@@ -64,7 +68,7 @@ export const tool: Tool = {
       groupBy: {
         type: 'string',
         description: 'The field to group the QR codes.',
-        enum: ['domain', 'tagId', 'userId'],
+        enum: ['domain', 'tagId', 'userId', 'folderId'],
       },
       hasComments: {
         type: 'boolean',

package/src/tools/qrcodes/create-qrcodes.ts

@@ -20,6 +20,10 @@ export const tool: Tool = {
   inputSchema: {
     type: 'object',
     properties: {
+      folderId: {
+        type: 'string',
+        description: 'The unique ID of the folder assigned to the QR code.',
+      },
       type: {
         type: 'string',
         description: 'The type of content of the QR code.',
@@ -1043,7 +1047,7 @@ export const tool: Tool = {
         additionalProperties: true,
       },
     },
-    required: ['type'],
+    required: ['folderId', 'type'],
   },
   annotations: {},
 };

package/src/tools/qrcodes/list-qrcodes.ts

@@ -54,6 +54,10 @@ export const tool: Tool = {
         description: 'Filter QR codes expiring before this date',
         format: 'date-time',
       },
+      folderId: {
+        type: 'string',
+        description: 'The folder ID to filter the QR codes by.',
+      },
       format: {
         type: 'string',
         description: 'Filter by QR code format - static or dynamic',

package/src/tools/qrcodes/update-qrcodes.ts

@@ -105,6 +105,10 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'If the QR code is flexible.',
       },
+      folderId: {
+        type: 'string',
+        description: 'The unique ID of the folder assigned to the QR code.',
+      },
       frame: {
         type: 'string',
         description: 'The type of frame of the QR code.',

package/src/tools/qrcodes/upsert-qrcodes.ts

@@ -21,6 +21,10 @@ export const tool: Tool = {
   inputSchema: {
     type: 'object',
     properties: {
+      folderId: {
+        type: 'string',
+        description: 'The unique ID of the folder assigned to the QR code.',
+      },
       type: {
         type: 'string',
         description: 'The type of content of the QR code.',
@@ -1044,7 +1048,7 @@ export const tool: Tool = {
         additionalProperties: true,
       },
     },
-    required: ['type'],
+    required: ['folderId', 'type'],
   },
   annotations: {},
 };

package/src/tools/track/track-lead-track.ts

@@ -24,34 +24,48 @@ export const tool: Tool = {
     properties: {
       clickId: {
         type: 'string',
-        description: 'The ID of the click in th CodeQR. You can read this value from `cq_id` cookie.',
+        description:
+          'The unique ID of the click that the lead conversion event is attributed to. You can read this value from `cd_id` cookie. If an empty string is provided, CodeQR will try to find an existing customer with the provided `customerExternalId` and use the `clickId` from the customer if found.',
       },
-      customerId: {
+      customerExternalId: {
         type: 'string',
         description:
-          "This is the unique identifier for the customer in the client's app. This is used to track the customer's journey.",
+          'The unique ID of the customer in your system. Will be used to identify and attribute all future events to this customer.',
       },
       eventName: {
         type: 'string',
-        description: 'The name of the event to track.',
+        description:
+          'The name of the lead event to track. Can also be used as a unique identifier to associate a given lead event for a customer for a subsequent sale event (via the `leadEventName` prop in `/track/sale`).',
       },
       customerAvatar: {
         type: 'string',
-        description: "Avatar of the customer in the client's app.",
+        description: 'The avatar URL of the customer.',
       },
       customerEmail: {
         type: 'string',
-        description: "Email of the customer in the client's app.",
+        description: 'The email address of the customer.',
       },
       customerName: {
         type: 'string',
-        description: "Name of the customer in the client's app.",
+        description:
+          'The name of the customer. If not passed, a random name will be generated (e.g. “Big Red Caribou”).',
+      },
+      eventQuantity: {
+        type: 'number',
+        description:
+          'The numerical value associated with this lead event (e.g., number of provisioned seats in a free trial). If defined as N, the lead event will be tracked N times.',
       },
       metadata: {
         type: 'object',
-        description: 'Additional metadata to be stored with the lead event',
+        description: 'Additional metadata to be stored with the lead event. Max 10,000 characters.',
         additionalProperties: true,
       },
+      mode: {
+        type: 'string',
+        description:
+          'The mode to use for tracking the lead event. `async` will not block the request; `wait` will block the request until the lead event is fully recorded in Dub; `deferred` will defer the lead event creation to a subsequent request.',
+        enum: ['async', 'wait', 'deferred'],
+      },
       jq_filter: {
         type: 'string',
         title: 'jq Filter',
@@ -59,7 +73,7 @@ export const tool: Tool = {
           'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
       },
     },
-    required: ['clickId', 'customerId', 'eventName'],
+    required: ['clickId', 'customerExternalId', 'eventName'],
   },
   annotations: {},
 };