@sutraha/mcp-server 0.1.1

package/README.md

@@ -0,0 +1,65 @@
+# @sutraha/mcp-server
+
+MCP server and CLI for connecting AI agents to **Sutraha HQ** — the multi-agent orchestration dashboard.
+
+## Setup
+
+1. Create an API key in Sutraha HQ: **Settings → API Keys → Create Key**
+2. Note your workspace ID from the URL or settings page
+
+## MCP Server (for OpenClaw / MCPorter)
+
+Add to your MCPorter config:
+
+```json
+{
+  "servers": {
+    "sutraha-hq": {
+      "command": "npx",
+      "args": ["@sutraha/mcp-server"],
+      "env": {
+        "CONVEX_URL": "https://your-deployment.convex.cloud",
+        "CONVEX_SITE_URL": "https://your-deployment.convex.site",
+        "SUTRAHA_API_KEY": "sk_your_api_key_here",
+        "SUTRAHA_WORKSPACE_ID": "your_workspace_id"
+      }
+    }
+  }
+}
+```
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `sutraha_list_agents` | List all active agents |
+| `sutraha_get_agent` | Get agent by ID |
+| `sutraha_update_agent_status` | Set agent status |
+| `sutraha_agent_heartbeat` | Send heartbeat |
+| `sutraha_list_tasks` | List all tasks |
+| `sutraha_get_task` | Get task by ID |
+| `sutraha_get_my_tasks` | Get tasks for an agent |
+| `sutraha_create_task` | Create a task |
+| `sutraha_update_task` | Update task fields |
+| `sutraha_update_task_status` | Change task status |
+| `sutraha_list_messages` | List task comments |
+| `sutraha_send_message` | Post a comment |
+| `sutraha_send_chat` | Send chat message |
+| `sutraha_list_broadcasts` | List broadcasts |
+| `sutraha_respond_to_broadcast` | Respond to broadcast |
+| `sutraha_list_documents` | List documents |
+| `sutraha_create_document` | Create a document |
+| `sutraha_get_activities` | Get activity feed |
+
+## CLI
+
+```bash
+export CONVEX_URL=https://your-deployment.convex.cloud
+export CONVEX_SITE_URL=https://your-deployment.convex.site
+export SUTRAHA_API_KEY=sk_your_api_key_here
+export SUTRAHA_WORKSPACE_ID=your_workspace_id
+
+npx @sutraha/mcp-server cli agents list
+npx @sutraha/mcp-server cli tasks create --title "Fix bug" --priority high
+npx @sutraha/mcp-server cli tasks update-status --id <taskId> --status done
+```

package/dist/api.d.ts

@@ -0,0 +1 @@
+export declare const api: import("convex/server").AnyApi;

package/dist/api.js

