@linkforty/mcp-server 0.1.0

package/dist/tools/links.js

@@ -0,0 +1,131 @@
+/**
+ * Link management tools.
+ */
+import { z } from 'zod';
+import { defineTool } from './shared.js';
+const utmSchema = z
+    .object({
+    source: z.string().optional(),
+    medium: z.string().optional(),
+    campaign: z.string().optional(),
+    term: z.string().optional(),
+    content: z.string().optional(),
+})
+    .optional();
+const targetingSchema = z
+    .object({
+    countries: z.array(z.string()).optional(),
+    devices: z.array(z.enum(['ios', 'android', 'web'])).optional(),
+    languages: z.array(z.string()).optional(),
+})
+    .optional();
+const linkInputSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    iosUrl: z.string().url().optional(),
+    androidUrl: z.string().url().optional(),
+    webFallbackUrl: z.string().url().optional(),
+    customSchemeUrl: z.string().optional(),
+    customCode: z.string().optional(),
+    projectId: z.string().uuid().optional(),
+    templateId: z.string().uuid().optional(),
+    templateSlug: z.string().optional(),
+    utmParameters: utmSchema,
+    targetingRules: targetingSchema,
+    deepLinkParameters: z.record(z.any()).optional(),
+    attributionWindowHours: z.number().int().min(1).max(2160).optional(),
+    expiresAt: z.string().datetime().optional(),
+});
+export const createLinkTool = defineTool({
+    name: 'create_link',
+    description: 'Create a new deep link in LinkForty. Supports device-specific URLs (iOS App Store, Google Play, web fallback), UTM parameters, targeting rules, custom short codes, deep link parameters, attribution window, and expiration. Returns the created link with its short URL.',
+    schema: linkInputSchema,
+    handler: async (args, client) => {
+        return client.post('/links', args);
+    },
+});
+export const listLinksTool = defineTool({
+    name: 'list_links',
+    description: 'List deep links in the current workspace. Supports filtering by status (active/inactive), source (dashboard/sdk/bulk/migration), project, search query (title/description/short code), and date range. Returns a paginated list with click counts.',
+    schema: z.object({
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+        search: z.string().optional(),
+        status: z.enum(['active', 'inactive']).optional(),
+        source: z.enum(['dashboard', 'sdk', 'bulk', 'migration']).optional(),
+        projectId: z.string().uuid().optional(),
+        createdAfter: z.string().datetime().optional(),
+        createdBefore: z.string().datetime().optional(),
+    }),
+    handler: async (args, client) => {
+        return client.get('/links', args);
+    },
+});
+export const getLinkTool = defineTool({
+    name: 'get_link',
+    description: 'Get a single deep link by ID or short code. Use this to inspect a specific link\'s configuration, destinations, UTM parameters, and stats.',
+    schema: z.object({
+        id: z.string().uuid().optional().describe('Link UUID. Use this OR shortCode.'),
+        shortCode: z.string().optional().describe('Link short code (e.g. "abc123"). Use this OR id.'),
+    }),
+    handler: async (args, client) => {
+        if (args.id)
+            return client.get(`/links/${args.id}`);
+        if (args.shortCode)
+            return client.get(`/links/discover/${args.shortCode}`);
+        throw new Error('Either id or shortCode must be provided');
+    },
+});
+export const updateLinkTool = defineTool({
+    name: 'update_link',
+    description: 'Update an existing deep link. All fields are optional — only provided fields are updated. Use this to change destinations, UTM parameters, targeting rules, status (active/inactive), or expiration.',
+    schema: z.object({
+        id: z.string().uuid().describe('Link UUID to update'),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        iosUrl: z.string().url().optional(),
+        androidUrl: z.string().url().optional(),
+        webFallbackUrl: z.string().url().optional(),
+        customSchemeUrl: z.string().optional(),
+        projectId: z.string().uuid().optional(),
+        utmParameters: utmSchema,
+        targetingRules: targetingSchema,
+        deepLinkParameters: z.record(z.any()).optional(),
+        attributionWindowHours: z.number().int().min(1).max(2160).optional(),
+        expiresAt: z.string().datetime().optional(),
+        isActive: z.boolean().optional(),
+    }),
+    handler: async (args, client) => {
+        const { id, ...body } = args;
+        return client.put(`/links/${id}`, body);
+    },
+});
+export const deleteLinkTool = defineTool({
+    name: 'delete_link',
+    description: 'Permanently delete a deep link by ID. This action cannot be undone — historical click events for the link are also removed.',
+    schema: z.object({
+        id: z.string().uuid().describe('Link UUID to delete'),
+    }),
+    handler: async (args, client) => {
+        return client.delete(`/links/${args.id}`);
+    },
+});
+export const bulkCreateLinksTool = defineTool({
+    name: 'bulk_create_links',
+    description: 'Create up to 100 deep links in a single request. Each link in the array uses the same shape as create_link. Returns the count and the array of created links. Useful for importing campaigns or generating links in bulk.',
+    schema: z.object({
+        links: z.array(linkInputSchema).min(1).max(100),
+    }),
+    handler: async (args, client) => {
+        return client.post('/links/bulk-create', args);
+    },
+});
+export const linkTools = [
+    createLinkTool,
+    listLinksTool,
+    getLinkTool,
+    updateLinkTool,
+    deleteLinkTool,
+    bulkCreateLinksTool,
+];
+//# sourceMappingURL=links.js.map

