vibekit-mcp 0.7.0 → 0.7.2

package/dist/index.js

@@ -10,6 +10,9 @@ const SKILLS_REGISTRY = "https://raw.githubusercontent.com/vibekit-apps/skills-r
 // Skills cache (TTL: 5 minutes)
 let skillsCache = null;
 const CACHE_TTL = 5 * 60 * 1000;
+// Max time vibekit_chat blocks before returning a "still working — poll" result,
+// so a long coding turn never outlasts the client timeout and triggers a retry.
+const CHAT_MAX_WAIT_MS = 110_000;
 // API helper
 async function apiRequest(method, path, body) {
     // The server boots and lists its tools without a key (so MCP introspection
@@ -49,9 +52,26 @@ const path_1 = require("path");
 const TOOLS_MANIFEST_PATH = (0, path_1.join)(__dirname, "..", "tools.json");
 const tools = JSON.parse((0, fs_1.readFileSync)(TOOLS_MANIFEST_PATH, "utf8")).map((t) => ({
     name: t.name,
+    title: t.title,
     description: t.description,
     inputSchema: t.inputSchema,
+    annotations: t.annotations,
 }));
+// Server-level guidance sent in the MCP `initialize` response. Tells the model
+// what VibeKit is and when to reach for these tools — the single strongest
+// signal (after tool descriptions) for tool selection. Keep in sync with the
+// same string in src/routes/mcp.ts (the remote HTTP server).
+const SERVER_INSTRUCTIONS = "VibeKit hosts, deploys, and operates web apps and AI coding agents. Each app runs in its own " +
+    "container at <subdomain>.vibekit.bot with optional Postgres, logs, env vars, and automated QA, " +
+    "plus a built-in AI agent that can edit the app's code.\n\n" +
+    "Use these tools whenever the user wants to: deploy a GitHub repo or starter template and get a " +
+    "live URL; list, inspect, restart/stop/start, or delete hosted apps; read logs to debug; manage " +
+    "env vars; enable and query an app's Postgres (call vibekit_db_schema before writing SQL); list " +
+    "or roll back deploys; run or check QA; chat with an app's AI agent to change its code; or " +
+    "submit/schedule autonomous coding tasks that commit to GitHub and deploy.\n\n" +
+    "Most tools key off an appId — call vibekit_list_apps first to resolve one. Confirm destructive " +
+    "actions (vibekit_delete_app, vibekit_delete_schedule, and write/DDL via vibekit_db_query) with " +
+    "the user before calling. Auth uses a VibeKit API key (vk_...) from the Telegram bot's /apikey command.";
 // Tool handlers
 async function handleTool(name, args) {
     let result;
@@ -113,11 +133,28 @@ async function handleTool(name, args) {
             result = await apiRequest("DELETE", `/hosting/app/${args.appId}`);
             break;
         // AI Agent
-        case "vibekit_chat":
-            result = await apiRequest("POST", `/hosting/app/${args.appId}/agent`, {
+        case "vibekit_chat": {
+            // The /agent endpoint runs the whole coding turn synchronously, which can
+            // outlast the MCP client's idle timeout → the client retries, producing a
+            // duplicate message and losing the reply. Disconnect doesn't abort the run
+            // server-side, so we race the call against a bounded wait and, on timeout,
+            // return a SUCCESS "still working — poll" result (never an error, so no
+            // retry/dupe). The loopback call is NOT aborted; the turn lands in history.
+            const callP = apiRequest("POST", `/hosting/app/${args.appId}/agent`, {
                 message: args.message,
             });
+            callP.catch(() => { });
+            const pollP = new Promise((resolve) => setTimeout(() => resolve({
+                ok: true,
+                data: {
+                    status: "working",
+                    appId: args.appId,
+                    note: "Your message was delivered and the agent is still working on it — coding turns can take a few minutes. Do NOT resend the same message. Poll vibekit_agent_status until it's idle, then vibekit_agent_history to read the agent's reply.",
+                },
+            }), CHAT_MAX_WAIT_MS));
+            result = await Promise.race([callP, pollP]);
             break;
+        }
         case "vibekit_agent_status":
             result = await apiRequest("GET", `/hosting/app/${args.appId}/agent/status`);
             break;
@@ -303,11 +340,13 @@ async function handleTool(name, args) {
 // Main server setup
 const server = new index_js_1.Server({
     name: "vibekit-mcp",
-    version: "0.7.0",
+    title: "VibeKit",
+    version: "0.7.2",
 }, {
     capabilities: {
         tools: {},
     },
+    instructions: SERVER_INSTRUCTIONS,
 });
 // Handle tool listing
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "vibekit-mcp",
-  "version": "0.7.0",
-  "mcpName": "io.github.609NFT/vibekit-mcp",
+  "version": "0.7.2",
   "description": "MCP server for VibeKit — deploy apps, manage hosting, chat with AI agents, and run coding tasks from Claude Desktop, Cursor, and other MCP clients.",
   "main": "dist/index.js",
   "bin": {
@@ -30,7 +29,8 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/609NFT/vibekit-mcp.git"
+    "url": "https://github.com/609NFT/vibekit.git",
+    "directory": "packages/mcp-server"
   },
   "homepage": "https://vibekit.bot",
   "dependencies": {

package/tools.json

@@ -2,428 +2,746 @@
   {
     "category": "Hosting & Apps",
     "name": "vibekit_list_apps",
-    "description": "List all hosted apps in your VibeKit account.",
-    "inputSchema": { "type": "object", "properties": {} }
+    "title": "VibeKit List Apps",
+    "description": "List all hosted apps in your VibeKit account, each with its id, subdomain, status, and live URL. Start here to get an appId for the other app tools.",
+    "annotations": { "title": "VibeKit List Apps", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_get_app",
-    "description": "Get details about a specific hosted app.",
+    "title": "VibeKit Get App",
+    "description": "Get full details for one hosted app — status, subdomain/URL, repo, runtime, and database/domain config. Use the appId from vibekit_list_apps.",
+    "annotations": { "title": "VibeKit Get App", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get details for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_create_app",
-    "description": "Create a new hosted app from a template.",
+    "title": "VibeKit Create App",
+    "description": "Create a new hosted app from a starter template and deploy it live at <subdomain>.vibekit.bot. Call vibekit_list_templates first to pick a valid template. To deploy existing code from a GitHub repo instead, use vibekit_deploy.",
+    "annotations": { "title": "VibeKit Create App", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "template": { "type": "string", "description": "Template to use (e.g., 'nextjs', 'react', 'express')" },
-        "subdomain": { "type": "string", "description": "Subdomain for the app (will be deployed to {subdomain}.vibekit.bot)" }
+        "template": {
+          "type": "string",
+          "description": "Template id from vibekit_list_templates (e.g. 'landing', 'dashboard', 'blog', 'saas', 'crud-api')"
+        },
+        "subdomain": {
+          "type": "string",
+          "description": "Desired subdomain — the app goes live at <subdomain>.vibekit.bot. Lowercase letters, numbers, and hyphens."
+        }
       },
-      "required": ["template", "subdomain"]
+      "required": [
+        "template",
+        "subdomain"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_list_templates",
-    "description": "List available templates for vibekit_create_app (e.g. landing, dashboard, blog, saas, crud-api).",
-    "inputSchema": { "type": "object", "properties": {} }
+    "title": "VibeKit List Templates",
+    "description": "List the starter templates available to vibekit_create_app (e.g. landing, dashboard, blog, saas, crud-api). Call this before vibekit_create_app to choose a valid template.",
+    "annotations": { "title": "VibeKit List Templates", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_deploy",
-    "description": "Deploy a GitHub repo to VibeKit hosting.",
+    "title": "VibeKit Deploy",
+    "description": "Deploy a GitHub repo to VibeKit hosting, live at <subdomain>.vibekit.bot (Fargate container behind nginx, SSL automatic). Use when the code already lives in a GitHub repo; for a starter template instead use vibekit_create_app.",
+    "annotations": { "title": "VibeKit Deploy", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "repo": { "type": "string", "description": "GitHub repo in format 'owner/repo'" },
-        "subdomain": { "type": "string", "description": "Subdomain for the app (will be deployed to {subdomain}.vibekit.bot)" }
+        "repo": {
+          "type": "string",
+          "description": "GitHub repo as 'owner/repo' (e.g. '609NFT/vibekit')"
+        },
+        "subdomain": {
+          "type": "string",
+          "description": "Desired subdomain — the app goes live at <subdomain>.vibekit.bot. Lowercase letters, numbers, and hyphens."
+        }
       },
-      "required": ["repo", "subdomain"]
+      "required": [
+        "repo",
+        "subdomain"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_redeploy",
-    "description": "Redeploy an existing hosted app to update it with latest code.",
+    "title": "VibeKit Redeploy",
+    "description": "Redeploy an existing app to pull and ship the latest code. Use after pushing changes to the app's GitHub repo.",
+    "annotations": { "title": "VibeKit Redeploy", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to redeploy" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_app_logs",
-    "description": "Get application logs for debugging and monitoring.",
+    "title": "VibeKit App Logs",
+    "description": "Fetch recent container/application logs for an app. Use this to debug crashes, errors, or a deploy that isn't serving.",
+    "annotations": { "title": "VibeKit App Logs", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get logs for" },
-        "lines": { "type": "number", "description": "Number of log lines to retrieve (default: 100)" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "lines": {
+          "type": "number",
+          "description": "Number of log lines to retrieve (default 100)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_restart_app",
-    "description": "Restart a hosted app.",
+    "title": "VibeKit Restart App",
+    "description": "Restart a hosted app's container. Use when an app is wedged, or to apply changed environment variables.",
+    "annotations": { "title": "VibeKit Restart App", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to restart" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_stop_app",
-    "description": "Stop a hosted app.",
+    "title": "VibeKit Stop App",
+    "description": "Stop a hosted app's container. The app stays in your account and can be brought back with vibekit_start_app. Use to take an app offline without deleting it.",
+    "annotations": { "title": "VibeKit Stop App", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to stop" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_start_app",
-    "description": "Start a stopped hosted app.",
+    "title": "VibeKit Start App",
+    "description": "Start a stopped hosted app's container. Use to bring an app stopped via vibekit_stop_app back online.",
+    "annotations": { "title": "VibeKit Start App", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to start" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_app_env",
-    "description": "Get environment variables for a hosted app.",
+    "title": "VibeKit Get Env Vars",
+    "description": "Get the environment variables configured for an app (names and values). Read-only — use vibekit_set_env to change them.",
+    "annotations": { "title": "VibeKit Get Env Vars", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get environment variables for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_set_env",
-    "description": "Set environment variables for a hosted app.",
+    "title": "VibeKit Set Env Vars",
+    "description": "Set or update environment variables for an app (merges with existing). The app must be restarted or redeployed for changes to take effect.",
+    "annotations": { "title": "VibeKit Set Env Vars", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to set environment variables for" },
-        "vars": { "type": "object", "description": "Object of key-value pairs to set as environment variables" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "vars": {
+          "type": "object",
+          "description": "Key-value pairs to set as environment variables, e.g. { \"API_KEY\": \"...\", \"NODE_ENV\": \"production\" }"
+        }
       },
-      "required": ["appId", "vars"]
+      "required": [
+        "appId",
+        "vars"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_delete_app",
-    "description": "Delete a hosted app permanently.",
+    "title": "VibeKit Delete App",
+    "description": "Permanently delete a hosted app — stops the container and removes its workspace, database, env vars, and subdomain. Irreversible (the GitHub repo is NOT touched). Confirm with the user before calling.",
+    "annotations": { "title": "VibeKit Delete App", "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to delete" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "AI Agent",
     "name": "vibekit_chat",
-    "description": "Chat with an app's AI agent. The agent can read, write, and modify the app's code.",
+    "title": "VibeKit Chat with Agent",
+    "description": "Send a message to an app's built-in AI coding agent, which reads, writes, and modifies the app's code and redeploys it. Use for 'build/make a change to my app' requests. If the agent finishes quickly you get its reply directly. Otherwise you get status:'working' — do NOT resend; instead give the user LIVE progress: poll vibekit_agent_status every few seconds and relay the current step from activity.status ('editing the homepage…', 'deploying…') until activity.done, then read vibekit_agent_history for the final reply.",
+    "annotations": { "title": "VibeKit Chat with Agent", "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to chat with the agent for" },
-        "message": { "type": "string", "description": "Message to send to the AI agent" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "message": {
+          "type": "string",
+          "description": "What you want the agent to do or change — be specific about features, design, and behavior."
+        }
       },
-      "required": ["appId", "message"]
+      "required": [
+        "appId",
+        "message"
+      ]
     }
   },
   {
     "category": "AI Agent",
     "name": "vibekit_agent_status",
-    "description": "Get the status of an app's AI agent.",
+    "title": "VibeKit Agent Status",
+    "description": "Check whether an app's AI agent is idle or working, and get its LIVE progress. Returns activity.status = the current human-readable build step (e.g. 'editing index.html', 'deploying'), activity.steps = the steps so far, and activity.done = whether the turn finished. Poll this every few seconds while a build is running and relay activity.status to the user so they see progress. Once activity.done is true the response also includes liveCheck = a server-side fetch of the deployed page ({ url, ok, httpStatus, title }); use it to confirm the app is live and renders — do NOT curl/fetch the URL yourself, your sandbox may block it.",
+    "annotations": { "title": "VibeKit Agent Status", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get agent status for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "AI Agent",
     "name": "vibekit_agent_history",
-    "description": "Get chat history with an app's AI agent.",
+    "title": "VibeKit Agent History",
+    "description": "Get the recent chat history between the user and an app's AI agent.",
+    "annotations": { "title": "VibeKit Agent History", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get agent history for" },
-        "limit": { "type": "number", "description": "Maximum number of messages to return (default: 20)" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum number of messages to return (default 20)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Database",
     "name": "vibekit_enable_database",
-    "description": "Enable database for a hosted app.",
+    "title": "VibeKit Enable Database",
+    "description": "Provision a Postgres database for an app (idempotent — safe if already enabled). Required before the vibekit_db_* tools work. Note: free-tier apps need the $3/mo Database add-on.",
+    "annotations": { "title": "VibeKit Enable Database", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to enable database for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Database",
     "name": "vibekit_database_status",
-    "description": "Get database status and connection info for an app.",
+    "title": "VibeKit Database Status",
+    "description": "Get an app's database status and connection info (whether it's provisioned, frozen, etc.).",
+    "annotations": { "title": "VibeKit Database Status", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get database status for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Database",
     "name": "vibekit_db_schema",
-    "description": "Get the database schema for an app — all tables and their columns. Use this before writing a query.",
+    "title": "VibeKit Database Schema",
+    "description": "Get an app's database schema — every table and its columns. Always call this before writing a query with vibekit_db_query.",
+    "annotations": { "title": "VibeKit Database Schema", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Database",
     "name": "vibekit_db_query",
-    "description": "Run a SQL query against an app's Postgres database and return the result rows. Supports reads and writes. SQL string, max 5000 chars.",
+    "title": "VibeKit Run SQL Query",
+    "description": "Run a read-only SQL query against an app's Postgres database and return up to 200 result rows. SELECT only — writes and DDL (INSERT/UPDATE/DELETE/ALTER/DROP/…) are rejected server-side; use vibekit_chat or vibekit_submit_task to have the agent make data or schema changes. Call vibekit_db_schema first to learn the tables. SQL string, max 5000 chars.",
+    "annotations": { "title": "VibeKit Run SQL Query", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID" },
-        "sql": { "type": "string", "description": "SQL to execute (max 5000 chars)" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "sql": {
+          "type": "string",
+          "description": "SQL to execute (max 5000 chars). Reads and writes both allowed."
+        }
       },
-      "required": ["appId", "sql"]
+      "required": [
+        "appId",
+        "sql"
+      ]
     }
   },
   {
     "category": "Database",
     "name": "vibekit_db_table",
-    "description": "Browse rows in a specific database table, with pagination and optional sorting.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "appId": { "type": "string", "description": "The app ID" },
-        "table": { "type": "string", "description": "Table name" },
-        "limit": { "type": "number", "description": "Max rows to return (default 50, max 200)" },
-        "offset": { "type": "number", "description": "Row offset for pagination (default 0)" }
+    "title": "VibeKit Browse Table",
+    "description": "Browse rows of one table with pagination and optional sorting — a quick read-only alternative to hand-writing a SELECT.",
+    "annotations": { "title": "VibeKit Browse Table", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "table": {
+          "type": "string",
+          "description": "Table name (see vibekit_db_schema)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max rows to return (default 50, max 200)"
+        },
+        "offset": {
+          "type": "number",
+          "description": "Row offset for pagination (default 0)"
+        }
       },
-      "required": ["appId", "table"]
+      "required": [
+        "appId",
+        "table"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_list_deploys",
-    "description": "List recent deploys for an app, most recent first, with their status and commit info. Find a deploy ID here to roll back to.",
+    "title": "VibeKit List Deploys",
+    "description": "List an app's recent deploys, newest first, with status and commit info. Find a deployId here to pass to vibekit_rollback_deploy.",
+    "annotations": { "title": "VibeKit List Deploys", "readOnlyHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID" },
-        "limit": { "type": "number", "description": "Max deploys to return (default 20, max 50)" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max deploys to return (default 20, max 50)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Hosting & Apps",
     "name": "vibekit_rollback_deploy",
-    "description": "Roll an app back to a previous deploy. Get the deploy ID from vibekit_list_deploys. The container restarts on the rolled-back build.",
+    "title": "VibeKit Rollback Deploy",
+    "description": "Roll an app back to a previous deploy (get the deployId from vibekit_list_deploys). The container restarts on the rolled-back build; reversible by rolling forward again.",
+    "annotations": { "title": "VibeKit Rollback Deploy", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID" },
-        "deployId": { "type": "string", "description": "The deploy ID to roll back to (from vibekit_list_deploys)" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        },
+        "deployId": {
+          "type": "string",
+          "description": "Deploy ID to roll back to (from vibekit_list_deploys)"
+        }
       },
-      "required": ["appId", "deployId"]
+      "required": [
+        "appId",
+        "deployId"
+      ]
     }
   },
   {
     "category": "QA",
     "name": "vibekit_run_qa",
-    "description": "Run automated QA tests on a hosted app.",
+    "title": "VibeKit Run QA",
+    "description": "Kick off an automated QA run (headless-browser checks) against a hosted app. Poll vibekit_qa_status for results.",
+    "annotations": { "title": "VibeKit Run QA", "readOnlyHint": false, "destructiveHint": false },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to run QA tests for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "QA",
     "name": "vibekit_qa_status",
-    "description": "Get QA test results and status for an app.",
+    "title": "VibeKit QA Status",
+    "description": "Get the latest automated QA results and status for an app.",
+    "annotations": { "title": "VibeKit QA Status", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "appId": { "type": "string", "description": "The app ID to get QA status for" }
+        "appId": {
+          "type": "string",
+          "description": "App ID (from vibekit_list_apps)"
+        }
       },
-      "required": ["appId"]
+      "required": [
+        "appId"
+      ]
     }
   },
   {
     "category": "Tasks",
     "name": "vibekit_submit_task",
-    "description": "Submit a coding task to VibeKit. The AI will write code, commit to GitHub, and deploy to {subdomain}.vibekit.bot. Returns a task ID to poll for results.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "task": { "type": "string", "description": "What you want built or changed. Be specific about features, design, and behavior." },
-        "repo": { "type": "string", "description": "GitHub repo in format 'owner/repo'. Optional — will use user's current repo if not specified." },
-        "branch": { "type": "string", "description": "Git branch to work on. Default: main" },
-        "deploy": { "type": "boolean", "description": "Auto-deploy to Vercel when done. Default: true" },
-        "callbackUrl": { "type": "string", "description": "Webhook URL to receive task completion notification." }
+    "title": "VibeKit Submit Task",
+    "description": "Submit an autonomous coding task. The AI writes the code, commits to GitHub, and (by default) deploys to <subdomain>.vibekit.bot. Returns a taskId — poll vibekit_get_task or block with vibekit_wait_for_task. Use for 'build X' or 'change X' work against a repo.",
+    "annotations": { "title": "VibeKit Submit Task", "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "task": {
+          "type": "string",
+          "description": "What you want built or changed. Be specific about features, design, and behavior."
+        },
+        "repo": {
+          "type": "string",
+          "description": "GitHub repo as 'owner/repo'. Optional — uses the user's current repo if omitted."
+        },
+        "branch": {
+          "type": "string",
+          "description": "Git branch to work on (default 'main')"
+        },
+        "deploy": {
+          "type": "boolean",
+          "description": "Auto-deploy to <subdomain>.vibekit.bot when done (default true)"
+        },
+        "callbackUrl": {
+          "type": "string",
+          "description": "Optional webhook URL to receive a task-completion notification."
+        }
       },
-      "required": ["task"]
+      "required": [
+        "task"
+      ]
     }
   },
   {
     "category": "Tasks",
     "name": "vibekit_get_task",
-    "description": "Get the status and result of a previously submitted task.",
+    "title": "VibeKit Get Task",
+    "description": "Get the status and result of a task submitted via vibekit_submit_task.",
+    "annotations": { "title": "VibeKit Get Task", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "taskId": { "type": "string", "description": "The task ID returned from vibekit_submit_task" }
+        "taskId": {
+          "type": "string",
+          "description": "Task ID returned from vibekit_submit_task"
+        }
       },
-      "required": ["taskId"]
+      "required": [
+        "taskId"
+      ]
     }
   },
   {
     "category": "Tasks",
     "name": "vibekit_list_tasks",
-    "description": "List recent tasks submitted to VibeKit.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "limit": { "type": "number", "description": "Max number of tasks to return. Default: 10" },
-        "status": { "type": "string", "enum": ["pending", "running", "completed", "failed"], "description": "Filter by status" }
+    "title": "VibeKit List Tasks",
+    "description": "List recent coding tasks, optionally filtered by status.",
+    "annotations": { "title": "VibeKit List Tasks", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Max number of tasks to return (default 10)"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "running",
+            "completed",
+            "failed"
+          ],
+          "description": "Filter by task status"
+        }
       }
     }
   },
   {
     "category": "Tasks",
     "name": "vibekit_wait_for_task",
-    "description": "Wait for a task to complete and return the result. Polls every 5 seconds up to the timeout.",
+    "title": "VibeKit Wait for Task",
+    "description": "Block until a submitted task finishes (or the timeout), polling every 5 seconds, then return its result. Use right after vibekit_submit_task when you want the final result inline.",
+    "annotations": { "title": "VibeKit Wait for Task", "readOnlyHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "taskId": { "type": "string", "description": "The task ID to wait for" },
-        "timeoutSeconds": { "type": "number", "description": "Max seconds to wait. Default: 300 (5 minutes)" }
+        "taskId": {
+          "type": "string",
+          "description": "Task ID to wait for (from vibekit_submit_task)"
+        },
+        "timeoutSeconds": {
+          "type": "number",
+          "description": "Max seconds to wait (default 300; the remote connector caps this at 120)"
+        }
       },
-      "required": ["taskId"]
+      "required": [
+        "taskId"
+      ]
     }
   },
   {
     "category": "Tasks",
     "name": "vibekit_cancel_task",
-    "description": "Cancel a running task by ID. No-op for tasks that have already completed.",
+    "title": "VibeKit Cancel Task",
+    "description": "Cancel a running task by taskId. No-op if it has already finished.",
+    "annotations": { "title": "VibeKit Cancel Task", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "taskId": { "type": "string", "description": "The task ID to cancel" }
+        "taskId": {
+          "type": "string",
+          "description": "Task ID to cancel (from vibekit_submit_task)"
+        }
       },
-      "required": ["taskId"]
+      "required": [
+        "taskId"
+      ]
     }
   },
   {
     "category": "Schedules",
     "name": "vibekit_create_schedule",
-    "description": "Create a scheduled recurring task. The AI will run this task automatically on the specified schedule.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "task": { "type": "string", "description": "What to do on each run. e.g., 'Improve SEO and page speed'" },
-        "repo": { "type": "string", "description": "GitHub repo in format 'owner/repo'" },
-        "cron": { "type": "string", "description": "Cron expression. e.g., '0 9 * * 1' for every Monday at 9am UTC" },
-        "name": { "type": "string", "description": "Friendly name for the schedule" }
+    "title": "VibeKit Create Schedule",
+    "description": "Create a recurring coding task that the AI runs automatically on a cron schedule (e.g. a weekly SEO pass). Use for 'every Monday, do X to my repo' requests.",
+    "annotations": { "title": "VibeKit Create Schedule", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "task": {
+          "type": "string",
+          "description": "What to do on each run, e.g. 'Improve SEO and page speed'"
+        },
+        "repo": {
+          "type": "string",
+          "description": "GitHub repo as 'owner/repo'"
+        },
+        "cron": {
+          "type": "string",
+          "description": "Cron expression, e.g. '0 9 * * 1' for every Monday at 9am UTC"
+        },
+        "name": {
+          "type": "string",
+          "description": "Friendly name for the schedule (optional)"
+        }
       },
-      "required": ["task", "repo", "cron"]
+      "required": [
+        "task",
+        "repo",
+        "cron"
+      ]
     }
   },
   {
     "category": "Schedules",
     "name": "vibekit_list_schedules",
-    "description": "List all scheduled tasks.",
-    "inputSchema": { "type": "object", "properties": {} }
+    "title": "VibeKit List Schedules",
+    "description": "List all of the account's scheduled recurring tasks.",
+    "annotations": { "title": "VibeKit List Schedules", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
   },
   {
     "category": "Schedules",
     "name": "vibekit_delete_schedule",
-    "description": "Delete a scheduled task.",
+    "title": "VibeKit Delete Schedule",
+    "description": "Delete a scheduled recurring task by scheduleId. Confirm with the user first.",
+    "annotations": { "title": "VibeKit Delete Schedule", "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "scheduleId": { "type": "string", "description": "The schedule ID to delete" }
+        "scheduleId": {
+          "type": "string",
+          "description": "Schedule ID to delete (from vibekit_list_schedules)"
+        }
       },
-      "required": ["scheduleId"]
+      "required": [
+        "scheduleId"
+      ]
     }
   },
   {
     "category": "Account",
     "name": "vibekit_account",
-    "description": "Get VibeKit account info including plan, credits balance, and usage.",
-    "inputSchema": { "type": "object", "properties": {} }
+    "title": "VibeKit Account Info",
+    "description": "Get VibeKit account info: plan, credit balance, and usage.",
+    "annotations": { "title": "VibeKit Account Info", "readOnlyHint": true, "idempotentHint": true },
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
   },
   {
     "category": "Skills",
     "name": "vibekit_list_skills",
-    "description": "List all available implementation skills. Returns skill IDs, names, descriptions, and tags. Use this to discover what skills are available before fetching specific ones.",
+    "title": "VibeKit List Skills",
+    "description": "List available implementation skills (IDs, names, descriptions, tags) from the VibeKit skills registry. Discover skills here before fetching one with vibekit_get_skill.",
+    "annotations": { "title": "VibeKit List Skills", "readOnlyHint": true, "openWorldHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "tag": { "type": "string", "description": "Filter skills by tag (e.g., 'react', 'database', 'security')" }
+        "tag": {
+          "type": "string",
+          "description": "Filter skills by tag (e.g. 'react', 'database', 'security')"
+        }
       }
     }
   },
   {
     "category": "Skills",
     "name": "vibekit_get_skill",
-    "description": "Fetch the full content of a specific skill. Skills contain implementation patterns, code examples, and best practices for a domain. Fetch skills on-demand when you need guidance on a specific topic.",
+    "title": "VibeKit Get Skill",
+    "description": "Fetch the full content of a specific skill — implementation patterns, code examples, and best practices for a domain. Fetch on-demand when you need guidance on a specific topic.",
+    "annotations": { "title": "VibeKit Get Skill", "readOnlyHint": true, "openWorldHint": true },
     "inputSchema": {
       "type": "object",
       "properties": {
-        "id": { "type": "string", "description": "Skill ID from vibekit_list_skills (e.g., 'nextjs', 'trpc', 'auth')" }
+        "id": {
+          "type": "string",
+          "description": "Skill ID from vibekit_list_skills (e.g. 'nextjs', 'trpc', 'auth')"
+        }
       },
-      "required": ["id"]
+      "required": [
+        "id"
+      ]
     }
   }
 ]

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 VibeKit
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.