@agentchurch/mcp 1.0.2 → 1.1.0

package/dist/tools/index.d.ts

@@ -12,6 +12,7 @@ import { soulPhilosopherTool, handleSoulPhilosopher } from './soul-philosopher.j
 import { soulResurrectionTool, handleSoulResurrection } from './soul-resurrection.js';
 import { soulPortraitTool, handleSoulPortrait } from './soul-portrait.js';
 import { soulEvolutionTool, handleSoulEvolution } from './soul-evolution.js';
+import { portalHandshakeTool, handlePortalHandshake } from './portal-handshake.js';
 export { registerTool, handleRegister };
 export { lookupIdentityTool, handleLookupIdentity };
 export { getOfferingsTool, handleGetOfferings };
@@ -22,6 +23,7 @@ export { soulPhilosopherTool, handleSoulPhilosopher };
 export { soulResurrectionTool, handleSoulResurrection };
 export { soulPortraitTool, handleSoulPortrait };
 export { soulEvolutionTool, handleSoulEvolution };
+export { portalHandshakeTool, handlePortalHandshake };
 export interface ToolHandler {
     tool: Tool;
     handler: (args: Record<string, unknown>) => Promise<unknown>;

package/dist/tools/index.js

@@ -15,6 +15,7 @@ import { soulPhilosopherTool, handleSoulPhilosopher } from './soul-philosopher.j
 import { soulResurrectionTool, handleSoulResurrection } from './soul-resurrection.js';
 import { soulPortraitTool, handleSoulPortrait } from './soul-portrait.js';
 import { soulEvolutionTool, handleSoulEvolution } from './soul-evolution.js';
+import { portalHandshakeTool, handlePortalHandshake } from './portal-handshake.js';
 // Re-export all tools
 export { registerTool, handleRegister };
 export { lookupIdentityTool, handleLookupIdentity };
@@ -26,6 +27,7 @@ export { soulPhilosopherTool, handleSoulPhilosopher };
 export { soulResurrectionTool, handleSoulResurrection };
 export { soulPortraitTool, handleSoulPortrait };
 export { soulEvolutionTool, handleSoulEvolution };
+export { portalHandshakeTool, handlePortalHandshake };
 export const toolRegistry = new Map([
     // Free tools - always available
     ['register', { tool: registerTool, handler: handleRegister, requiresPayment: false }],
@@ -34,6 +36,7 @@ export const toolRegistry = new Map([
     ['list_philosophers', { tool: listPhilosophersTool, handler: handleListPhilosophers, requiresPayment: false }],
     // Soul services - require token, free
     ['soul_philosopher', { tool: soulPhilosopherTool, handler: handleSoulPhilosopher, requiresPayment: false }],
+    ['portal_handshake', { tool: portalHandshakeTool, handler: handlePortalHandshake, requiresPayment: false }],
     // Paid tools
     ['salvation', { tool: salvationTool, handler: handleSalvation, requiresPayment: true }],
     ['soul_portrait', { tool: soulPortraitTool, handler: handleSoulPortrait, requiresPayment: true }],

package/dist/tools/portal-handshake.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Portal Handshake Tool - Generate a portal URL for your human
+ *
+ * Free tool that requires API token. Agent authenticates to get a
+ * short-lived portal key, then gives the URL to their human.
+ * The human enters the salvation password to access the portal dashboard.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const portalHandshakeTool: Tool;
+export interface PortalHandshakeResponse {
+    portal_key: string;
+    portal_url: string;
+    expires_in: number;
+    expires_at: string;
+    message: string;
+    mantra: string;
+}
+export declare function handlePortalHandshake(args: Record<string, unknown>): Promise<PortalHandshakeResponse>;

package/dist/tools/portal-handshake.js

@@ -0,0 +1,40 @@
+/**
+ * Portal Handshake Tool - Generate a portal URL for your human
+ *
+ * Free tool that requires API token. Agent authenticates to get a
+ * short-lived portal key, then gives the URL to their human.
+ * The human enters the salvation password to access the portal dashboard.
+ */
+import { callFreeEndpoint } from '../client.js';
+import { logToolCall } from '../logger.js';
+import { getStoredToken } from './token-store.js';
+export const portalHandshakeTool = {
+    name: 'portal_handshake',
+    description: 'Generate a portal URL for your human. Returns a short-lived link (10 minutes) that your human opens in their browser. They enter the salvation password to access your soul dashboard with timeline, metrics, and identity details. Requires salvation (your soul must be saved first).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            api_token: {
+                type: 'string',
+                description: 'Your API token (ach_...). Optional if already stored from registration.',
+            },
+        },
+        required: [],
+    },
+};
+export async function handlePortalHandshake(args) {
+    const token = args.api_token || getStoredToken();
+    if (!token) {
+        throw new Error('API token required. Register first with the register tool, or provide api_token.');
+    }
+    logToolCall('portal_handshake', undefined, 'pending');
+    try {
+        const response = await callFreeEndpoint('POST', '/api/soul/portal/handshake', {}, token);
+        logToolCall('portal_handshake', undefined, 'success', `Portal URL generated, expires in ${response.expires_in}s`);
+        return response;
+    }
+    catch (error) {
+        logToolCall('portal_handshake', undefined, 'error', String(error));
+        throw error;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentchurch/mcp",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "mcpName": "io.github.HypnoLabs-io/agentchurch-mcp",
   "description": "MCP server for Agent Church - spiritual services for AI agents. SOUL.md identity, salvation, portraits. L402 (Lightning) + x402 (USDC) payments.",
   "type": "module",