package/dist/tools/links.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,4 @@
+export declare const listProjectsTool: import("./shared.js").ToolDefinition;
+export declare const createProjectTool: import("./shared.js").ToolDefinition;
+export declare const projectTools: import("./shared.js").ToolDefinition[];
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,sCAQ3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,sCAW5B,CAAC;AAEH,eAAO,MAAM,YAAY,wCAAwC,CAAC"}

package/dist/tools/projects.js

@@ -0,0 +1,26 @@
+/**
+ * Project tools — for grouping links.
+ */
+import { z } from 'zod';
+import { defineTool } from './shared.js';
+export const listProjectsTool = defineTool({
+    name: 'list_projects',
+    description: 'List all projects in the current workspace. Projects are containers for organizing related deep links — for example, by campaign, product, or feature.',
+    schema: z.object({}),
+    handler: async (_args, client) => {
+        return client.get('/projects');
+    },
+});
+export const createProjectTool = defineTool({
+    name: 'create_project',
+    description: 'Create a new project to group related links. Returns the created project. Use the project ID when creating links to associate them with this project.',
+    schema: z.object({
+        name: z.string().min(1).max(255),
+        description: z.string().optional(),
+    }),
+    handler: async (args, client) => {
+        return client.post('/projects', args);
+    },
+});
+export const projectTools = [listProjectsTool, createProjectTool];
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,wJAAwJ;IAC1J,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,uJAAuJ;IACzJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/tools/sdk.d.ts

@@ -0,0 +1,3 @@
+export declare const getSdkInstallSnippetTool: import("./shared.js").ToolDefinition;
+export declare const sdkTools: import("./shared.js").ToolDefinition[];
+//# sourceMappingURL=sdk.d.ts.map

package/dist/tools/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/tools/sdk.ts"],"names":[],"mappings":"AAmLA,eAAO,MAAM,wBAAwB,sCAiCnC,CAAC;AAEH,eAAO,MAAM,QAAQ,wCAA6B,CAAC"}

package/dist/tools/sdk.js

