@linkedapi/mcp 0.3.11 → 1.0.0

package/src/tools/admin-get-subscription-status.ts

@@ -0,0 +1,33 @@
+import { LinkedApiAdmin, TSubscriptionStatus } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+import { AdminTool } from '../utils/admin-tool.js';
+
+export class AdminGetSubscriptionStatusTool extends AdminTool<
+  Record<string, never>,
+  TSubscriptionStatus
+> {
+  public readonly name = 'admin_get_subscription_status';
+  protected readonly schema = z.object({});
+
+  public override async execute({
+    admin,
+  }: {
+    admin: LinkedApiAdmin;
+    args: Record<string, never>;
+  }): Promise<TSubscriptionStatus> {
+    return await admin.subscription.getStatus();
+  }
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description: 'Get current subscription status, trial eligibility, and cancellation schedule.',
+      inputSchema: {
+        type: 'object',
+        properties: {},
+      },
+    };
+  }
+}

package/src/tools/admin-regenerate-token.ts

@@ -0,0 +1,43 @@
+import { LinkedApiAdmin, TRegenerateTokenParams, TRegenerateTokenResult } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+import { AdminTool } from '../utils/admin-tool.js';
+
+export class AdminRegenerateTokenTool extends AdminTool<
+  TRegenerateTokenParams,
+  TRegenerateTokenResult
+> {
+  public readonly name = 'admin_regenerate_token';
+  protected readonly schema = z.object({
+    accountId: z.string(),
+  });
+
+  public override async execute({
+    admin,
+    args,
+  }: {
+    admin: LinkedApiAdmin;
+    args: TRegenerateTokenParams;
+  }): Promise<TRegenerateTokenResult> {
+    return await admin.accounts.regenerateIdentificationToken(args);
+  }
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description:
+        'Regenerate identification token for an account. The old token becomes invalid immediately.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          accountId: {
+            type: 'string',
+            description: 'UUID of the account',
+          },
+        },
+        required: ['accountId'],
+      },
+    };
+  }
+}

package/src/tools/admin-reset-limits.ts

@@ -0,0 +1,39 @@
+import { LinkedApiAdmin, TResetLimitsParams } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+import { AdminTool } from '../utils/admin-tool.js';
+
+export class AdminResetLimitsTool extends AdminTool<TResetLimitsParams, void> {
+  public readonly name = 'admin_reset_limits';
+  protected readonly schema = z.object({
+    accountId: z.string(),
+  });
+
+  public override async execute({
+    admin,
+    args,
+  }: {
+    admin: LinkedApiAdmin;
+    args: TResetLimitsParams;
+  }): Promise<void> {
+    await admin.limits.resetToDefaults(args);
+  }
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description: 'Reset all rate limits for an account to the system defaults.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          accountId: {
+            type: 'string',
+            description: 'Account UUID',
+          },
+        },
+        required: ['accountId'],
+      },
+    };
+  }
+}

package/src/tools/admin-set-limits.ts

@@ -0,0 +1,75 @@
+import { LinkedApiAdmin, TSetLimitsParams } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+import { AdminTool } from '../utils/admin-tool.js';
+
+export class AdminSetLimitsTool extends AdminTool<TSetLimitsParams, void> {
+  public readonly name = 'admin_set_limits';
+  protected readonly schema = z.object({
+    accountId: z.string(),
+    limits: z.array(
+      z.object({
+        category: z.string(),
+        period: z.enum(['daily', 'weekly', 'monthly']),
+        maxValue: z.number().int().min(0),
+        isEnabled: z.boolean().optional(),
+      }),
+    ),
+  });
+
+  public override async execute({
+    admin,
+    args,
+  }: {
+    admin: LinkedApiAdmin;
+    args: TSetLimitsParams;
+  }): Promise<void> {
+    await admin.limits.set(args);
+  }
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description:
+        'Set rate limits for an account. Only specified limits are created or updated; other limits remain unchanged. Categories: stPersonProfileViews, stCompanyPageViews, stConnectionRequests, stMessages, stSearchQueries, stReactions, stComments, stPosts, nvPersonProfileViews, nvCompanyPageViews, nvMessages.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          accountId: {
+            type: 'string',
+            description: 'Account UUID',
+          },
+          limits: {
+            type: 'array',
+            description: 'Array of limit configurations',
+            items: {
+              type: 'object',
+              properties: {
+                category: {
+                  type: 'string',
+                  description: 'Limit category',
+                },
+                period: {
+                  type: 'string',
+                  enum: ['daily', 'weekly', 'monthly'],
+                  description: 'Limit period',
+                },
+                maxValue: {
+                  type: 'number',
+                  description: 'Maximum allowed actions (>= 0)',
+                },
+                isEnabled: {
+                  type: 'boolean',
+                  description: 'Whether this limit is enforced (default: true)',
+                },
+              },
+              required: ['category', 'period', 'maxValue'],
+            },
+          },
+        },
+        required: ['accountId', 'limits'],
+      },
+    };
+  }
+}

package/src/tools/admin-set-seats.ts

@@ -0,0 +1,52 @@
+import { LinkedApiAdmin, TSetSeatsParams, TSetSeatsResult } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+import { AdminTool } from '../utils/admin-tool.js';
+
+export class AdminSetSeatsTool extends AdminTool<TSetSeatsParams, TSetSeatsResult> {
+  public readonly name = 'admin_set_seats';
+  protected readonly schema = z.object({
+    quantity: z.number().int().min(1).max(1000),
+    seatType: z.enum(['core', 'plus']),
+    billingPeriod: z.enum(['month', 'year']),
+  });
+
+  public override async execute({
+    admin,
+    args,
+  }: {
+    admin: LinkedApiAdmin;
+    args: TSetSeatsParams;
+  }): Promise<TSetSeatsResult> {
+    return await admin.subscription.setSeats(args);
+  }
+
+  public override getTool(): Tool {
+    return {
+      name: this.name,
+      description:
+        'Set number of subscription seats. Returns checkout link if no active subscription, otherwise updates immediately.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          quantity: {
+            type: 'number',
+            description: 'Number of seats (1-1000)',
+          },
+          seatType: {
+            type: 'string',
+            enum: ['core', 'plus'],
+            description: 'Seat type. "plus" unlocks Sales Navigator actions.',
+          },
+          billingPeriod: {
+            type: 'string',
+            enum: ['month', 'year'],
+            description: 'Billing period',
+          },
+        },
+        required: ['quantity', 'seatType', 'billingPeriod'],
+      },
+    };
+  }
+}

package/src/utils/admin-tool.ts

@@ -0,0 +1,22 @@
+import { LinkedApiAdmin } from '@linkedapi/node';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import z from 'zod';
+
+export abstract class AdminTool<TParams, TResult> {
+  public abstract readonly name: string;
+  protected abstract readonly schema: z.ZodSchema;
+
+  public abstract getTool(): Tool;
+
+  public validate(args: unknown): TParams {
+    return this.schema.parse(args) as TParams;
+  }
+
+  public abstract execute({
+    admin,
+    args,
+  }: {
+    admin: LinkedApiAdmin;
+    args: TParams;
+  }): Promise<TResult>;
+}