klevia-mcp 0.1.0 → 0.1.1

package/README.md

@@ -4,6 +4,8 @@ Drive [Klevia](https://klevia.com.tr) from a CLI or an agent: read what is in a
 workspace, scan a region, build demo pages for businesses that have none, edit
 them, and deliver them.
 
+[![npm](https://img.shields.io/npm/v/klevia-mcp)](https://www.npmjs.com/package/klevia-mcp)
+
 ## Install
 
 Nothing to install. Point your MCP host at it with `npx`.
@@ -67,6 +69,24 @@ so:
 | `klevia_scans` | Region scans, and whether one is waiting for your approval |
 | `klevia_leads` | Businesses found, with the phone that decides if they are workable |
 
+| `klevia_scan_start` | Start a metered region scan |
+| `klevia_scan` | Read progress, candidates and the planner's question |
+| `klevia_scan_answer` | Answer the planner's question and resume |
+| `klevia_scan_approve` | Approve or reject the candidate list |
+| `klevia_customer_lookup` | Find a known business on Google |
+| `klevia_demo_build` | Build a demo for a sourced lead |
+| `klevia_demo_build_manual` | Build from a selected place or supplied facts |
+| `klevia_demo_document` | Read the editable document |
+| `klevia_demo_edit` | Apply typed edits |
+| `klevia_demo_mark_sent` | Record an actual send and start follow-up |
+| `klevia_demo_mark_sold` | Record or remove a sale |
+| `klevia_demo_publish` | Publish the approved content |
+| `klevia_domain_attach` | Attach a domain and return its DNS instructions |
+| `klevia_open` | Open the preview locally |
+| `klevia_whatsapp_open` | Open a WhatsApp chat locally |
+| `klevia_package_build` | Prepare a sold demo's delivery archive |
+| `klevia_package_download` | Save the archive locally |
+
 ## What it will not do
 
 - **Nothing customer-facing happens without you.** A scan parks on its

package/dist/contracts.js

@@ -0,0 +1,8 @@
+/** Payload shared by the manual-build tool and its API contract checks. */
+export function manualBuildPayload(input) {
+    const { sector, ...facts } = input;
+    return { sectorKey: sector, ...facts };
+}
+export function domainInstructions(result) {
+    return `${result.domain} attached. Add this at the registrar: ${result.dns.type} ${result.dns.name} -> ${result.dns.target}`;
+}

package/dist/index.js

@@ -21,7 +21,7 @@ import { registerEditTools } from "./tools/edit.js";
 import { registerSellTools } from "./tools/sell.js";
 import { registerLocalTools } from "./tools/local.js";
 import { registerReadTools } from "./tools/read.js";
-const VERSION = "0.1.0";
+const VERSION = "0.1.1";
 async function main() {
     const client = new KleviaClient(readConfig());
     const server = new McpServer({ name: "klevia", version: VERSION }, {

package/dist/tools/build.js

@@ -5,6 +5,7 @@
 // refusal comes back as a refusal rather than an exception, so the model
 // reports "the allowance is spent" instead of retrying a wall.
 import { z } from "zod";
+import { manualBuildPayload } from "../contracts.js";
 import { respond } from "./read.js";
 export function registerBuildTools(server, client) {
     server.registerTool("klevia_scan_start", {
@@ -61,6 +62,17 @@ export function registerBuildTools(server, client) {
             data: r,
         };
     }));
+    server.registerTool("klevia_scan_answer", {
+        title: "Taramanın sorusunu yanıtla",
+        description: "Answer the clarifying question reported by klevia_scan and resume that paused scan. Use the operator's answer; do not guess missing facts.",
+        inputSchema: { scanId: z.string().uuid(), answer: z.string().trim().min(2).max(4000) },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+    }, async ({ scanId, answer }) => respond(async () => {
+        const r = await client.request(`/api/v1/scans/${encodeURIComponent(scanId)}/answer`, {
+            method: "POST", body: { answer },
+        });
+        return { summary: "Answer accepted. Read klevia_scan to follow the scan.", data: r };
+    }));
     server.registerTool("klevia_scan_approve", {
         title: "Aday listesini onayla",
         description: "THE APPROVAL GATE. Approves or rejects a scan's candidate list. Approving lets the fleet spend real money enriching those businesses, so ask the operator before calling it, and show them the list first with klevia_scan. Businesses passed in dropLeadIds are struck off before the approval takes effect.",
@@ -141,12 +153,7 @@ export function registerBuildTools(server, client) {
     }, async ({ sector, businessName, placeId, phone, address, district }) => respond(async () => {
         const r = await client.request("/api/sites/manual", {
             method: "POST",
-            body: {
-                sectorKey: sector,
-                businessName,
-                placeId,
-                contact: { phone, address, district },
-            },
+            body: manualBuildPayload({ sector, businessName, placeId, phone, address, district }),
         });
         return {
             summary: `Demo built: ${r.site.id}`,

package/dist/tools/sell.js

@@ -5,8 +5,20 @@
 // None of them sends anything: reaching the business is still a human opening
 // their own WhatsApp.
 import { z } from "zod";
+import { domainInstructions } from "../contracts.js";
 import { respond } from "./read.js";
 export function registerSellTools(server, client) {
+    server.registerTool("klevia_demo_mark_sent", {
+        title: "Gönderildi olarak işaretle",
+        description: "Record that the operator actually sent the demo. This starts the preview expiry and follow-up clock. Opening WhatsApp does not mean a message was sent. Confirm with the operator first.",
+        inputSchema: { demoId: z.string().uuid() },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    }, async ({ demoId }) => respond(async () => {
+        await client.request(`/api/sites/${encodeURIComponent(demoId)}`, {
+            method: "PATCH", body: { markSent: true },
+        });
+        return { summary: "Demo marked sent. The preview expiry and follow-up clock have started.", data: { demoId } };
+    }));
     server.registerTool("klevia_demo_publish", {
         title: "Yayına al",
         description: "Put a demo live on its own address. The content is FROZEN at that moment, so later edits do not reach the live page until it is published again. Publishing is the step after the sale, not before sharing: the demo is already shareable at its preview address.",
@@ -65,9 +77,7 @@ export function registerSellTools(server, client) {
             body: { domain },
         });
         return {
-            summary: r.dnsRecord
-                ? `${r.domain} attached. Add this at the registrar: ${r.dnsRecord.type} ${r.dnsRecord.name} -> ${r.dnsRecord.target}`
-                : `${r.domain} attached.`,
+            summary: domainInstructions(r),
             data: r,
         };
     }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klevia-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Drive Klevia from a CLI or an agent: scan a region, build demo sites, edit them, deliver them.",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,8 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "typescript": "^5.9.2",
-    "@types/node": "^24.2.0"
+    "@types/node": "^24.2.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.2"
   }
 }