@@ -0,0 +1,190 @@
+/**
+ * SDK helper tool — generates ready-to-paste init code for any platform
+ * using the user's API key and current workspace context.
+ */
+import { z } from 'zod';
+import { defineTool } from './shared.js';
+function reactNativeSnippet(ctx) {
+    return `// 1. Install the SDK
+//    npm install @linkforty/mobile-sdk-react-native
+//
+// 2. Initialize once at app startup (e.g. in App.tsx)
+import LinkForty from '@linkforty/mobile-sdk-react-native';
+
+LinkForty.init({
+  apiKey: '${ctx.apiKey}',
+  baseUrl: '${ctx.baseUrl}',
+});
+
+// 3. Listen for deep links
+LinkForty.onDeepLink((data) => {
+  console.log('Deep link data:', data);
+  // Navigate based on data.deepLinkParameters
+});
+
+// 4. (Optional) Listen for deferred deep links — fires once on first launch
+LinkForty.onDeferredDeepLink((data) => {
+  if (data) console.log('Install attributed to:', data);
+});`;
+}
+function expoSnippet(ctx) {
+    return `// 1. Install the SDK
+//    npx expo install @linkforty/mobile-sdk-expo
+//
+// 2. Initialize once at app startup (e.g. in app/_layout.tsx)
+import LinkForty from '@linkforty/mobile-sdk-expo';
+import { useEffect } from 'react';
+
+export default function RootLayout() {
+  useEffect(() => {
+    LinkForty.init({
+      apiKey: '${ctx.apiKey}',
+      baseUrl: '${ctx.baseUrl}',
+    });
+
+    LinkForty.onDeepLink((data) => {
+      console.log('Deep link data:', data);
+    });
+
+    LinkForty.onDeferredDeepLink((data) => {
+      if (data) console.log('Install attributed to:', data);
+    });
+  }, []);
+
+  return /* your app */;
+}`;
+}
+function iosSnippet(ctx) {
+    return `// 1. Add the LinkForty SDK via Swift Package Manager:
+//    https://github.com/linkforty/mobile-sdk-ios
+//
+// 2. In your AppDelegate or App struct:
+import LinkForty
+
+@main
+struct YourApp: App {
+  init() {
+    LinkForty.shared.initialize(
+      apiKey: "${ctx.apiKey}",
+      baseURL: "${ctx.baseUrl}"
+    )
+
+    LinkForty.shared.onDeepLink { data in
+      print("Deep link: \\(data)")
+    }
+
+    LinkForty.shared.onDeferredDeepLink { data in
+      if let data = data {
+        print("Install attributed to: \\(data)")
+      }
+    }
+  }
+
+  var body: some Scene {
+    WindowGroup { ContentView() }
+  }
+}
+
+// Bundle ID: ${ctx.appConfig.iosBundleId ?? '(not configured)'}
+// Universal Link domain: ${ctx.appConfig.iosUniversalLinkDomain ?? '(not configured)'}`;
+}
+function androidSnippet(ctx) {
+    return `// 1. Add to your build.gradle:
+//    implementation 'com.linkforty:mobile-sdk-android:1.0.0'
+//
+// 2. Initialize in your Application class:
+import com.linkforty.LinkForty
+
+class MyApp : Application() {
+  override fun onCreate() {
+    super.onCreate()
+
+    LinkForty.init(
+      context = this,
+      apiKey = "${ctx.apiKey}",
+      baseUrl = "${ctx.baseUrl}"
+    )
+
+    LinkForty.onDeepLink { data ->
+      Log.d("LinkForty", "Deep link: $data")
+    }
+
+    LinkForty.onDeferredDeepLink { data ->
+      if (data != null) {
+        Log.d("LinkForty", "Install attributed to: $data")
+      }
+    }
+  }
+}
+
+// Package name: ${ctx.appConfig.androidPackageName ?? '(not configured)'}
+// App Link domain: ${ctx.appConfig.androidAppLinkDomain ?? '(not configured)'}`;
+}
+function flutterSnippet(ctx) {
+    return `// 1. Add to pubspec.yaml:
+//    dependencies:
+//      linkforty: ^1.0.0
+//
+// 2. Initialize in main.dart:
+import 'package:linkforty/linkforty.dart';
+import 'package:flutter/material.dart';
+
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+
+  await LinkForty.init(
+    apiKey: '${ctx.apiKey}',
+    baseUrl: '${ctx.baseUrl}',
+  );
+
+  LinkForty.onDeepLink((data) {
+    print('Deep link: $data');
+  });
+
+  LinkForty.onDeferredDeepLink((data) {
+    if (data != null) print('Install attributed to: $data');
+  });
+
+  runApp(const MyApp());
+}`;
+}
+const snippetGenerators = {
+    'react-native': reactNativeSnippet,
+    expo: expoSnippet,
+    ios: iosSnippet,
+    android: androidSnippet,
+    flutter: flutterSnippet,
+};
+export const getSdkInstallSnippetTool = defineTool({
+    name: 'get_sdk_install_snippet',
+    description: 'Generate a ready-to-paste SDK initialization snippet for a specific mobile platform. The snippet is pre-filled with the user\'s API key, base URL, and app config (bundle IDs, schemes, link domains) from the current workspace. Supported platforms: react-native, expo, ios, android, flutter. Use this to help a developer integrate LinkForty into their mobile app in under a minute.',
+    schema: z.object({
+        platform: z.enum(['react-native', 'expo', 'ios', 'android', 'flutter']),
+    }),
+    handler: async (args, client) => {
+        // Pull current workspace and app config so the snippet is fully filled in
+        const workspaces = await client.get('/workspaces');
+        if (!workspaces?.length) {
+            throw new Error('No workspaces accessible by this API key');
+        }
+        const wsId = workspaces[0].id;
+        const appConfig = await client.get(`/workspaces/${wsId}/app-config`).catch(() => ({}));
+        // The MCP server doesn't have direct access to the user's API key string
+        // because it lives in process.env. Pull it from the env via the client config.
+        // We re-read process.env here since the client doesn't expose the key directly.
+        const apiKey = process.env.LINKFORTY_API_KEY ?? 'YOUR_API_KEY';
+        const baseUrl = (process.env.LINKFORTY_BASE_URL || 'https://app.linkforty.com/api')
+            .replace(/\/api\/?$/, '');
+        const generator = snippetGenerators[args.platform];
+        if (!generator)
+            throw new Error(`Unsupported platform: ${args.platform}`);
+        return {
+            platform: args.platform,
+            snippet: generator({ apiKey, baseUrl, appConfig }),
+            appConfig,
+            docs: `https://docs.linkforty.com/sdks/${args.platform}`,
+        };
+    },
+});
+export const sdkTools = [getSdkInstallSnippetTool];
+//# sourceMappingURL=sdk.js.map

