@meetlark/mcp-server 1.0.0

package/dist/src/index.d.ts

@@ -0,0 +1,26 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+declare function createMeetLarkServer(apiUrl?: string): McpServer;
+
+interface MeetLarkError {
+    status: number;
+    code: string;
+    message: string;
+}
+interface MeetLarkResult<T> {
+    data?: T;
+    error?: MeetLarkError;
+}
+declare class MeetLarkClient {
+    private apiUrl;
+    constructor(apiUrl?: string);
+    private request;
+    createPoll(data: Record<string, unknown>): Promise<MeetLarkResult<unknown>>;
+    getResults(participateToken: string): Promise<MeetLarkResult<unknown>>;
+    vote(participateToken: string, data: Record<string, unknown>): Promise<MeetLarkResult<unknown>>;
+    getAdminView(adminToken: string): Promise<MeetLarkResult<unknown>>;
+    closePoll(adminToken: string): Promise<MeetLarkResult<unknown>>;
+    reopenPoll(adminToken: string): Promise<MeetLarkResult<unknown>>;
+}
+
+export { MeetLarkClient, type MeetLarkError, type MeetLarkResult, createMeetLarkServer };

package/dist/src/index.js

@@ -0,0 +1,8 @@
+import {
+  MeetLarkClient,
+  createMeetLarkServer
+} from "../chunk-AFREFQH7.js";
+export {
+  MeetLarkClient,
+  createMeetLarkServer
+};

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@meetlark/mcp-server",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "meetlark-mcp": "./dist/bin/cli.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "test": "node --test --import tsx test/*.test.ts",
+    "dev": "tsup --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "5.9.3"
+  }
+}

