jules-mcp 1.0.1

package/README.md

@@ -0,0 +1,71 @@
+# Jules MCP Server
+
+An MCP server implementation for [Jules API](https://developers.google.com/jules/api), allowing LLMs to interact directly with your automated Jules workflows.
+
+## Prerequisites
+
+1.  **Jules API Key**: Get your API Key from the Jules [Settings page](https://jules.google.com/settings#api).
+    *   *Note: Currently, Jules is migrating its authentication methods. If you receive a `401 Unauthorized` indicating "API keys are not supported by this API," you may need to wait for further updates from the Jules platform or supply an OAuth2 Token in place of the API key if supported.*
+
+## Installation & Usage
+
+You can use the server directly via `npx` without installing it globally:
+
+```bash
+npx jules-mcp
+```
+
+### Environment Variables
+
+The server requires the following environment variables:
+
+-   `JULES_API_KEY`: Your Jules API Key or Authentication Token.
+
+## Configuration for Claude Desktop
+
+To use this server with the Claude Desktop app, you need to add it to your configuration file.
+
+**Config file locations:**
+-   **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+-   **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the following to your configuration, replacing `<YOUR_API_KEY>` with your actual Jules API key:
+
+```json
+{
+  "mcpServers": {
+    "jules": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "jules-mcp"
+      ],
+      "env": {
+        "JULES_API_KEY": "<YOUR_API_KEY>"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+The server implements the following tools:
+
+-   `jules_list_sources`: Find the IDs of sources (e.g., connected GitHub repos) you can interact with.
+-   `jules_create_session`: Start a new Jules coding session with a specific prompt and source context.
+-   `jules_list_sessions`: Check the status and output links (e.g., Pull Requests) of your sessions.
+-   `jules_approve_plan`: Approve a session's execution plan (if it was created with `requirePlanApproval=true`).
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run via MCP Inspector for testing
+npm run inspector
+```

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const API_BASE_URL = "https://jules.googleapis.com";
+export declare const CHARACTER_LIMIT = 25000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAQ,CAAC"}

package/dist/constants.js

@@ -0,0 +1,3 @@
+export const API_BASE_URL = "https://jules.googleapis.com";
+export const CHARACTER_LIMIT = 25000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerListSourcesTool } from "./tools/listSources.js";
+import { registerCreateSessionTool } from "./tools/createSession.js";
+import { registerListSessionsTool } from "./tools/listSessions.js";
+import { registerApprovePlanTool } from "./tools/approvePlan.js";
+const server = new McpServer({
+    name: "jules-mcp-server",
+    version: "1.0.0",
+});
+// Register all tools
+registerListSourcesTool(server);
+registerCreateSessionTool(server);
+registerListSessionsTool(server);
+registerApprovePlanTool(server);
+async function runStdio() {
+    if (!process.env.JULES_API_KEY) {
+        console.error("ERROR: JULES_API_KEY environment variable is required to authenticate with the Jules API.");
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Jules MCP server running via stdio");
+}
+runStdio().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IACzB,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,qBAAqB;AACrB,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEhC,KAAK,UAAU,QAAQ;IACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;QAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/schemas/julesSchemas.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare enum ResponseFormat {
+    MARKDOWN = "markdown",
+    JSON = "json"
+}
+export declare const PaginationSchema: z.ZodObject<{
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    response_format: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strip>;
+export declare const ListSourcesInputSchema: z.ZodObject<{
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    response_format: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strip>;
+export type ListSourcesInput = z.infer<typeof ListSourcesInputSchema>;
+export declare const CreateSessionInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    source: z.ZodString;
+    startingBranch: z.ZodDefault<z.ZodString>;
+    automationMode: z.ZodDefault<z.ZodEnum<{
+        AUTO_CREATE_PR: "AUTO_CREATE_PR";
+        NONE: "NONE";
+    }>>;
+    title: z.ZodString;
+    requirePlanApproval: z.ZodDefault<z.ZodBoolean>;
+    response_format: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strip>;
+export type CreateSessionInput = z.infer<typeof CreateSessionInputSchema>;
+export declare const ListSessionsInputSchema: z.ZodObject<{
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    response_format: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strip>;
+export type ListSessionsInput = z.infer<typeof ListSessionsInputSchema>;
+export declare const ApprovePlanInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    response_format: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strip>;
+export type ApprovePlanInput = z.infer<typeof ApprovePlanInputSchema>;
+//# sourceMappingURL=julesSchemas.d.ts.map

package/dist/schemas/julesSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"julesSchemas.d.ts","sourceRoot":"","sources":["../../src/schemas/julesSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,oBAAY,cAAc;IACtB,QAAQ,aAAa;IACrB,IAAI,SAAS;CAChB;AAGD,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;iBAAmB,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAQnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,uBAAuB;;;;iBAAmB,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/julesSchemas.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+// --- Enums ---
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+// --- Common ---
+export const PaginationSchema = z.object({
+    pageSize: z.number().int().min(1).max(100).default(20).describe("Maximum results to return"),
+    pageToken: z.string().optional().describe("Page token for retrieving the next page"),
+    response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN).describe("Output format: 'markdown' or 'json'"),
+});
+// --- jules_list_sources ---
+export const ListSourcesInputSchema = PaginationSchema;
+// --- jules_create_session ---
+export const CreateSessionInputSchema = z.object({
+    prompt: z.string().describe("The user's goal or prompt for the session."),
+    source: z.string().describe("The name of the source resource (e.g., 'sources/github/owner/repo')."),
+    startingBranch: z.string().default("main").describe("The starting branch for the repository."),
+    automationMode: z.enum(["AUTO_CREATE_PR", "NONE"]).default("NONE").describe("Whether to automatically create a PR ('AUTO_CREATE_PR' or 'NONE')."),
+    title: z.string().describe("The title of the session."),
+    requirePlanApproval: z.boolean().default(false).describe("If true, requires an explicit call to approve_plan to proceed."),
+    response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN).describe("Output format: 'markdown' or 'json'"),
+});
+// --- jules_list_sessions ---
+export const ListSessionsInputSchema = PaginationSchema;
+// --- jules_approve_plan ---
+export const ApprovePlanInputSchema = z.object({
+    sessionId: z.string().describe("The session ID or resource name (e.g., 'sessions/12345')."),
+    response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN).describe("Output format: 'markdown' or 'json'"),
+});
+//# sourceMappingURL=julesSchemas.js.map

package/dist/schemas/julesSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"julesSchemas.js","sourceRoot":"","sources":["../../src/schemas/julesSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gBAAgB;AAChB,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACjB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,iBAAiB;AACjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACpF,eAAe,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACjI,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAGvD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IACnG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC9F,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACjJ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACvD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC1H,eAAe,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACjI,CAAC,CAAC;AAGH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAGxD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC3F,eAAe,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACjI,CAAC,CAAC"}

package/dist/services/julesApiClient.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Make an authenticated request to the Jules API.
+ */
+export declare function julesApiRequest<T>(endpoint: string, method?: "GET" | "POST" | "PUT" | "DELETE", data?: any, params?: any): Promise<T>;
+/**
+ * Helper to extract an actionable error message.
+ */
+export declare function handleApiError(error: unknown): string;
+//# sourceMappingURL=julesApiClient.d.ts.map

package/dist/services/julesApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"julesApiClient.d.ts","sourceRoot":"","sources":["../../src/services/julesApiClient.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAgB,EACjD,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4BrD"}

package/dist/services/julesApiClient.js

@@ -0,0 +1,63 @@
+import axios, { AxiosError } from "axios";
+import { API_BASE_URL } from "../constants.js";
+/**
+ * Make an authenticated request to the Jules API.
+ */
+export async function julesApiRequest(endpoint, method = "GET", data, params) {
+    const apiKey = process.env.JULES_API_KEY;
+    if (!apiKey) {
+        throw new Error("JULES_API_KEY environment variable is missing.");
+    }
+    try {
+        const response = await axios({
+            method,
+            url: `${API_BASE_URL}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`,
+            data,
+            params,
+            timeout: 30000,
+            headers: {
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+                "X-Goog-Api-Key": apiKey,
+            },
+        });
+        return response.data;
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Helper to extract an actionable error message.
+ */
+export function handleApiError(error) {
+    if (error instanceof Error && error.message.includes("JULES_API_KEY")) {
+        return error.message;
+    }
+    if (error instanceof AxiosError) {
+        if (error.response) {
+            const status = error.response.status;
+            const data = error.response.data;
+            const detail = data?.error?.message || JSON.stringify(data) || "No additional error info from server.";
+            switch (status) {
+                case 400:
+                    return `Error: Bad Request (400). Check the parameters. Detail: ${detail}`;
+                case 401:
+                    return `Error: Unauthorized (401). Ensure JULES_API_KEY is correct. Detail: ${detail}`;
+                case 403:
+                    return `Error: Forbidden (403). You don't have access to this resource. Detail: ${detail}`;
+                case 404:
+                    return `Error: Not Found (404). The requested resource doesn't exist. Detail: ${detail}`;
+                case 429:
+                    return `Error: Rate limit exceeded (429). Please wait before making more requests. Detail: ${detail}`;
+                default:
+                    return `Error: API request failed with status ${status}. Detail: ${detail}`;
+            }
+        }
+        else if (error.code === "ECONNABORTED") {
+            return "Error: Request timed out. Please try again.";
+        }
+    }
+    return `Error: Unexpected error occurred: ${error instanceof Error ? error.message : String(error)}`;
+}
+//# sourceMappingURL=julesApiClient.js.map

package/dist/services/julesApiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"julesApiClient.js","sourceRoot":"","sources":["../../src/services/julesApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,QAAgB,EAChB,SAA4C,KAAK,EACjD,IAAU,EACV,MAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;YACzB,MAAM;YACN,GAAG,EAAE,GAAG,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE;YAC7E,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,QAAQ,EAAE,kBAAkB;gBAC5B,gBAAgB,EAAE,MAAM;aAC3B;SACJ,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,uCAAuC,CAAC;YACvG,QAAQ,MAAM,EAAE,CAAC;gBACb,KAAK,GAAG;oBACJ,OAAO,2DAA2D,MAAM,EAAE,CAAC;gBAC/E,KAAK,GAAG;oBACJ,OAAO,uEAAuE,MAAM,EAAE,CAAC;gBAC3F,KAAK,GAAG;oBACJ,OAAO,2EAA2E,MAAM,EAAE,CAAC;gBAC/F,KAAK,GAAG;oBACJ,OAAO,yEAAyE,MAAM,EAAE,CAAC;gBAC7F,KAAK,GAAG;oBACJ,OAAO,sFAAsF,MAAM,EAAE,CAAC;gBAC1G;oBACI,OAAO,yCAAyC,MAAM,aAAa,MAAM,EAAE,CAAC;YACpF,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvC,OAAO,6CAA6C,CAAC;QACzD,CAAC;IACL,CAAC;IACD,OAAO,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACzG,CAAC"}

package/dist/tools/approvePlan.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the jules_approve_plan tool with the given MCP server.
+ */
+export declare function registerApprovePlanTool(server: McpServer): void;
+//# sourceMappingURL=approvePlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvePlan.d.ts","sourceRoot":"","sources":["../../src/tools/approvePlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAkDxD"}

package/dist/tools/approvePlan.js

@@ -0,0 +1,52 @@
+import { handleApiError, julesApiRequest } from "../services/julesApiClient.js";
+import { ApprovePlanInputSchema, ResponseFormat } from "../schemas/julesSchemas.js";
+/**
+ * Registers the jules_approve_plan tool with the given MCP server.
+ */
+export function registerApprovePlanTool(server) {
+    server.registerTool("jules_approve_plan", {
+        title: "Approve Jules Session Plan",
+        description: `Approve the plan for a session that requires explicit approval.
+
+If you created a session with requirePlanApproval: true, Jules will pause and wait for approval. Call this tool to allow it to proceed.
+
+Args:
+  - sessionId (string): The session ID or name (e.g., "sessions/12345" or "12345").
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown').
+
+Returns:
+  Status of the approval.`,
+        inputSchema: ApprovePlanInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true, // Approving a plan kicks off mutations in the source repo
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const endpoint = params.sessionId.includes("/")
+                ? `/${params.sessionId}:approvePlan`
+                : `/v1alpha/sessions/${params.sessionId}:approvePlan`;
+            const data = await julesApiRequest(endpoint, "POST", {});
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                textContent = `# Plan Approved\n\nSuccessfully approved plan for session \`${params.sessionId}\`.\n\nYou can use \`jules_list_sessions\` to monitor its progress.`;
+            }
+            else {
+                textContent = JSON.stringify({ success: true, session: params.sessionId, data }, null, 2);
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: { success: true, session: params.sessionId, data },
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=approvePlan.js.map

package/dist/tools/approvePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvePlan.js","sourceRoot":"","sources":["../../src/tools/approvePlan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAoB,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGtG;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE;;;;;;;;;0BASC;QACd,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACT,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI,EAAE,0DAA0D;YACjF,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACvB;KACJ,EACD,KAAK,EAAE,MAAwB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC3C,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,cAAc;gBACpC,CAAC,CAAC,qBAAqB,MAAM,CAAC,SAAS,cAAc,CAAC;YAE1D,MAAM,IAAI,GAAG,MAAM,eAAe,CAAM,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAE9D,IAAI,WAAmB,CAAC;YACxB,IAAI,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,QAAQ,EAAE,CAAC;gBACrD,WAAW,GAAG,+DAA+D,MAAM,CAAC,SAAS,qEAAqE,CAAC;YACvK,CAAC;iBAAM,CAAC;gBACJ,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9F,CAAC;YAED,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9C,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE;aACxE,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/createSession.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the jules_create_session tool with the given MCP server.
+ */
+export declare function registerCreateSessionTool(server: McpServer): void;
+//# sourceMappingURL=createSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createSession.d.ts","sourceRoot":"","sources":["../../src/tools/createSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QA8E1D"}

package/dist/tools/createSession.js

@@ -0,0 +1,80 @@
+import { handleApiError, julesApiRequest } from "../services/julesApiClient.js";
+import { CreateSessionInputSchema, ResponseFormat } from "../schemas/julesSchemas.js";
+import { CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Registers the jules_create_session tool with the given MCP server.
+ */
+export function registerCreateSessionTool(server) {
+    server.registerTool("jules_create_session", {
+        title: "Create Jules Session",
+        description: `Starts a new automated coding session with Jules.
+
+Use this after identifying a target source (e.g. from jules_list_sources). 
+This creates a session where Jules will work on the given prompt.
+
+Args:
+  - prompt (string): The user's goal or instructions.
+  - source (string): The full name of the source (e.g., "sources/github/owner/repo").
+  - startingBranch (string): The starting branch for the repository (default: "main").
+  - automationMode ("AUTO_CREATE_PR" | "NONE"): Whether to automatically create a PR (default: "NONE").
+  - title (string): The title of the session.
+  - requirePlanApproval (boolean): If true, implicitly requires an approve_plan call to proceed.
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown').
+
+Returns:
+  The created session details.`,
+        inputSchema: CreateSessionInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false, // Creating a session itself isn't completely destructive
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const payload = {
+                prompt: params.prompt,
+                sourceContext: {
+                    source: params.source,
+                    githubRepoContext: {
+                        startingBranch: params.startingBranch,
+                    },
+                },
+                automationMode: params.automationMode,
+                title: params.title,
+                requirePlanApproval: params.requirePlanApproval,
+            };
+            const data = await julesApiRequest("/v1alpha/sessions", "POST", payload);
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [
+                    `# Created Session: ${data.title || "Untitled"}`,
+                    "",
+                    `- **Name/ID**: ${data.name || data.id}`,
+                    `- **Prompt**: ${data.prompt}`,
+                    `- **Status**: ${data.state || "PENDING"}`,
+                    "",
+                    `You can check the progress of this session using the \`jules_list_sessions\` tool.`,
+                ];
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(data, null, 2);
+            }
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.slice(0, CHARACTER_LIMIT) + "\n...[truncated]";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: data,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=createSession.js.map

package/dist/tools/createSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSession.js","sourceRoot":"","sources":["../../src/tools/createSession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAsB,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACf,sBAAsB,EACtB;QACI,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE;;;;;;;;;;;;;;;+BAeM;QACnB,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE;YACT,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK,EAAE,yDAAyD;YACjF,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACvB;KACJ,EACD,KAAK,EAAE,MAA0B,EAAE,EAAE;QACjC,IAAI,CAAC;YACD,MAAM,OAAO,GAAG;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,aAAa,EAAE;oBACX,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,iBAAiB,EAAE;wBACf,cAAc,EAAE,MAAM,CAAC,cAAc;qBACxC;iBACJ;gBACD,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;aAClD,CAAC;YAEF,MAAM,IAAI,GAAG,MAAM,eAAe,CAAM,mBAAmB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAE9E,IAAI,WAAmB,CAAC;YACxB,IAAI,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,QAAQ,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAG;oBACV,sBAAsB,IAAI,CAAC,KAAK,IAAI,UAAU,EAAE;oBAChD,EAAE;oBACF,kBAAkB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE;oBACxC,iBAAiB,IAAI,CAAC,MAAM,EAAE;oBAC9B,iBAAiB,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE;oBAC1C,EAAE;oBACF,oFAAoF;iBACvF,CAAC;gBACF,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACJ,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;YAED,IAAI,WAAW,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;gBACvC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,kBAAkB,CAAC;YAC7E,CAAC;YAED,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9C,iBAAiB,EAAE,IAAI;aAC1B,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/listSessions.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the jules_list_sessions tool with the given MCP server.
+ */
+export declare function registerListSessionsTool(server: McpServer): void;
+//# sourceMappingURL=listSessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listSessions.d.ts","sourceRoot":"","sources":["../../src/tools/listSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QAgGzD"}

package/dist/tools/listSessions.js

@@ -0,0 +1,95 @@
+import { handleApiError, julesApiRequest } from "../services/julesApiClient.js";
+import { ListSessionsInputSchema, ResponseFormat } from "../schemas/julesSchemas.js";
+import { CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Registers the jules_list_sessions tool with the given MCP server.
+ */
+export function registerListSessionsTool(server) {
+    server.registerTool("jules_list_sessions", {
+        title: "List Jules Sessions",
+        description: `List your Jules sessions to check their status or view outputs (e.g. PR links).
+
+Use this to poll for the completion of a session or to find an active session ID.
+
+Args:
+  - pageSize (number): Maximum results to return (default: 20)
+  - pageToken (string): Page token for retrieving the next page
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  A list of sessions, including their state and any outputs.`,
+        inputSchema: ListSessionsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const queryParams = {
+                pageSize: params.pageSize,
+            };
+            if (params.pageToken) {
+                queryParams.pageToken = params.pageToken;
+            }
+            const data = await julesApiRequest("/v1alpha/sessions", "GET", undefined, queryParams);
+            const sessions = data?.sessions || [];
+            const nextPageToken = data?.nextPageToken;
+            if (!sessions.length) {
+                return {
+                    content: [{ type: "text", text: "No sessions found." }],
+                };
+            }
+            const output = {
+                sessions,
+                nextPageToken,
+            };
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [`# Jules Sessions`, ""];
+                for (const session of sessions) {
+                    lines.push(`## ${session.title || 'Untitled'} (${session.name || session.id})`);
+                    lines.push(`- **State**: ${session.state || "UNKNOWN"}`);
+                    lines.push(`- **Prompt**: ${session.prompt}`);
+                    if (session.outputs && session.outputs.length > 0) {
+                        lines.push(`- **Outputs**:`);
+                        for (const out of session.outputs) {
+                            if (out.pullRequest) {
+                                lines.push(`  - Pull Request: [${out.pullRequest.title}](${out.pullRequest.url})`);
+                            }
+                            else {
+                                lines.push(`  - ${JSON.stringify(out)}`);
+                            }
+                        }
+                    }
+                    if (session.pendingPlanApproval) {
+                        lines.push(`- ⚠️ **Requires Plan Approval**: Use \`jules_approve_plan\` to approve.`);
+                    }
+                    lines.push("");
+                }
+                if (nextPageToken) {
+                    lines.push(`**Next Page Token**: ${nextPageToken}`);
+                }
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(output, null, 2);
+            }
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.slice(0, CHARACTER_LIMIT) + "\n...[truncated]";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=listSessions.js.map

package/dist/tools/listSessions.js.map

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

package/dist/tools/listSources.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the jules_list_sources tool with the given MCP server.
+ */
+export declare function registerListSourcesTool(server: McpServer): void;
+//# sourceMappingURL=listSources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listSources.d.ts","sourceRoot":"","sources":["../../src/tools/listSources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAoFxD"}

package/dist/tools/listSources.js

@@ -0,0 +1,83 @@
+import { handleApiError, julesApiRequest } from "../services/julesApiClient.js";
+import { ListSourcesInputSchema, ResponseFormat } from "../schemas/julesSchemas.js";
+import { CHARACTER_LIMIT } from "../constants.js";
+/**
+ * Registers the jules_list_sources tool with the given MCP server.
+ */
+export function registerListSourcesTool(server) {
+    server.registerTool("jules_list_sources", {
+        title: "List Jules Sources",
+        description: `List your available sources connected to Jules (e.g., GitHub repositories).
+
+Use this to find the name of the source you want to work with before creating a session.
+
+Args:
+  - pageSize (number): Maximum results to return (default: 20)
+  - pageToken (string): Page token for retrieving the next page
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  A list of sources available to the user.`,
+        inputSchema: ListSourcesInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const queryParams = {
+                pageSize: params.pageSize,
+            };
+            if (params.pageToken) {
+                queryParams.pageToken = params.pageToken;
+            }
+            const data = await julesApiRequest("/v1alpha/sources", "GET", undefined, queryParams);
+            const sources = data?.sources || [];
+            const nextPageToken = data?.nextPageToken;
+            if (!sources.length) {
+                return {
+                    content: [{ type: "text", text: "No sources found." }],
+                };
+            }
+            const output = {
+                sources,
+                nextPageToken,
+            };
+            let textContent;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [`# Jules Sources`, ""];
+                for (const source of sources) {
+                    lines.push(`## ${source.name}`);
+                    lines.push(`- **ID**: ${source.id}`);
+                    if (source.githubRepo) {
+                        lines.push(`- **GitHub Repo**: ${source.githubRepo.owner}/${source.githubRepo.repo}`);
+                    }
+                    lines.push("");
+                }
+                if (nextPageToken) {
+                    lines.push(`**Next Page Token**: ${nextPageToken}`);
+                }
+                textContent = lines.join("\n");
+            }
+            else {
+                textContent = JSON.stringify(output, null, 2);
+            }
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.slice(0, CHARACTER_LIMIT) + "\n...[truncated]";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=listSources.js.map

package/dist/tools/listSources.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "jules-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for Jules API integration",
+  "type": "module",
+  "bin": {
+    "jules-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "axios": "^1.7.9",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}