@vineethnkrishnan/vercel-mcp 0.1.1

package/build/common/types.d.ts

@@ -0,0 +1,11 @@
+export interface VercelConfig {
+    token: string;
+    teamId?: string;
+}
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}

package/build/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":""}

package/build/common/utils.d.ts

@@ -0,0 +1,27 @@
+import { McpToolResponse } from "./types";
+/**
+ * Recursively removes specified keys from an object.
+ */
+export declare function stripVercelMetadata(obj: unknown, keys?: string[]): unknown;
+/**
+ * Strips ANSI escape codes from a string.
+ */
+export declare function stripAnsiCodes(text: string): string;
+/**
+ * Truncates build log lines to the last MAX_BUILD_LOG_LINES lines.
+ * Returns the truncated string with a marker if truncation occurred.
+ */
+export declare function truncateBuildLogs(lines: string[], maxLines?: number): string;
+/**
+ * Composes all Vercel-specific transformations for LLM optimization.
+ * Strips internal metadata keys from the response data.
+ */
+export declare function transformVercelResponse(data: unknown): unknown;
+/**
+ * Transforms Vercel data and wraps it in the MCP tool response format.
+ */
+export declare function formatMcpResponse(data: unknown): McpToolResponse;
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+export declare function formatMcpError(error: unknown): McpToolResponse;

