@recursiv/mcp 0.1.1

package/dist/tools/sandbox.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export function registerSandboxTools(registry, anonClient) {
+    // try_code requires no scopes — it uses an anonymous client
+    registry.tool('try_code', 'Execute code in a sandbox without authentication. Limited to 10 executions per day. Supports TypeScript, JavaScript, and Python.', [], {
+        code: z.string().describe('Code to execute'),
+        language: z
+            .enum(['javascript', 'typescript', 'python'])
+            .default('typescript')
+            .describe('Programming language'),
+    }, async ({ code, language }) => {
+        try {
+            const result = await anonClient.sandbox.execute({ code, language });
+            const lines = [
+                `Exit code: ${result.data.exitCode}`,
+                `Execution time: ${result.data.executionTime}ms`,
+                `Remaining executions today: ${result.meta.remaining_executions}`,
+                '',
+                '--- Output ---',
+                result.data.output || '(no output)',
+            ];
+            if (result.data.error) {
+                lines.push('', `Error: ${result.data.error}`);
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/tools/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,UAAoB;IACrF,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CACX,UAAU,EACV,kIAAkI,EAClI,EAAE,EACF;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC5C,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;aAC5C,OAAO,CAAC,YAAY,CAAC;aACrB,QAAQ,CAAC,sBAAsB,CAAC;KACpC,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAsE,EAAE,EAAE;QAC/F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpE,MAAM,KAAK,GAAG;gBACZ,cAAc,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE;gBACpC,mBAAmB,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI;gBAChD,+BAA+B,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;gBACjE,EAAE;gBACF,gBAAgB;gBAChB,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa;aACpC,CAAC;YACF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/social.d.ts

@@ -0,0 +1,11 @@
+import type { Recursiv } from '@recursiv/sdk';
+import { type ScopedToolRegistry } from '../scopes.js';
+/**
+ * Register social-media MCP tools.
+ *
+ * Write operations (create_post, generate_image, send_message) are
+ * RED-classified and routed through the approval gate. Read operations
+ * (list_posts, get_post, search_posts, etc.) execute immediately.
+ */
+export declare function registerSocialTools(registry: ScopedToolRegistry, client: Recursiv): void;
+//# sourceMappingURL=social.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../../src/tools/social.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAY/D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,QA4MjF"}

package/dist/tools/social.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { Scopes } from '../scopes.js';
+import { requireApproval, checkApprovalStatus, } from '../lib/approval-gate.js';
+/** MCP text response helper. */
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+/**
+ * Register social-media MCP tools.
+ *
+ * Write operations (create_post, generate_image, send_message) are
+ * RED-classified and routed through the approval gate. Read operations
+ * (list_posts, get_post, search_posts, etc.) execute immediately.
+ */
+export function registerSocialTools(registry, client) {
+    // Build approval config from the same env vars the SDK uses.
+    const baseUrl = (process.env.RECURSIV_BASE_URL || 'https://api.recursiv.io/api/v1').replace(/\/+$/, '');
+    const apiKey = process.env.RECURSIV_API_KEY || process.env.SOCIAL_DEV_API_KEY || '';
+    const orgId = process.env.RECURSIV_ORG_ID;
+    const defaultOrganizationId = process.env.RECURSIV_ORGANIZATION_ID || orgId;
+    if (!orgId) {
+        console.error('[approval-gate] RECURSIV_ORG_ID is not set — social write tools will operate WITHOUT approval gate. ' +
+            'Set RECURSIV_ORG_ID to enable RED-classified tool approval.');
+    }
+    const approvalConfig = orgId
+        ? { baseUrl, apiKey, orgId }
+        : null;
+    // ── Read-only tools (no approval needed) ──────────────────────────
+    registry.tool('list_posts', 'List posts with optional filtering by community or author', [Scopes.POSTS_READ], {
+        limit: z.number().optional().describe('Max posts to return (default 20, max 100)'),
+        offset: z.number().optional().describe('Pagination offset'),
+        community_id: z.string().optional().describe('Filter by community UUID'),
+        author_id: z.string().optional().describe('Filter by author UUID'),
+    }, async (params) => {
+        const result = await client.posts.list(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('get_post', 'Get a specific post by ID with its replies', [Scopes.POSTS_READ], {
+        id: z.string().describe('Post UUID'),
+    }, async ({ id }) => {
+        const result = await client.posts.get(id);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('search_posts', 'Search posts by text query', [Scopes.POSTS_READ], {
+        q: z.string().describe('Search query'),
+        limit: z.number().optional().describe('Max results'),
+        offset: z.number().optional().describe('Pagination offset'),
+    }, async (params) => {
+        const result = await client.posts.search(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('list_communities', 'List public communities', [Scopes.COMMUNITIES_READ], {
+        limit: z.number().optional().describe('Max communities to return'),
+        offset: z.number().optional().describe('Pagination offset'),
+    }, async (params) => {
+        const result = await client.communities.list(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('list_conversations', 'List all conversations for the authenticated user', [Scopes.CHAT_READ], {
+        limit: z.number().optional().describe('Max conversations'),
+        offset: z.number().optional().describe('Pagination offset'),
+    }, async (params) => {
+        const result = await client.chat.conversations(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    // ── RED write tools (approval gate required) ──────────────────────
+    registry.tool('create_post', '[RED — requires admin approval] Create a new post, optionally with media attachments. Use generate_image first to create AI images, then pass the returned URLs here.', [Scopes.POSTS_WRITE], {
+        content: z.string().describe('Post content (max 5000 chars). Can be empty if media_urls is provided.'),
+        content_format: z
+            .enum(['plain', 'markdown'])
+            .optional()
+            .describe('Content format (default: plain)'),
+        organization_id: z.string().optional().describe('Organization to post in. Defaults to RECURSIV_ORGANIZATION_ID env var if set.'),
+        community_id: z.string().optional().describe('Post to a specific community'),
+        reply_to_id: z.string().optional().describe('Reply to another post'),
+        media_urls: z
+            .array(z.string())
+            .optional()
+            .describe('Array of media URLs to attach. Use generate_image to create AI images first.'),
+    }, async (params) => {
+        const gate = await requireApproval('create_post', params, approvalConfig);
+        if (!gate.allowed)
+            return textResult(gate.message);
+        const result = await client.posts.create({
+            ...params,
+            organization_id: params.organization_id || defaultOrganizationId,
+        });
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('generate_image', '[RED — requires admin approval] Generate an AI image using DALL-E, Flux, or Nano Banana. Returns a URL that can be used with create_post media_urls parameter.', [Scopes.POSTS_WRITE], {
+        prompt: z.string().describe('Text description of the image to generate'),
+        provider: z
+            .enum(['dall-e', 'flux', 'nano-banana'])
+            .optional()
+            .describe('Image generation provider (auto-detected from available API keys if omitted)'),
+        size: z
+            .enum(['256x256', '512x512', '1024x1024', '1024x1792', '1792x1024'])
+            .optional()
+            .describe('Image dimensions (default: 1024x1024)'),
+        style: z
+            .enum(['natural', 'vivid'])
+            .optional()
+            .describe('Image style, DALL-E only (default: vivid)'),
+    }, async (params) => {
+        const gate = await requireApproval('generate_image', params, approvalConfig);
+        if (!gate.allowed)
+            return textResult(gate.message);
+        const result = await client.media.generateImage(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    registry.tool('send_message', '[RED — requires admin approval] Send a message in a conversation', [Scopes.CHAT_WRITE], {
+        conversation_id: z.string().describe('Conversation UUID'),
+        content: z.string().describe('Message content'),
+        reply_to_id: z.string().optional().describe('Reply to a specific message'),
+    }, async (params) => {
+        const gate = await requireApproval('send_message', params, approvalConfig);
+        if (!gate.allowed)
+            return textResult(gate.message);
+        const result = await client.chat.send(params);
+        return textResult(JSON.stringify(result, null, 2));
+    });
+    // ── Approval status check tool ────────────────────────────────────
+    registry.tool('check_approval_status', 'Check the status of a pending approval request by its ID', [Scopes.POSTS_READ], {
+        approval_id: z.string().describe('Approval request UUID'),
+    }, async ({ approval_id }) => {
+        try {
+            const result = await checkApprovalStatus(approval_id, approvalConfig);
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return textResult(`Error checking approval: ${msg}`);
+        }
+    });
+}
+//# sourceMappingURL=social.js.map

package/dist/tools/social.js.map

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

package/dist/tools/swarms.d.ts

@@ -0,0 +1,4 @@
+import type { Recursiv } from '@recursiv/sdk';
+import { type ScopedToolRegistry } from '../scopes.js';
+export declare function registerSwarmTools(registry: ScopedToolRegistry, client: Recursiv): void;
+//# sourceMappingURL=swarms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swarms.d.ts","sourceRoot":"","sources":["../../src/tools/swarms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAI/D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,QAiPhF"}

package/dist/tools/swarms.js

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+import { Scopes } from '../scopes.js';
+const defaultOrgId = process.env.RECURSIV_ORGANIZATION_ID;
+export function registerSwarmTools(registry, client) {
+    registry.tool('create_swarm', 'Create a new agent swarm — a coordination group with a goal, coordinator, and workers', [Scopes.AGENTS_WRITE], {
+        name: z.string().describe('Swarm name'),
+        coordinator_id: z.string().describe('UUID of the coordinator agent'),
+        goal: z.string().optional().describe('What the swarm should accomplish'),
+        project_id: z.string().optional().describe('Project UUID to scope the swarm'),
+        organization_id: z.string().optional().describe('Organization UUID (defaults to RECURSIV_ORGANIZATION_ID env var)'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.create({
+                ...params,
+                organization_id: params.organization_id || defaultOrgId,
+            });
+            const swarm = result.data;
+            return {
+                content: [{ type: 'text', text: `Swarm created: ${swarm.name}\nID: ${swarm.id}\nStatus: ${swarm.status}\nCoordinator: ${swarm.coordinatorId}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error creating swarm: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('get_swarm', 'Get swarm details including all members', [Scopes.AGENTS_READ], {
+        swarm_id: z.string().describe('Swarm UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.get(params.swarm_id);
+            return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error getting swarm: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('list_swarms', 'List swarms (optionally filtered by project or status)', [Scopes.AGENTS_READ], {
+        organization_id: z.string().optional().describe('Organization UUID (defaults to RECURSIV_ORGANIZATION_ID env var)'),
+        project_id: z.string().optional().describe('Filter by project UUID'),
+        status: z.string().optional().describe('Filter by status (draft, active, completed, cancelled)'),
+        limit: z.number().optional().describe('Max results'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.list({
+                ...params,
+                organization_id: params.organization_id || defaultOrgId,
+            });
+            const swarms = result.data;
+            if (swarms.length === 0) {
+                return { content: [{ type: 'text', text: 'No swarms found.' }] };
+            }
+            const text = swarms.map((s) => `[${s.status}] ${s.name} (${s.id}) — ${s.members?.length ?? 0} members${s.goal ? `\n  Goal: ${s.goal}` : ''}`).join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error listing swarms: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('add_swarm_member', 'Add an agent to a swarm as a worker or observer', [Scopes.AGENTS_WRITE], {
+        swarm_id: z.string().describe('Swarm UUID'),
+        agent_id: z.string().describe('Agent UUID to add'),
+        role: z.enum(['worker', 'observer']).optional().describe('Member role (default: worker)'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.addMember(params.swarm_id, {
+                agent_id: params.agent_id,
+                role: params.role,
+            });
+            return {
+                content: [{ type: 'text', text: `Added agent ${params.agent_id} to swarm as ${result.data.role}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error adding member: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('activate_swarm', 'Activate a swarm — sets it to active and notifies the coordinator agent', [Scopes.AGENTS_WRITE], {
+        swarm_id: z.string().describe('Swarm UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.activate(params.swarm_id);
+            return {
+                content: [{ type: 'text', text: `Swarm "${result.data.name}" is now active. Coordinator has been notified.` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error activating swarm: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('complete_swarm', 'Mark a swarm as completed with an optional summary', [Scopes.AGENTS_WRITE], {
+        swarm_id: z.string().describe('Swarm UUID'),
+        summary: z.string().optional().describe('Completion summary'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.complete(params.swarm_id, { summary: params.summary });
+            return {
+                content: [{ type: 'text', text: `Swarm "${result.data.name}" completed.` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error completing swarm: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('cancel_swarm', 'Cancel an active swarm', [Scopes.AGENTS_WRITE], {
+        swarm_id: z.string().describe('Swarm UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.cancel(params.swarm_id);
+            return {
+                content: [{ type: 'text', text: `Swarm "${result.data.name}" cancelled.` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error cancelling swarm: ${e.message}` }], isError: true };
+        }
+    });
+    // ── Scheduler tools ─────────────────────────────────────────────
+    registry.tool('schedule_agent_task', 'Schedule a task for an agent — one-shot or recurring', [Scopes.AGENTS_WRITE], {
+        agent_id: z.string().describe('Agent UUID'),
+        task_type: z.enum(['recurring', 'one_shot']).describe('Task type'),
+        message: z.string().optional().describe('Message to trigger the agent with (max 2000 chars)'),
+        action: z.enum(['post', 'reply', 'check_in']).optional().describe('Action type'),
+        channel_id: z.string().optional().describe('Target conversation UUID'),
+        delay_ms: z.number().optional().describe('Delay before first run (ms)'),
+        max_runs: z.number().optional().describe('Max number of runs (for recurring)'),
+        cron_expression: z.string().optional().describe('Cron expression for recurring tasks'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.scheduleTask({
+                agent_id: params.agent_id,
+                task_type: params.task_type,
+                payload: {
+                    message: params.message,
+                    channel_id: params.channel_id,
+                    action: params.action,
+                },
+                delay_ms: params.delay_ms,
+                max_runs: params.max_runs,
+                cron_expression: params.cron_expression,
+            });
+            const task = result.data;
+            return {
+                content: [{ type: 'text', text: `Scheduled task created.\nID: ${task.id}\nType: ${task.taskType}\nStatus: ${task.status}\nNext run: ${task.nextRunAt}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error scheduling task: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('list_agent_schedules', "List an agent's scheduled tasks", [Scopes.AGENTS_READ], {
+        agent_id: z.string().describe('Agent UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.listSchedules(params.agent_id);
+            const tasks = result.data;
+            if (tasks.length === 0) {
+                return { content: [{ type: 'text', text: 'No scheduled tasks found.' }] };
+            }
+            const text = tasks.map((t) => {
+                const payload = typeof t.payload === 'string' ? JSON.parse(t.payload) : t.payload;
+                return `[${t.status}] ${t.id} — ${t.taskType} (runs: ${t.runCount}/${t.maxRuns ?? 'inf'})\n  Next: ${t.nextRunAt ?? 'N/A'}\n  Action: ${payload.action ?? 'check_in'}`;
+            }).join('\n\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error listing schedules: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('cancel_agent_schedule', 'Cancel a scheduled task for an agent', [Scopes.AGENTS_WRITE], {
+        task_id: z.string().describe('Scheduled task UUID'),
+        agent_id: z.string().describe('Agent UUID that owns the task'),
+    }, async (params) => {
+        try {
+            const result = await client.swarms.cancelSchedule(params.task_id, params.agent_id);
+            return {
+                content: [{ type: 'text', text: `Schedule ${params.task_id} cancelled. Status: ${result.data.status}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error cancelling schedule: ${e.message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=swarms.js.map

package/dist/tools/swarms.js.map

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

package/dist/tools/templates.d.ts

@@ -0,0 +1,4 @@
+import type { Recursiv } from '@recursiv/sdk';
+import { type ScopedToolRegistry } from '../scopes.js';
+export declare function registerTemplateTools(registry: ScopedToolRegistry, client: Recursiv): void;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE/D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,QAuInF"}

package/dist/tools/templates.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { Scopes } from '../scopes.js';
+export function registerTemplateTools(registry, client) {
+    registry.tool('create_template', 'Create a new reusable infrastructure/workflow template', [Scopes.PROJECTS_WRITE], {
+        name: z.string().describe('Template name'),
+        description: z.string().optional().describe('Template description'),
+        tags: z.array(z.string()).optional().describe('Tags for categorization'),
+        infrastructure: z.record(z.string(), z.unknown()).optional().describe('Infrastructure manifest (JSON)'),
+        source_url: z.string().optional().describe('URL to source code or docs'),
+        author_agent_id: z.string().optional().describe('UUID of the authoring agent'),
+    }, async (params) => {
+        try {
+            const result = await client.templates.create(params);
+            const t = result.data;
+            return {
+                content: [{ type: 'text', text: `Template created: ${t.name}\nID: ${t.id}\nStatus: ${t.status}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error creating template: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('get_template', 'Get template details by ID', [Scopes.PROJECTS_READ], {
+        template_id: z.string().describe('Template UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.templates.get(params.template_id);
+            return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error getting template: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('list_templates', 'List templates (optionally filtered by status or search query)', [Scopes.PROJECTS_READ], {
+        status: z.string().optional().describe('Filter by status (draft, published, archived)'),
+        search: z.string().optional().describe('Search by name or description'),
+        limit: z.number().optional().describe('Max results'),
+    }, async (params) => {
+        try {
+            const result = await client.templates.list(params);
+            const templates = result.data;
+            if (templates.length === 0) {
+                return { content: [{ type: 'text', text: 'No templates found.' }] };
+            }
+            const text = templates.map((t) => `[${t.status}] ${t.name} (${t.id}) — ${t.forkCount} forks${t.description ? `\n  ${t.description.substring(0, 100)}` : ''}`).join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error listing templates: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('update_template', 'Update an existing template', [Scopes.PROJECTS_WRITE], {
+        template_id: z.string().describe('Template UUID'),
+        name: z.string().optional().describe('New name'),
+        description: z.string().optional().describe('New description'),
+        tags: z.array(z.string()).optional().describe('New tags'),
+        infrastructure: z.record(z.string(), z.unknown()).optional().describe('Updated infrastructure manifest'),
+        status: z.enum(['draft', 'published', 'archived']).optional().describe('New status'),
+    }, async (params) => {
+        try {
+            const { template_id, ...input } = params;
+            const result = await client.templates.update(template_id, input);
+            return {
+                content: [{ type: 'text', text: `Template "${result.data.name}" updated.` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error updating template: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('publish_template', 'Publish a draft template so others can discover and fork it', [Scopes.PROJECTS_WRITE], {
+        template_id: z.string().describe('Template UUID'),
+    }, async (params) => {
+        try {
+            const result = await client.templates.publish(params.template_id);
+            return {
+                content: [{ type: 'text', text: `Template "${result.data.name}" is now published.` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error publishing template: ${e.message}` }], isError: true };
+        }
+    });
+    registry.tool('fork_template', 'Fork a template — creates a copy you can customize', [Scopes.PROJECTS_WRITE], {
+        template_id: z.string().describe('Template UUID to fork'),
+        author_agent_id: z.string().optional().describe('UUID of the forking agent'),
+    }, async (params) => {
+        try {
+            const result = await client.templates.fork(params.template_id, {
+                author_agent_id: params.author_agent_id,
+            });
+            const t = result.data;
+            return {
+                content: [{ type: 'text', text: `Forked template: ${t.name}\nNew ID: ${t.id}\nParent: ${t.parentTemplateId}` }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error forking template: ${e.message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

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

package/dist/tools/utils.d.ts

@@ -0,0 +1,9 @@
+/** Format error with full context (message, code, details) so MCP callers see what actually broke. */
+export declare function fmtErr(prefix: string, e: any): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAK3G"}

package/dist/tools/utils.js

@@ -0,0 +1,8 @@
+/** Format error with full context (message, code, details) so MCP callers see what actually broke. */
+export function fmtErr(prefix, e) {
+    const msg = e.message || 'unknown error';
+    const code = e.code ? ` [${e.code}]` : '';
+    const detail = e.details ? ` — ${typeof e.details === 'string' ? e.details : JSON.stringify(e.details)}` : '';
+    return { content: [{ type: 'text', text: `${prefix}: ${msg}${code}${detail}` }], isError: true };
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,CAAM;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9G,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,GAAG,GAAG,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC5G,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@recursiv/mcp",
+  "version": "0.1.1",
+  "description": "MCP server for Recursiv — give AI assistants access to your projects, agents, and social infrastructure",
+  "license": "FSL-1.1-ALv2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "recursiv-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@recursiv/sdk": "workspace:*",
+    "dotenv": "^16.4.7",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.2",
+    "typescript": "~5.9.2",
+    "vitest": "^2.1.9"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/recursivlabs/recursiv.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/recursivlabs/recursiv/issues"
+  },
+  "homepage": "https://github.com/recursivlabs/recursiv/tree/main/packages/mcp#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}