package/server.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "ai.meetlark/mcp-server",
+  "description": "Agent-first scheduling poll service. Create polls, collect availability votes, find times that work for groups. No accounts needed.",
+  "version": "1.0.0",
+  "remotes": [
+    {
+      "type": "sse",
+      "url": "https://meetlark.ai/mcp"
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,12 @@
+name: meetlark-mcp-server
+description: Agent-first scheduling poll service. Create polls, collect availability votes, find times that work for groups. No accounts needed.
+tags:
+  - scheduling
+  - polls
+  - mcp
+command:
+  type: stdio
+  command: npx
+  args:
+    - -y
+    - "@meetlark/mcp-server"

package/src/client.ts

@@ -0,0 +1,96 @@
+import { MEETLARK_API_URL } from "./config.js";
+
+export interface MeetLarkError {
+  status: number;
+  code: string;
+  message: string;
+}
+
+export interface MeetLarkResult<T> {
+  data?: T;
+  error?: MeetLarkError;
+}
+
+export class MeetLarkClient {
+  private apiUrl: string;
+
+  constructor(apiUrl?: string) {
+    this.apiUrl = apiUrl ?? MEETLARK_API_URL;
+  }
+
+  private async request<T>(
+    path: string,
+    options?: RequestInit,
+  ): Promise<MeetLarkResult<T>> {
+    let response: Response;
+    try {
+      response = await fetch(`${this.apiUrl}${path}`, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          ...options?.headers,
+        },
+      });
+    } catch (err) {
+      return {
+        error: {
+          status: 0,
+          code: "network_error",
+          message:
+            err instanceof Error ? err.message : "Network request failed",
+        },
+      };
+    }
+
+    const body = await response.json();
+
+    if (!response.ok) {
+      return {
+        error: {
+          status: response.status,
+          code: body.error?.code ?? "unknown_error",
+          message: body.error?.message ?? response.statusText,
+        },
+      };
+    }
+
+    return { data: body.data };
+  }
+
+  async createPoll(data: Record<string, unknown>): Promise<MeetLarkResult<unknown>> {
+    return this.request("/api/v1/polls?autoVerify=true", {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async getResults(participateToken: string): Promise<MeetLarkResult<unknown>> {
+    return this.request(`/api/v1/vote/participate/${participateToken}`);
+  }
+
+  async vote(
+    participateToken: string,
+    data: Record<string, unknown>,
+  ): Promise<MeetLarkResult<unknown>> {
+    return this.request(`/api/v1/vote/participate/${participateToken}`, {
+      method: "POST",
+      body: JSON.stringify(data),
+    });
+  }
+
+  async getAdminView(adminToken: string): Promise<MeetLarkResult<unknown>> {
+    return this.request(`/api/v1/polls/admin/${adminToken}`);
+  }
+
+  async closePoll(adminToken: string): Promise<MeetLarkResult<unknown>> {
+    return this.request(`/api/v1/polls/admin/${adminToken}/close`, {
+      method: "POST",
+    });
+  }
+
+  async reopenPoll(adminToken: string): Promise<MeetLarkResult<unknown>> {
+    return this.request(`/api/v1/polls/admin/${adminToken}/reopen`, {
+      method: "POST",
+    });
+  }
+}

package/src/config.ts

@@ -0,0 +1,2 @@
+export const MEETLARK_API_URL =
+  process.env.MEETLARK_API_URL || "https://meetlark.ai";

package/src/index.ts

@@ -0,0 +1,3 @@
+export { createMeetLarkServer } from "./server.js";
+export { MeetLarkClient } from "./client.js";
+export type { MeetLarkError, MeetLarkResult } from "./client.js";

package/src/server.ts

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MeetLarkClient } from "./client.js";
+import {
+  registerCreatePoll,
+  registerGetResults,
+  registerVote,
+  registerGetAdmin,
+  registerClosePoll,
+  registerReopenPoll,
+} from "./tools/index.js";
+
+export function createMeetLarkServer(apiUrl?: string): McpServer {
+  const server = new McpServer({
+    name: "meetlark",
+    version: "1.0.0",
+  });
+
+  const client = new MeetLarkClient(apiUrl);
+
+  registerCreatePoll(server, client);
+  registerGetResults(server, client);
+  registerVote(server, client);
+  registerGetAdmin(server, client);
+  registerClosePoll(server, client);
+  registerReopenPoll(server, client);
+
+  return server;
+}

package/src/tools/close-poll.ts

@@ -0,0 +1,75 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerClosePoll(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_close_poll", {
+    description:
+      "Close a poll to stop accepting new votes. " +
+      "Use the admin token from poll creation.",
+    inputSchema: {
+      adminToken: z
+        .string()
+        .describe("The adm_xxx token from poll creation"),
+    },
+  }, async (args) => {
+    const result = await client.closePoll(args.adminToken);
+
+    if (result.error) {
+      if (result.error.code === "poll_not_found") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Poll not found. The admin token may be invalid.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "poll_already_closed") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "This poll is already closed.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Could not connect to MeetLark API.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}

package/src/tools/create-poll.ts

@@ -0,0 +1,84 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerCreatePoll(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_create_poll", {
+    description:
+      "Create a scheduling poll to find a time that works for a group. " +
+      "Returns an admin URL (keep private) and a participation URL " +
+      "(share with participants). The creator's email must be verified -- " +
+      "if not yet verified, a verification email is sent automatically. " +
+      "Ask the user to check their inbox and click the link, then retry.",
+    inputSchema: {
+      title: z.string().describe("What is this poll for?"),
+      description: z
+        .string()
+        .optional()
+        .describe("Additional context for participants"),
+      timeSlots: z
+        .array(
+          z.object({
+            date: z.string().describe("Date in YYYY-MM-DD format"),
+            startTime: z.string().describe("Start time in HH:MM format"),
+            endTime: z.string().describe("End time in HH:MM format"),
+          }),
+        )
+        .describe("Available time slots to vote on"),
+      creatorEmail: z
+        .string()
+        .describe("Email address of the poll creator"),
+      creatorName: z
+        .string()
+        .optional()
+        .describe("Name of the poll creator"),
+    },
+  }, async (args) => {
+    const result = await client.createPoll(args);
+
+    if (result.error) {
+      if (result.error.code === "email_not_verified") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Email verification required. A verification email has been sent to ${(args as Record<string, unknown>).creatorEmail}. Ask the user to click the link in the email, then try creating the poll again.`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Could not connect to MeetLark API.`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}

package/src/tools/get-admin.ts

@@ -0,0 +1,64 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerGetAdmin(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_get_admin_view", {
+    description:
+      "Get full poll details and results using the admin token. " +
+      "Includes all participant data, vote counts, and poll " +
+      "management info. Use the admin token from poll creation.",
+    inputSchema: {
+      adminToken: z
+        .string()
+        .describe("The adm_xxx token from poll creation"),
+    },
+  }, async (args) => {
+    const result = await client.getAdminView(args.adminToken);
+
+    if (result.error) {
+      if (result.error.code === "poll_not_found") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Poll not found. The admin token may be invalid.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Could not connect to MeetLark API.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}

package/src/tools/get-results.ts

@@ -0,0 +1,64 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerGetResults(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_get_results", {
+    description:
+      "View current poll results including all votes cast so far. " +
+      "Shows the poll details and time slots. Use the participation " +
+      "token from the poll's participate URL.",
+    inputSchema: {
+      participateToken: z
+        .string()
+        .describe("The prt_xxx token from the participation URL"),
+    },
+  }, async (args) => {
+    const result = await client.getResults(args.participateToken);
+
+    if (result.error) {
+      if (result.error.code === "participate_token_not_found") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Token not found. The participation link may be invalid or expired.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Could not connect to MeetLark API.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}

package/src/tools/index.ts

@@ -0,0 +1,6 @@
+export { registerCreatePoll } from "./create-poll.js";
+export { registerGetResults } from "./get-results.js";
+export { registerVote } from "./vote.js";
+export { registerGetAdmin } from "./get-admin.js";
+export { registerClosePoll } from "./close-poll.js";
+export { registerReopenPoll } from "./reopen-poll.js";

package/src/tools/reopen-poll.ts

@@ -0,0 +1,75 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerReopenPoll(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_reopen_poll", {
+    description:
+      "Reopen a previously closed poll to accept votes again. " +
+      "Use the admin token from poll creation.",
+    inputSchema: {
+      adminToken: z
+        .string()
+        .describe("The adm_xxx token from poll creation"),
+    },
+  }, async (args) => {
+    const result = await client.reopenPoll(args.adminToken);
+
+    if (result.error) {
+      if (result.error.code === "poll_not_found") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Poll not found. The admin token may be invalid.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "poll_already_open") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "This poll is already open.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Could not connect to MeetLark API.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}

package/src/tools/vote.ts

@@ -0,0 +1,88 @@
+import { z } from "zod/v4";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MeetLarkClient } from "../client.js";
+
+export function registerVote(server: McpServer, client: MeetLarkClient) {
+  server.registerTool("meetlark_vote", {
+    description:
+      "Cast a vote on a scheduling poll. Each time slot can be " +
+      "voted yes, maybe, or no. Use the participation token from " +
+      "the poll's participate URL.",
+    inputSchema: {
+      participateToken: z
+        .string()
+        .describe("The prt_xxx token from the participation URL"),
+      name: z.string().describe("Name to display in results"),
+      votes: z
+        .array(
+          z.object({
+            timeSlotId: z.string().describe("Time slot ID"),
+            value: z.enum(["yes", "maybe", "no"]).describe("Vote value"),
+          }),
+        )
+        .describe("Votes for each time slot"),
+    },
+  }, async (args) => {
+    const result = await client.vote(args.participateToken, {
+      name: args.name,
+      votes: args.votes,
+    });
+
+    if (result.error) {
+      if (result.error.code === "participate_token_not_found") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Token not found. The participation link may be invalid or expired.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "poll_closed") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "This poll is already closed.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (result.error.code === "network_error") {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Could not connect to MeetLark API.",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: result.error.message,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(result.data),
+        },
+      ],
+    };
+  });
+}