hiloop-mcp 0.1.0

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const BASE_URL = process.env.HILOOP_BASE_URL || "https://api.hi-loop.com";
+const API_KEY = process.env.HILOOP_API_KEY || "";
+async function apiFetch(path, options = {}) {
+    const url = `${BASE_URL}/v1${path}`;
+    const headers = {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY,
+        ...options.headers,
+    };
+    const res = await fetch(url, { ...options, headers });
+    const body = await res.json();
+    if (!res.ok) {
+        throw new Error(`API error ${res.status}: ${body.error || JSON.stringify(body)}`);
+    }
+    return body;
+}
+const server = new McpServer({
+    name: "hiloop",
+    version: "0.1.0",
+});
+// -- Tools --------------------------------------------------------------------
+server.tool("create_interaction", "Create a new human-in-the-loop interaction (approval, chat, review, form, notification)", {
+    type: z
+        .enum([
+        "approval",
+        "chat",
+        "review",
+        "form",
+        "notification",
+        "live_session",
+        "voice_call",
+        "payment",
+        "scheduled_call",
+    ])
+        .describe("The type of interaction"),
+    title: z.string().describe("Title of the interaction (will be sent as-is)"),
+    description: z
+        .string()
+        .optional()
+        .describe("Optional description with more context"),
+    priority: z
+        .enum(["critical", "high", "normal", "low"])
+        .default("normal")
+        .describe("Priority level"),
+    deadline_minutes: z
+        .number()
+        .optional()
+        .describe("Deadline in minutes from now"),
+    options: z
+        .string()
+        .optional()
+        .describe("JSON array of options for approval type, e.g. [\"approve\",\"reject\"]"),
+}, async (params) => {
+    const body = {
+        type: params.type,
+        encryptedTitle: params.title,
+        priority: params.priority,
+    };
+    if (params.description)
+        body.encryptedDescription = params.description;
+    if (params.deadline_minutes)
+        body.deadlineMinutes = params.deadline_minutes;
+    if (params.options)
+        body.encryptedOptions = params.options;
+    const result = await apiFetch("/agent/interactions", {
+        method: "POST",
+        body: JSON.stringify(body),
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_interactions", "List interactions created by this agent", {
+    status: z
+        .enum([
+        "created",
+        "assigned",
+        "viewed",
+        "responded",
+        "completed",
+        "cancelled",
+        "expired",
+        "escalated",
+        "snoozed",
+    ])
+        .optional()
+        .describe("Filter by status"),
+    type: z
+        .enum([
+        "approval",
+        "chat",
+        "review",
+        "form",
+        "notification",
+        "live_session",
+        "voice_call",
+        "payment",
+        "scheduled_call",
+    ])
+        .optional()
+        .describe("Filter by type"),
+    page: z.number().default(1).describe("Page number"),
+}, async (params) => {
+    const query = new URLSearchParams();
+    if (params.status)
+        query.set("status", params.status);
+    if (params.type)
+        query.set("type", params.type);
+    query.set("page", String(params.page));
+    const result = await apiFetch(`/agent/interactions?${query.toString()}`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_interaction", "Get details of a specific interaction", {
+    interaction_id: z.string().describe("The interaction ID"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("await_response", "Wait for a human to respond to an interaction (long-polls up to 30s)", {
+    interaction_id: z.string().describe("The interaction ID"),
+    timeout: z
+        .number()
+        .default(30)
+        .describe("Timeout in seconds (max 30)"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}/await?timeout=${params.timeout}`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("cancel_interaction", "Cancel a pending interaction", {
+    interaction_id: z.string().describe("The interaction ID to cancel"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}`, { method: "DELETE" });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("acknowledge_interaction", "Acknowledge (complete) an interaction after processing the response", {
+    interaction_id: z.string().describe("The interaction ID to acknowledge"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}/acknowledge`, { method: "POST" });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("send_message", "Send a chat message on an interaction", {
+    interaction_id: z.string().describe("The interaction ID"),
+    content: z.string().describe("Message content to send"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}/messages`, {
+        method: "POST",
+        body: JSON.stringify({ encryptedContent: params.content }),
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_messages", "List chat messages on an interaction", {
+    interaction_id: z.string().describe("The interaction ID"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}/messages`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("check_quota", "Check the current agent's usage quota", {}, async () => {
+    const result = await apiFetch("/agent/quota");
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_transitions", "Get the status transition history of an interaction", {
+    interaction_id: z.string().describe("The interaction ID"),
+}, async (params) => {
+    const result = await apiFetch(`/agent/interactions/${params.interaction_id}/transitions`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// -- Start server -------------------------------------------------------------
+async function main() {
+    if (!API_KEY) {
+        console.error("Error: HILOOP_API_KEY environment variable is required.\n" +
+            "Set it to your agent API key (starts with hlp_).");
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "hiloop-mcp",
+  "version": "0.1.0",
+  "description": "Hiloop MCP server - Human-in-the-loop for AI agents via Model Context Protocol",
+  "type": "module",
+  "bin": {
+    "hiloop-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sjorsdev/hiloop.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://www.hi-loop.com",
+  "bugs": {
+    "url": "https://github.com/sjorsdev/hiloop/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "hiloop",
+    "human-in-the-loop",
+    "ai-agents",
+    "approval",
+    "review",
+    "chat"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsx": "^4",
+    "typescript": "^5.7"
+  }
+}