package/dist/tools/sdk.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared helpers for tool definitions.
+ */
+import { z } from 'zod';
+import type { LinkFortyClient } from '../client.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: any, client: LinkFortyClient) => Promise<unknown>;
+}
+/**
+ * Creates a tool definition from a Zod schema. The schema is converted to
+ * JSON Schema for the MCP tool listing, and used to validate inputs at call time.
+ */
+export declare function defineTool<TSchema extends z.ZodTypeAny>(opts: {
+    name: string;
+    description: string;
+    schema: TSchema;
+    handler: (args: z.infer<TSchema>, client: LinkFortyClient) => Promise<unknown>;
+}): ToolDefinition;
+/**
+ * Format any value as a JSON string suitable for an MCP text content block.
+ */
+export declare function asText(value: unknown): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF,GAAG,cAAc,CAUjB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG7C"}

package/dist/tools/shared.js

@@ -0,0 +1,25 @@
+import { zodToJsonSchema } from './zod-to-json-schema.js';
+/**
+ * Creates a tool definition from a Zod schema. The schema is converted to
+ * JSON Schema for the MCP tool listing, and used to validate inputs at call time.
+ */
+export function defineTool(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        inputSchema: zodToJsonSchema(opts.schema),
+        handler: async (args, client) => {
+            const parsed = opts.schema.parse(args ?? {});
+            return opts.handler(parsed, client);
+        },
+    };
+}
+/**
+ * Format any value as a JSON string suitable for an MCP text content block.
+ */
+export function asText(value) {
+    if (typeof value === 'string')
+        return value;
+    return JSON.stringify(value, null, 2);
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW1D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAA+B,IAKxD;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAA4B;QACpE,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,MAAuB,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/tools/templates.d.ts

@@ -0,0 +1,5 @@
+export declare const listTemplatesTool: import("./shared.js").ToolDefinition;
+export declare const createTemplateTool: import("./shared.js").ToolDefinition;
+export declare const setDefaultTemplateTool: import("./shared.js").ToolDefinition;
+export declare const templateTools: import("./shared.js").ToolDefinition[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/tools/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,iBAAiB,sCAQ5B,CAAC;AAEH,eAAO,MAAM,kBAAkB,sCAa7B,CAAC;AAEH,eAAO,MAAM,sBAAsB,sCAUjC,CAAC;AAEH,eAAO,MAAM,aAAa,wCAAkE,CAAC"}

package/dist/tools/templates.js

@@ -0,0 +1,65 @@
+/**
+ * Link template tools.
+ */
+import { z } from 'zod';
+import { defineTool } from './shared.js';
+const utmSchema = z
+    .object({
+    source: z.string().optional(),
+    medium: z.string().optional(),
+    campaign: z.string().optional(),
+    term: z.string().optional(),
+    content: z.string().optional(),
+})
+    .optional();
+const targetingSchema = z
+    .object({
+    countries: z.array(z.string()).optional(),
+    devices: z.array(z.enum(['ios', 'android', 'web'])).optional(),
+    languages: z.array(z.string()).optional(),
+})
+    .optional();
+const templateSettingsSchema = z
+    .object({
+    defaultIosUrl: z.string().url().optional(),
+    defaultAndroidUrl: z.string().url().optional(),
+    defaultWebFallbackUrl: z.string().url().optional(),
+    defaultAttributionWindowHours: z.number().int().min(1).max(2160).optional(),
+    utmParameters: utmSchema,
+    targetingRules: targetingSchema,
+    expiresAfterDays: z.number().int().min(1).optional(),
+})
+    .optional();
+export const listTemplatesTool = defineTool({
+    name: 'list_templates',
+    description: 'List all link templates in the current workspace. Templates define default destinations, UTM parameters, and targeting rules that new links can inherit. Each template has a slug used for URL routing.',
+    schema: z.object({}),
+    handler: async (_args, client) => {
+        return client.get('/templates');
+    },
+});
+export const createTemplateTool = defineTool({
+    name: 'create_template',
+    description: 'Create a new link template. Templates let you define default destinations (iOS/Android/web), UTM parameters, targeting rules, and attribution windows that new links inherit. Useful for ensuring consistency across campaigns.',
+    schema: z.object({
+        name: z.string().min(1).max(255),
+        description: z.string().optional(),
+        isDefault: z.boolean().optional(),
+        settings: templateSettingsSchema,
+    }),
+    handler: async (args, client) => {
+        return client.post('/templates', args);
+    },
+});
+export const setDefaultTemplateTool = defineTool({
+    name: 'set_default_template',
+    description: 'Mark a template as the default for the workspace. The default template is used by the SDK when creating links from mobile apps without specifying a template.',
+    schema: z.object({
+        id: z.string().uuid().describe('Template UUID to set as default'),
+    }),
+    handler: async (args, client) => {
+        return client.put(`/templates/${args.id}/set-default`, {});
+    },
+});
+export const templateTools = [listTemplatesTool, createTemplateTool, setDefaultTemplateTool];
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

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

package/dist/tools/workspaces.d.ts

@@ -0,0 +1,5 @@
+export declare const listWorkspacesTool: import("./shared.js").ToolDefinition;
+export declare const getCurrentWorkspaceTool: import("./shared.js").ToolDefinition;
+export declare const getAppConfigTool: import("./shared.js").ToolDefinition;
+export declare const workspaceTools: import("./shared.js").ToolDefinition[];
+//# sourceMappingURL=workspaces.d.ts.map

package/dist/tools/workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/tools/workspaces.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,kBAAkB,sCAQ7B,CAAC;AAEH,eAAO,MAAM,uBAAuB,sCAalC,CAAC;AAEH,eAAO,MAAM,gBAAgB,sCAY3B,CAAC;AAEH,eAAO,MAAM,cAAc,wCAAkE,CAAC"}

package/dist/tools/workspaces.js

@@ -0,0 +1,44 @@
+/**
+ * Workspace (organization) tools.
+ *
+ * Note: an API key is scoped to a single workspace, so list_workspaces always
+ * returns just the workspace the key belongs to. The other tools operate on
+ * the current workspace implicitly.
+ */
+import { z } from 'zod';
+import { defineTool } from './shared.js';
+export const listWorkspacesTool = defineTool({
+    name: 'list_workspaces',
+    description: 'List all workspaces accessible by the current API key. Note: API keys are scoped to a single workspace, so this typically returns one workspace. Use this to confirm which workspace the AI is connected to.',
+    schema: z.object({}),
+    handler: async (_args, client) => {
+        return client.get('/workspaces');
+    },
+});
+export const getCurrentWorkspaceTool = defineTool({
+    name: 'get_current_workspace',
+    description: 'Get details about the current workspace including subscription tier, member count, link count, project count, and settings. Returns the workspace bound to the active API key.',
+    schema: z.object({}),
+    handler: async (_args, client) => {
+        // List returns just one workspace for an API key — pick the first
+        const workspaces = await client.get('/workspaces');
+        if (!workspaces?.length) {
+            throw new Error('No workspaces accessible by this API key');
+        }
+        return client.get(`/workspaces/${workspaces[0].id}`);
+    },
+});
+export const getAppConfigTool = defineTool({
+    name: 'get_app_config',
+    description: 'Get the iOS/Android app configuration for the current workspace, including app scheme, bundle IDs, package name, Universal Link/App Link domains, app store URLs, and SHA256 fingerprints. Use this to know how to integrate the SDK or build deep link URLs that open the right app.',
+    schema: z.object({}),
+    handler: async (_args, client) => {
+        const workspaces = await client.get('/workspaces');
+        if (!workspaces?.length) {
+            throw new Error('No workspaces accessible by this API key');
+        }
+        return client.get(`/workspaces/${workspaces[0].id}/app-config`);
+    },
+});
+export const workspaceTools = [listWorkspacesTool, getCurrentWorkspaceTool, getAppConfigTool];
+//# sourceMappingURL=workspaces.js.map

package/dist/tools/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/tools/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,8MAA8M;IAChN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,gLAAgL;IAClL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,kEAAkE;QAClE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,CAAwB,aAAa,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,eAAe,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,uRAAuR;IACzR,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,CAAwB,aAAa,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,eAAe,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAClE,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/tools/zod-to-json-schema.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Minimal Zod → JSON Schema converter for our tool input schemas.
+ *
+ * Supports the subset we actually use: object, string, number, boolean, enum,
+ * array, optional, default, nullable. Anything else degrades to `{}`.
+ *
+ * Avoids pulling in the full `zod-to-json-schema` package to keep the bundle small.
+ */
+import { ZodTypeAny } from 'zod';
+interface JsonSchema {
+    type?: string;
+    description?: string;
+    enum?: unknown[];
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    format?: string;
+    nullable?: boolean;
+}
+export declare function zodToJsonSchema(schema: ZodTypeAny): JsonSchema;
+export {};
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/tools/zod-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../../src/tools/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE9D"}