package/build/common/utils.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripVercelMetadata = stripVercelMetadata;
+exports.stripAnsiCodes = stripAnsiCodes;
+exports.truncateBuildLogs = truncateBuildLogs;
+exports.transformVercelResponse = transformVercelResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.formatMcpError = formatMcpError;
+const VERCEL_STRIP_KEYS = [
+    "ownerId",
+    "accountId",
+    "plan",
+    "analytics",
+    "speedInsights",
+    "autoExposeSystemEnvs",
+    "directoryListing",
+    "skewProtection",
+];
+const MAX_BUILD_LOG_LINES = 150;
+/**
+ * Recursively removes specified keys from an object.
+ */
+function stripVercelMetadata(obj, keys = VERCEL_STRIP_KEYS) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => stripVercelMetadata(item, keys));
+    if (typeof obj !== "object")
+        return obj;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key))
+            continue;
+        result[key] = stripVercelMetadata(value, keys);
+    }
+    return result;
+}
+/**
+ * Strips ANSI escape codes from a string.
+ */
+function stripAnsiCodes(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+}
+/**
+ * Truncates build log lines to the last MAX_BUILD_LOG_LINES lines.
+ * Returns the truncated string with a marker if truncation occurred.
+ */
+function truncateBuildLogs(lines, maxLines = MAX_BUILD_LOG_LINES) {
+    if (lines.length <= maxLines) {
+        return lines.join("\n");
+    }
+    const totalLines = lines.length;
+    const truncatedLines = lines.slice(-maxLines);
+    const marker = `[truncated — showing last ${maxLines} of ${totalLines} lines]`;
+    return [marker, ...truncatedLines].join("\n");
+}
+/**
+ * Composes all Vercel-specific transformations for LLM optimization.
+ * Strips internal metadata keys from the response data.
+ */
+function transformVercelResponse(data) {
+    return stripVercelMetadata(data);
+}
+/**
+ * Transforms Vercel data and wraps it in the MCP tool response format.
+ */
+function formatMcpResponse(data) {
+    const transformed = transformVercelResponse(data);
+    return {
+        content: [{ type: "text", text: JSON.stringify(transformed, null, 2) }],
+    };
+}
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+function formatMcpError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":";;AAkBA,kDAWC;AAKD,wCAGC;AAMD,8CASC;AAMD,0DAEC;AAKD,8CAKC;AAKD,wCAMC;AA/ED,MAAM,iBAAiB,GAAG;IACxB,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,eAAe;IACf,sBAAsB;IACtB,kBAAkB;IAClB,gBAAgB;CACjB,CAAC;AAEF,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;GAEG;AACH,SAAgB,mBAAmB,CAAC,GAAY,EAAE,OAAiB,iBAAiB;IAClF,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAClF,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,4CAA4C;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAe,EAAE,WAAmB,mBAAmB;IACvF,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,6BAA6B,QAAQ,OAAO,UAAU,SAAS,CAAC;IAC/E,OAAO,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,IAAa;IACnD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,IAAa;IAC7C,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const vercel_service_1 = require("./services/vercel.service");
+const project_tools_1 = require("./tools/project.tools");
+const deployment_tools_1 = require("./tools/deployment.tools");
+// Validate required config
+const VERCEL_TOKEN = process.env.VERCEL_TOKEN;
+if (!VERCEL_TOKEN) {
+    console.error("VERCEL_TOKEN environment variable is required.");
+    process.exit(1);
+}
+const vercelService = new vercel_service_1.VercelService({
+    token: VERCEL_TOKEN,
+    teamId: process.env.VERCEL_TEAM_ID,
+});
+// Initialize tool classes
+const tools = {
+    projects: new project_tools_1.ProjectTools(vercelService),
+    deployments: new deployment_tools_1.DeploymentTools(vercelService),
+};
+// Combine all schemas
+const AllToolSchemas = {
+    ...project_tools_1.ProjectToolSchemas,
+    ...deployment_tools_1.DeploymentToolSchemas,
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const server = new index_js_1.Server({
+    name: "vercel-mcp",
+    version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools.
+ */
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: Object.entries(AllToolSchemas).map(([name, config]) => ({
+            name,
+            description: config.description,
+            inputSchema: zod_1.z.toJSONSchema(config.schema),
+        })),
+    };
+});
+const toolRegistry = {};
+for (const name of Object.keys(project_tools_1.ProjectToolSchemas)) {
+    toolRegistry[name] = (args) => tools.projects[name](args);
+}
+for (const name of Object.keys(deployment_tools_1.DeploymentToolSchemas)) {
+    toolRegistry[name] = (args) => tools.deployments[name](args);
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        const handler = toolRegistry[name];
+        if (!handler) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Tool not found: ${name}`);
+        }
+        return await handler(args ?? {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server using Stdio transport.
+ */
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Vercel MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/services/vercel.service.d.ts

@@ -0,0 +1,14 @@
+import { VercelConfig } from "../common/types";
+export declare class VercelService {
+    private baseUrl;
+    private token;
+    private teamId?;
+    constructor(config: VercelConfig);
+    private buildUrl;
+    private request;
+    listProjects(limit?: number): Promise<unknown>;
+    getProject(projectId: string): Promise<unknown>;
+    listDeployments(projectId?: string, limit?: number): Promise<unknown>;
+    getDeployment(deploymentId: string): Promise<unknown>;
+    getDeploymentBuildLogs(deploymentId: string): Promise<unknown>;
+}

package/build/services/vercel.service.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VercelService = void 0;
+class VercelService {
+    baseUrl = "https://api.vercel.com";
+    token;
+    teamId;
+    constructor(config) {
+        this.token = config.token;
+        this.teamId = config.teamId;
+    }
+    buildUrl(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (this.teamId) {
+            url.searchParams.set("teamId", this.teamId);
+        }
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null && value !== "") {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    async request(path, params) {
+        const url = this.buildUrl(path, params);
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            switch (response.status) {
+                case 401:
+                    throw new Error("Authentication failed. Check your VERCEL_TOKEN.");
+                case 403:
+                    throw new Error("Access denied. Token may lack required scopes, or you may not have access to this team.");
+                case 404:
+                    throw new Error("Not found. Check the ID and ensure you have access.");
+                case 429: {
+                    const retryAfter = response.headers.get("Retry-After") ?? "unknown";
+                    throw new Error(`Rate limited by Vercel. Retry after ${retryAfter} seconds.`);
+                }
+                default:
+                    throw new Error(`Vercel API error (${response.status}): ${errorBody || response.statusText}`);
+            }
+        }
+        return response.json();
+    }
+    // ===========================================================================
+    // Projects
+    // ===========================================================================
+    async listProjects(limit = 20) {
+        return this.request("/v9/projects", { limit });
+    }
+    async getProject(projectId) {
+        return this.request(`/v9/projects/${projectId}`);
+    }
+    // ===========================================================================
+    // Deployments
+    // ===========================================================================
+    async listDeployments(projectId, limit = 20) {
+        const params = { limit };
+        if (projectId) {
+            params.projectId = projectId;
+        }
+        return this.request("/v6/deployments", params);
+    }
+    async getDeployment(deploymentId) {
+        return this.request(`/v13/deployments/${deploymentId}`);
+    }
+    async getDeploymentBuildLogs(deploymentId) {
+        return this.request(`/v2/deployments/${deploymentId}/events`);
+    }
+}
+exports.VercelService = VercelService;
+//# sourceMappingURL=vercel.service.js.map

package/build/services/vercel.service.js.map

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

package/build/tools/deployment.tools.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { VercelService } from "../services/vercel.service";
+import { McpToolResponse } from "../common/types";
+export declare const DeploymentToolSchemas: {
+    list_deployments: {
+        description: string;
+        schema: z.ZodObject<{
+            project_id: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+    get_deployment: {
+        description: string;
+        schema: z.ZodObject<{
+            deployment_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+    get_deployment_build_logs: {
+        description: string;
+        schema: z.ZodObject<{
+            deployment_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+};
+export declare class DeploymentTools {
+    private vercelService;
+    constructor(vercelService: VercelService);
+    list_deployments(args: z.infer<typeof DeploymentToolSchemas.list_deployments.schema>): Promise<McpToolResponse>;
+    get_deployment(args: z.infer<typeof DeploymentToolSchemas.get_deployment.schema>): Promise<McpToolResponse>;
+    get_deployment_build_logs(args: z.infer<typeof DeploymentToolSchemas.get_deployment_build_logs.schema>): Promise<McpToolResponse>;
+}

package/build/tools/deployment.tools.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentTools = exports.DeploymentToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+const utils_2 = require("../common/utils");
+exports.DeploymentToolSchemas = {
+    list_deployments: {
+        description: "Lists Vercel deployments. Optionally filter by project. Returns deployment status, URL, git commit info, and timestamps. Set VERCEL_TEAM_ID for team-scoped results.",
+        schema: zod_1.z.object({
+            project_id: zod_1.z.string().optional().describe("Filter deployments by project ID or name."),
+            limit: zod_1.z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Maximum number of deployments to return (default 20, max 100)."),
+        }),
+    },
+    get_deployment: {
+        description: "Retrieves full details for a specific deployment including status, URL, git commit info, build timings, and error messages.",
+        schema: zod_1.z.object({
+            deployment_id: zod_1.z.string().describe("The deployment ID (e.g., 'dpl_abc123') or URL."),
+        }),
+    },
+    get_deployment_build_logs: {
+        description: "Retrieves build output logs for a deployment. Logs are cleaned (ANSI codes stripped) and truncated to the last 150 lines for LLM consumption. Errors typically appear at the end.",
+        schema: zod_1.z.object({
+            deployment_id: zod_1.z
+                .string()
+                .describe("The deployment ID (e.g., 'dpl_abc123') to fetch build logs for."),
+        }),
+    },
+};
+class DeploymentTools {
+    vercelService;
+    constructor(vercelService) {
+        this.vercelService = vercelService;
+    }
+    async list_deployments(args) {
+        const deployments = await this.vercelService.listDeployments(args.project_id, args.limit);
+        return (0, utils_1.formatMcpResponse)(deployments);
+    }
+    async get_deployment(args) {
+        const deployment = await this.vercelService.getDeployment(args.deployment_id);
+        return (0, utils_1.formatMcpResponse)(deployment);
+    }
+    async get_deployment_build_logs(args) {
+        const events = (await this.vercelService.getDeploymentBuildLogs(args.deployment_id));
+        // Extract text from build events, strip ANSI codes, and truncate
+        const logLines = events
+            .filter((event) => event.text || event.payload?.text)
+            .map((event) => {
+            const text = event.text ?? event.payload?.text ?? "";
+            return (0, utils_2.stripAnsiCodes)(text);
+        })
+            .filter((line) => line.trim() !== "");
+        const processedLogs = (0, utils_2.truncateBuildLogs)(logLines);
+        return {
+            content: [{ type: "text", text: processedLogs }],
+        };
+    }
+}
+exports.DeploymentTools = DeploymentTools;
+//# sourceMappingURL=deployment.tools.js.map

package/build/tools/deployment.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.tools.js","sourceRoot":"","sources":["../../src/tools/deployment.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AACpD,2CAAoE;AAGvD,QAAA,qBAAqB,GAAG;IACnC,gBAAgB,EAAE;QAChB,WAAW,EACT,sKAAsK;QACxK,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACvF,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;SAC9E,CAAC;KACH;IACD,cAAc,EAAE;QACd,WAAW,EACT,6HAA6H;QAC/H,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;SACrF,CAAC;KACH;IACD,yBAAyB,EAAE;QACzB,WAAW,EACT,mLAAmL;QACrL,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,aAAa,EAAE,OAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;SAC/E,CAAC;KACH;CACF,CAAC;AAEF,MAAa,eAAe;IACN;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,gBAAgB,CAAC,IAAmE;QACxF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1F,OAAO,IAAA,yBAAiB,EAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAiE;QACpF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9E,OAAO,IAAA,yBAAiB,EAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,IAA4E;QAE5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,CAIjF,CAAC;QAEH,iEAAiE;QACjE,MAAM,QAAQ,GAAG,MAAM;aACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;aACpD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;YACrD,OAAO,IAAA,sBAAc,EAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAExC,MAAM,aAAa,GAAG,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;CACF;AArCD,0CAqCC"}

package/build/tools/project.tools.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { VercelService } from "../services/vercel.service";
+export declare const ProjectToolSchemas: {
+    list_projects: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+    get_project: {
+        description: string;
+        schema: z.ZodObject<{
+            project_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+};
+export declare class ProjectTools {
+    private vercelService;
+    constructor(vercelService: VercelService);
+    list_projects(args: z.infer<typeof ProjectToolSchemas.list_projects.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_project(args: z.infer<typeof ProjectToolSchemas.get_project.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/project.tools.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectTools = exports.ProjectToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.ProjectToolSchemas = {
+    list_projects: {
+        description: "Lists all Vercel projects. Returns project names, frameworks, and latest deployment info. Set VERCEL_TEAM_ID for team-scoped results.",
+        schema: zod_1.z.object({
+            limit: zod_1.z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Maximum number of projects to return (default 20, max 100)."),
+        }),
+    },
+    get_project: {
+        description: "Retrieves full details for a specific Vercel project including framework, build settings, git repository link, and latest deployment info.",
+        schema: zod_1.z.object({
+            project_id: zod_1.z.string().describe("The project ID or name (e.g., 'prj_abc123' or 'my-app')."),
+        }),
+    },
+};
+class ProjectTools {
+    vercelService;
+    constructor(vercelService) {
+        this.vercelService = vercelService;
+    }
+    async list_projects(args) {
+        const projects = await this.vercelService.listProjects(args.limit);
+        return (0, utils_1.formatMcpResponse)(projects);
+    }
+    async get_project(args) {
+        const project = await this.vercelService.getProject(args.project_id);
+        return (0, utils_1.formatMcpResponse)(project);
+    }
+}
+exports.ProjectTools = ProjectTools;
+//# sourceMappingURL=project.tools.js.map

package/build/tools/project.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.tools.js","sourceRoot":"","sources":["../../src/tools/project.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,WAAW,EACT,uIAAuI;QACzI,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;SAC3E,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EACT,4IAA4I;QAC9I,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;SAC5F,CAAC;KACH;CACF,CAAC;AAEF,MAAa,YAAY;IACH;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,aAAa,CAAC,IAA6D;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA2D;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,OAAO,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AAZD,oCAYC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@vineethnkrishnan/vercel-mcp",
+  "version": "0.1.1",
+  "description": "A read-only MCP server for Vercel API, enabling AI assistants to query deployments, projects, and build logs. Supports team-scoped access.",
+  "main": "build/index.js",
+  "bin": {
+    "vercel-mcp": "build/index.js"
+  },
+  "files": [
+    "build/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "test": "jest --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "vercel",
+    "ai",
+    "model-context-protocol",
+    "deployments",
+    "build-logs",
+    "team-scoped"
+  ],
+  "author": "Vineeth Krishnan",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  }
+}