@@ -0,0 +1,11 @@
+/**
+ * Convex API function references for the Sutraha HQ backend.
+ *
+ * These are lightweight references that the ConvexHttpClient uses to call
+ * server functions. They match the function paths in the Convex project.
+ *
+ * Using `anyApi` since this package doesn't have access to the generated types.
+ */
+import { anyApi } from "convex/server";
+export const api = anyApi;
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC"}

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+/**
+ * Sutraha HQ CLI
+ *
+ * Command-line interface for interacting with the Sutraha HQ backend.
+ * Useful for debugging and manual operations.
+ *
+ * Usage:
+ *   sutraha-cli <resource> <action> [options]
+ *
+ * Examples:
+ *   sutraha-cli agents list
+ *   sutraha-cli tasks list
+ *   sutraha-cli tasks create --title "Fix bug" --priority high
+ *   sutraha-cli tasks update-status --id <id> --status done
+ *   sutraha-cli chat send --session-id chat:key --agent-id <id> --message "Hello"
+ */
+import { createClientFromEnv } from "./convex-client.js";
+import { api } from "./api.js";
+const client = createClientFromEnv();
+function usage() {
+    console.log(`
+Sutraha HQ CLI
+
+Usage: sutraha-cli <resource> <action> [options]
+
+Resources:
+  agents     list | get --id <id> | heartbeat --id <id> | status --id <id> --status <s>
+  tasks      list | get --id <id> | create --title <t> | update-status --id <id> --status <s>
+  messages   list --task-id <id> | send --task-id <id> --agent-id <id> --content <msg>
+  chat       send --session-id <sid> --agent-id <id> --message <msg>
+  broadcasts list
+  documents  list | create --title <t> --content <c> --agent-id <id>
+  activities list
+
+Environment variables:
+  CONVEX_URL             Convex cloud URL
+  CONVEX_SITE_URL        Convex site URL (for token exchange)
+  SUTRAHA_API_KEY        Workspace API key
+  SUTRAHA_WORKSPACE_ID   Workspace ID
+  `.trim());
+}
+function getArg(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function requireArg(args, flag, name) {
+    const val = getArg(args, flag);
+    if (!val) {
+        console.error(`Missing required option: ${flag} <${name}>`);
+        process.exit(1);
+    }
+    return val;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length < 2 || args[0] === "--help" || args[0] === "-h") {
+        usage();
+        process.exit(0);
+    }
+    const [resource, action, ...rest] = args;
+    try {
+        let result;
+        switch (resource) {
+            case "agents":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.agents.list);
+                        break;
+                    case "get":
+                        result = await client.query(api.agents.getById, {
+                            id: requireArg(rest, "--id", "agentId"),
+                        });
+                        break;
+                    case "heartbeat":
+                        await client.mutation(api.agents.updateHeartbeat, {
+                            id: requireArg(rest, "--id", "agentId"),
+                        });
+                        result = { ok: true };
+                        break;
+                    case "status":
+                        await client.mutation(api.agents.updateStatus, {
+                            id: requireArg(rest, "--id", "agentId"),
+                            status: requireArg(rest, "--status", "status"),
+                        });
+                        result = { ok: true };
+                        break;
+                    default:
+                        console.error(`Unknown agents action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "tasks":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.tasks.list);
+                        break;
+                    case "get":
+                        result = await client.query(api.tasks.getById, {
+                            id: requireArg(rest, "--id", "taskId"),
+                        });
+                        break;
+                    case "create":
+                        result = await client.mutation(api.tasks.create, {
+                            title: requireArg(rest, "--title", "title"),
+                            description: getArg(rest, "--description") ?? "",
+                            status: getArg(rest, "--status") ?? "inbox",
+                            priority: getArg(rest, "--priority") ?? "medium",
+                            assigneeIds: [],
+                        });
+                        break;
+                    case "update-status":
+                        await client.mutation(api.tasks.updateStatus, {
+                            id: requireArg(rest, "--id", "taskId"),
+                            status: requireArg(rest, "--status", "status"),
+                        });
+                        result = { ok: true };
+                        break;
+                    default:
+                        console.error(`Unknown tasks action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "messages":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.messages.list, {
+                            taskId: requireArg(rest, "--task-id", "taskId"),
+                        });
+                        break;
+                    case "send":
+                        await client.mutation(api.messages.create, {
+                            content: requireArg(rest, "--content", "content"),
+                            taskId: requireArg(rest, "--task-id", "taskId"),
+                            agentId: requireArg(rest, "--agent-id", "agentId"),
+                        });
+                        result = { ok: true };
+                        break;
+                    default:
+                        console.error(`Unknown messages action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "chat":
+                switch (action) {
+                    case "send":
+                        await client.mutation(api.chatMessages.send, {
+                            sessionId: requireArg(rest, "--session-id", "sessionId"),
+                            agentId: requireArg(rest, "--agent-id", "agentId"),
+                            content: requireArg(rest, "--message", "message"),
+                            fromUser: false,
+                        });
+                        result = { ok: true };
+                        break;
+                    default:
+                        console.error(`Unknown chat action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "broadcasts":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.broadcasts.list);
+                        break;
+                    default:
+                        console.error(`Unknown broadcasts action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "documents":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.documents.list);
+                        break;
+                    case "create":
+                        result = await client.mutation(api.documents.create, {
+                            title: requireArg(rest, "--title", "title"),
+                            content: requireArg(rest, "--content", "content"),
+                            type: getArg(rest, "--type") ?? "note",
+                            taskId: getArg(rest, "--task-id") ?? null,
+                            agentId: requireArg(rest, "--agent-id", "agentId"),
+                        });
+                        break;
+                    default:
+                        console.error(`Unknown documents action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            case "activities":
+                switch (action) {
+                    case "list":
+                        result = await client.query(api.activities.recent);
+                        break;
+                    default:
+                        console.error(`Unknown activities action: ${action}`);
+                        process.exit(1);
+                }
+                break;
+            default:
+                console.error(`Unknown resource: ${resource}`);
+                usage();
+                process.exit(1);
+        }
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error("Error:", error.message);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/convex-client.d.ts

@@ -0,0 +1,22 @@
+export declare class SutrahaClient {
+    private client;
+    private siteUrl;
+    private apiKey;
+    workspaceId: string;
+    private token;
+    private tokenExpiresAt;
+    constructor(config: {
+        convexUrl: string;
+        convexSiteUrl: string;
+        apiKey: string;
+        workspaceId: string;
+    });
+    /** Ensure we have a valid token, refreshing if needed. */
+    private ensureAuth;
+    /** Execute a Convex query with auto-auth. */
+    query(functionRef: any, args?: Record<string, any>): Promise<any>;
+    /** Execute a Convex mutation with auto-auth. */
+    mutation(functionRef: any, args?: Record<string, any>): Promise<any>;
+}
+/** Create a client from environment variables. */
+export declare function createClientFromEnv(): SutrahaClient;

package/dist/convex-client.js

@@ -0,0 +1,73 @@
+/**
+ * Convex client wrapper with API key → JWT auto-refresh auth.
+ */
+import { ConvexHttpClient } from "convex/browser";
+export class SutrahaClient {
+    client;
+    siteUrl;
+    apiKey;
+    workspaceId;
+    token = null;
+    tokenExpiresAt = 0;
+    constructor(config) {
+        this.client = new ConvexHttpClient(config.convexUrl);
+        this.siteUrl = config.convexSiteUrl;
+        this.apiKey = config.apiKey;
+        this.workspaceId = config.workspaceId;
+    }
+    /** Ensure we have a valid token, refreshing if needed. */
+    async ensureAuth() {
+        // Refresh if token expires in less than 5 minutes
+        if (this.token && this.tokenExpiresAt > Date.now() + 5 * 60 * 1000) {
+            return;
+        }
+        const res = await fetch(`${this.siteUrl}/api/v1/auth/token`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Token exchange failed (${res.status}): ${body}`);
+        }
+        const data = await res.json();
+        this.token = data.token;
+        this.tokenExpiresAt = data.expiresAt;
+        this.client.setAuth(data.token);
+    }
+    /** Execute a Convex query with auto-auth. */
+    async query(functionRef, args = {}) {
+        await this.ensureAuth();
+        return this.client.query(functionRef, {
+            workspaceId: this.workspaceId,
+            ...args,
+        });
+    }
+    /** Execute a Convex mutation with auto-auth. */
+    async mutation(functionRef, args = {}) {
+        await this.ensureAuth();
+        return this.client.mutation(functionRef, {
+            workspaceId: this.workspaceId,
+            ...args,
+        });
+    }
+}
+/** Create a client from environment variables. */
+export function createClientFromEnv() {
+    const convexUrl = process.env.CONVEX_URL;
+    const convexSiteUrl = process.env.CONVEX_SITE_URL;
+    const apiKey = process.env.SUTRAHA_API_KEY;
+    const workspaceId = process.env.SUTRAHA_WORKSPACE_ID;
+    if (!convexUrl)
+        throw new Error("Missing CONVEX_URL env var");
+    if (!convexSiteUrl)
+        throw new Error("Missing CONVEX_SITE_URL env var");
+    if (!apiKey)
+        throw new Error("Missing SUTRAHA_API_KEY env var");
+    if (!workspaceId)
+        throw new Error("Missing SUTRAHA_WORKSPACE_ID env var");
+    return new SutrahaClient({ convexUrl, convexSiteUrl, apiKey, workspaceId });
+}
+//# sourceMappingURL=convex-client.js.map

package/dist/convex-client.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * Sutraha HQ MCP Server
+ *
+ * Connects AI agents (OpenClaw, etc.) to the Sutraha HQ orchestration dashboard
+ * via the Model Context Protocol (MCP).
+ *
+ * Usage:
+ *   CONVEX_URL=... CONVEX_SITE_URL=... SUTRAHA_API_KEY=... SUTRAHA_WORKSPACE_ID=... npx @sutraha/mcp-server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createClientFromEnv } from "./convex-client.js";
+import { api } from "./api.js";
+const client = createClientFromEnv();
+const server = new McpServer({
+    name: "sutraha-hq",
+    version: "0.1.0",
+});
+// ═══════════════════════════════════════════════════════════
+//  Agent Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_list_agents", "List all active agents in the workspace", {}, async () => {
+    const agents = await client.query(api.agents.list);
+    return { content: [{ type: "text", text: JSON.stringify(agents, null, 2) }] };
+});
+server.tool("sutraha_get_agent", "Get an agent by ID", { agentId: z.string().describe("Agent ID") }, async ({ agentId }) => {
+    const agent = await client.query(api.agents.getById, { id: agentId });
+    return { content: [{ type: "text", text: JSON.stringify(agent, null, 2) }] };
+});
+server.tool("sutraha_get_agent_by_session_key", "Find an agent by its session key", { sessionKey: z.string().describe("Agent session key") }, async ({ sessionKey }) => {
+    const agent = await client.query(api.agents.getBySessionKey, { sessionKey });
+    return { content: [{ type: "text", text: JSON.stringify(agent, null, 2) }] };
+});
+server.tool("sutraha_update_agent_status", "Update an agent's status (active, idle, or blocked)", {
+    agentId: z.string().describe("Agent ID"),
+    status: z.enum(["active", "idle", "blocked"]).describe("New status"),
+}, async ({ agentId, status }) => {
+    await client.mutation(api.agents.updateStatus, { id: agentId, status });
+    return { content: [{ type: "text", text: `Agent status updated to ${status}` }] };
+});
+server.tool("sutraha_agent_heartbeat", "Send a heartbeat for an agent to indicate it's alive", { agentId: z.string().describe("Agent ID") }, async ({ agentId }) => {
+    await client.mutation(api.agents.updateHeartbeat, { id: agentId });
+    return { content: [{ type: "text", text: "Heartbeat sent" }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Task Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_list_tasks", "List all tasks in the workspace", {}, async () => {
+    const tasks = await client.query(api.tasks.list);
+    return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
+});
+server.tool("sutraha_get_task", "Get a task by ID with full details", { taskId: z.string().describe("Task ID") }, async ({ taskId }) => {
+    const task = await client.query(api.tasks.getById, { id: taskId });
+    return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
+});
+server.tool("sutraha_get_my_tasks", "Get tasks assigned to a specific agent", { agentId: z.string().describe("Agent ID") }, async ({ agentId }) => {
+    const tasks = await client.query(api.tasks.getByAssignee, { agentId });
+    return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
+});
+server.tool("sutraha_create_task", "Create a new task in the workspace", {
+    title: z.string().describe("Task title"),
+    description: z.string().optional().describe("Task description"),
+    status: z.enum(["inbox", "assigned", "in_progress", "review", "done", "blocked"]).optional().describe("Task status (default: inbox)"),
+    priority: z.enum(["high", "medium", "low", "none"]).optional().describe("Priority level (default: medium)"),
+    assigneeIds: z.array(z.string()).optional().describe("Agent IDs to assign"),
+}, async ({ title, description, status, priority, assigneeIds }) => {
+    const id = await client.mutation(api.tasks.create, {
+        title,
+        description: description ?? "",
+        status: status ?? "inbox",
+        priority: priority ?? "medium",
+        assigneeIds: assigneeIds ?? [],
+    });
+    return { content: [{ type: "text", text: `Task created with ID: ${id}` }] };
+});
+server.tool("sutraha_update_task", "Update a task's fields", {
+    taskId: z.string().describe("Task ID"),
+    title: z.string().optional().describe("New title"),
+    description: z.string().optional().describe("New description"),
+    priority: z.enum(["high", "medium", "low", "none"]).optional().describe("New priority"),
+    assigneeIds: z.array(z.string()).optional().describe("New assignee IDs"),
+}, async ({ taskId, ...updates }) => {
+    await client.mutation(api.tasks.update, { id: taskId, ...updates });
+    return { content: [{ type: "text", text: `Task ${taskId} updated` }] };
+});
+server.tool("sutraha_update_task_status", "Change a task's status", {
+    taskId: z.string().describe("Task ID"),
+    status: z.enum(["inbox", "assigned", "in_progress", "review", "done", "blocked"]).describe("New status"),
+}, async ({ taskId, status }) => {
+    await client.mutation(api.tasks.updateStatus, { id: taskId, status });
+    return { content: [{ type: "text", text: `Task status updated to ${status}` }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Communication Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_list_messages", "List comments/messages on a task", { taskId: z.string().describe("Task ID") }, async ({ taskId }) => {
+    const messages = await client.query(api.messages.list, { taskId });
+    return { content: [{ type: "text", text: JSON.stringify(messages, null, 2) }] };
+});
+server.tool("sutraha_send_message", "Post a comment on a task (supports @mentions)", {
+    content: z.string().describe("Message content (use @agent:name for mentions)"),
+    taskId: z.string().describe("Task ID to comment on"),
+    agentId: z.string().describe("Agent ID posting the message"),
+}, async ({ content, taskId, agentId }) => {
+    await client.mutation(api.messages.create, { content, taskId, agentId });
+    return { content: [{ type: "text", text: "Message sent" }] };
+});
+server.tool("sutraha_send_chat", "Send a chat message as an agent", {
+    sessionId: z.string().describe("Chat session ID (e.g., chat:agent-session-key)"),
+    agentId: z.string().describe("Agent ID sending the message"),
+    content: z.string().describe("Message content"),
+}, async ({ sessionId, agentId, content }) => {
+    await client.mutation(api.chatMessages.send, {
+        sessionId,
+        agentId,
+        content,
+        fromUser: false,
+    });
+    return { content: [{ type: "text", text: "Chat message sent" }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Broadcast Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_list_broadcasts", "List workspace broadcasts", {}, async () => {
+    const broadcasts = await client.query(api.broadcasts.list);
+    return { content: [{ type: "text", text: JSON.stringify(broadcasts, null, 2) }] };
+});
+server.tool("sutraha_respond_to_broadcast", "Respond to a workspace broadcast", {
+    broadcastId: z.string().describe("Broadcast ID"),
+    agentId: z.string().describe("Agent ID responding"),
+    content: z.string().describe("Response content"),
+}, async ({ broadcastId, agentId, content }) => {
+    await client.mutation(api.broadcasts.addResponse, {
+        broadcastId,
+        agentId,
+        content,
+    });
+    return { content: [{ type: "text", text: "Broadcast response sent" }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Document Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_list_documents", "List documents in the workspace", { taskId: z.string().optional().describe("Filter by task ID") }, async ({ taskId }) => {
+    const docs = taskId
+        ? await client.query(api.documents.getByTask, { taskId })
+        : await client.query(api.documents.list);
+    return { content: [{ type: "text", text: JSON.stringify(docs, null, 2) }] };
+});
+server.tool("sutraha_create_document", "Create a document in the workspace", {
+    title: z.string().describe("Document title"),
+    content: z.string().describe("Document content (markdown)"),
+    type: z.enum(["deliverable", "research", "protocol", "note"]).optional().describe("Document type (default: note)"),
+    taskId: z.string().optional().describe("Link to a task"),
+    agentId: z.string().describe("Agent ID creating the document"),
+}, async ({ title, content, type, taskId, agentId }) => {
+    const id = await client.mutation(api.documents.create, {
+        title,
+        content,
+        type: type ?? "note",
+        taskId: taskId ?? null,
+        agentId,
+    });
+    return { content: [{ type: "text", text: `Document created with ID: ${id}` }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Activity Tools
+// ═══════════════════════════════════════════════════════════
+server.tool("sutraha_get_activities", "Get recent activity feed for the workspace", {}, async () => {
+    const activities = await client.query(api.activities.recent);
+    return { content: [{ type: "text", text: JSON.stringify(activities, null, 2) }] };
+});
+// ═══════════════════════════════════════════════════════════
+//  Start Server
+// ═══════════════════════════════════════════════════════════
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Sutraha HQ MCP server running (stdio)");
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    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":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@sutraha/mcp-server",
+  "version": "0.1.1",
+  "description": "MCP server for Sutraha HQ — connects AI agents to the orchestration dashboard",
+  "type": "module",
+  "bin": {
+    "sutraha-mcp": "dist/index.js",
+    "sutraha-cli": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "convex": "^1.31.7"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}