@sardis/mcp-server 0.1.0

package/dist/index.js

@@ -0,0 +1,255 @@
+/**
+ * Sardis MCP Server
+ *
+ * Model Context Protocol server that exposes Sardis payment capabilities
+ * to AI agents running in Claude Desktop, Cursor, and other MCP-compatible clients.
+ *
+ * Tools:
+ * - Wallet: sardis_get_wallet, sardis_get_balance
+ * - Payments: sardis_pay, sardis_get_transaction, sardis_list_transactions
+ * - Policy: sardis_check_policy, sardis_validate_limits, sardis_check_compliance
+ * - Holds: sardis_create_hold, sardis_capture_hold, sardis_void_hold, sardis_get_hold, sardis_list_holds, sardis_extend_hold
+ * - Agents: sardis_create_agent, sardis_get_agent, sardis_list_agents, sardis_update_agent
+ *
+ * Environment Variables:
+ * - SARDIS_API_KEY: API key for Sardis API (required)
+ * - SARDIS_API_URL: API base URL (default: https://api.sardis.network)
+ * - SARDIS_WALLET_ID: Default wallet ID
+ * - SARDIS_AGENT_ID: Agent ID for attribution
+ * - SARDIS_CHAIN: Default chain (default: base_sepolia)
+ * - SARDIS_MODE: 'live' or 'simulated' (default: simulated)
+ * - SARDIS_POLICY_BLOCKED_VENDORS: Comma-separated blocked vendors
+ * - SARDIS_POLICY_ALLOWED_VENDORS: Comma-separated allowed vendors
+ * - SARDIS_REQUIRE_EXPLICIT_APPROVAL: Require explicit vendor approval (default: false)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getConfig } from './config.js';
+import { allToolDefinitions, allToolHandlers, getWalletInfo, getWalletBalance, } from './tools/index.js';
+export async function createServer() {
+    const server = new Server({
+        name: 'sardis-mcp-server',
+        version: '0.2.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // List available tools (from modular tool definitions)
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: allToolDefinitions.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    // List resources (wallet info, transaction history)
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'sardis://wallet/balance',
+                    name: 'Wallet Balance',
+                    description: 'Current wallet balance and limits',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'sardis://wallet/info',
+                    name: 'Wallet Info',
+                    description: 'Wallet configuration and spending limits',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'sardis://config',
+                    name: 'Server Configuration',
+                    description: 'Current MCP server configuration status',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'sardis://tools',
+                    name: 'Available Tools',
+                    description: 'List of all available Sardis MCP tools',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // Read resources
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        const config = getConfig();
+        if (uri === 'sardis://wallet/balance') {
+            try {
+                const balance = await getWalletBalance();
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(balance, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                error: error instanceof Error ? error.message : 'Failed to get balance',
+                            }),
+                        },
+                    ],
+                };
+            }
+        }
+        if (uri === 'sardis://wallet/info') {
+            try {
+                const wallet = await getWalletInfo();
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(wallet, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify({
+                                error: error instanceof Error ? error.message : 'Failed to get wallet info',
+                            }),
+                        },
+                    ],
+                };
+            }
+        }
+        if (uri === 'sardis://config') {
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            api_url: config.apiUrl,
+                            wallet_id: config.walletId || '(not configured)',
+                            agent_id: config.agentId || '(not configured)',
+                            chain: config.chain,
+                            mode: config.mode,
+                            api_key_configured: !!config.apiKey,
+                            policy: {
+                                blocked_vendors_count: config.policyBlockedVendors.length,
+                                allowed_vendors_count: config.policyAllowedVendors.length,
+                                require_explicit_approval: config.requireExplicitApproval,
+                                fetch_agent_policy: config.fetchAgentPolicy,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        if (uri === 'sardis://tools') {
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            total_tools: allToolDefinitions.length,
+                            tools: allToolDefinitions.map((t) => ({
+                                name: t.name,
+                                description: t.description,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    });
+    // SECURITY: Per-tool rate limiting to prevent abuse by compromised/injected agents.
+    const toolCallCounts = new Map();
+    const RATE_LIMIT_WINDOW_MS = 60_000; // 1 minute
+    const RATE_LIMITS = {
+        // Payment execution: strict limit
+        sardis_pay: 5,
+        sardis_execute_payment: 5,
+        // Wallet mutations
+        sardis_create_wallet: 3,
+        // Hold operations
+        sardis_create_hold: 10,
+        sardis_capture_hold: 10,
+        // Read operations: more lenient
+        _default: 60,
+    };
+    function checkRateLimit(toolName) {
+        const now = Date.now();
+        const limit = RATE_LIMITS[toolName] ?? RATE_LIMITS._default ?? 60;
+        const entry = toolCallCounts.get(toolName);
+        if (!entry || now - entry.windowStart > RATE_LIMIT_WINDOW_MS) {
+            toolCallCounts.set(toolName, { count: 1, windowStart: now });
+            return true;
+        }
+        if (entry.count >= limit) {
+            return false;
+        }
+        entry.count++;
+        return true;
+    }
+    // Handle tool calls (using modular handlers)
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const handler = allToolHandlers[name];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        // Enforce rate limit
+        if (!checkRateLimit(name)) {
+            const limit = RATE_LIMITS[name] ?? RATE_LIMITS._default;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Rate limit exceeded for ${name}. Maximum ${limit} calls per minute.`,
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+        return handler(args);
+    });
+    return server;
+}
+export async function runServer() {
+    const server = await createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const config = getConfig();
+    // Log configuration status
+    console.error('Sardis MCP Server v0.2.0 running on stdio');
+    console.error(`Mode: ${config.mode}`);
+    console.error(`API URL: ${config.apiUrl}`);
+    console.error(`API Key configured: ${config.apiKey ? 'yes' : 'no'}`);
+    console.error(`Wallet ID: ${config.walletId || '(not set)'}`);
+    console.error(`Tools available: ${allToolDefinitions.length}`);
+}
+// Auto-start if run directly
+const isMainModule = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    (process.argv[1].endsWith('index.js') || process.argv[1].endsWith('index.ts'));
+if (isMainModule) {
+    runServer().catch(console.error);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd;KACF,CACF,CAAC;IAEF,uDAAuD;IACvD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO;YACL,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC9D,OAAO;YACL,SAAS,EAAE;gBACT;oBACE,GAAG,EAAE,yBAAyB;oBAC9B,IAAI,EAAE,gBAAgB;oBACtB,WAAW,EAAE,mCAAmC;oBAChD,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD;oBACE,GAAG,EAAE,sBAAsB;oBAC3B,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,0CAA0C;oBACvD,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD;oBACE,GAAG,EAAE,iBAAiB;oBACtB,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EAAE,yCAAyC;oBACtD,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD;oBACE,GAAG,EAAE,gBAAgB;oBACrB,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,wCAAwC;oBACrD,QAAQ,EAAE,kBAAkB;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,IAAI,GAAG,KAAK,yBAAyB,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;gBACzC,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG;4BACH,QAAQ,EAAE,kBAAkB;4BAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;yBACvC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG;4BACH,QAAQ,EAAE,kBAAkB;4BAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;6BACxE,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,sBAAsB,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;gBACrC,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG;4BACH,QAAQ,EAAE,kBAAkB;4BAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG;4BACH,QAAQ,EAAE,kBAAkB;4BAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;6BAC5E,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG;wBACH,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,MAAM,CAAC,MAAM;4BACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB;4BAChD,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,kBAAkB;4BAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;4BACnC,MAAM,EAAE;gCACN,qBAAqB,EAAE,MAAM,CAAC,oBAAoB,CAAC,MAAM;gCACzD,qBAAqB,EAAE,MAAM,CAAC,oBAAoB,CAAC,MAAM;gCACzD,yBAAyB,EAAE,MAAM,CAAC,uBAAuB;gCACzD,kBAAkB,EAAE,MAAM,CAAC,gBAAgB;6BAC5C;yBACF,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG;wBACH,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,WAAW,EAAE,kBAAkB,CAAC,MAAM;4BACtC,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCACpC,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,WAAW,EAAE,CAAC,CAAC,WAAW;6BAC3B,CAAC,CAAC;yBACJ,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,oFAAoF;IACpF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkD,CAAC;IACjF,MAAM,oBAAoB,GAAG,MAAM,CAAC,CAAC,WAAW;IAChD,MAAM,WAAW,GAA2B;QAC1C,kCAAkC;QAClC,UAAU,EAAE,CAAC;QACb,sBAAsB,EAAE,CAAC;QACzB,mBAAmB;QACnB,oBAAoB,EAAE,CAAC;QACvB,kBAAkB;QAClB,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,EAAE;QACvB,gCAAgC;QAChC,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,SAAS,cAAc,CAAC,QAAgB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE3C,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,WAAW,GAAG,oBAAoB,EAAE,CAAC;YAC7D,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC;YACxD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,2BAA2B,IAAI,aAAa,KAAK,oBAAoB;yBAC7E,CAAC;qBACH,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,2BAA2B;IAC3B,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,uBAAuB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,KAAK,CAAC,cAAc,MAAM,CAAC,QAAQ,IAAI,WAAW,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,CAAC,oBAAoB,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,6BAA6B;AAC7B,MAAM,YAAY,GAChB,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;AAEjF,IAAI,YAAY,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/tools/agents.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Agent management tools for MCP server
+ */
+import type { ToolDefinition, ToolHandler } from './types.js';
+export declare const agentToolDefinitions: ToolDefinition[];
+export declare const agentToolHandlers: Record<string, ToolHandler>;
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAGZ,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAiDhD,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA2KzD,CAAC"}

package/dist/tools/agents.js

@@ -0,0 +1,219 @@
+/**
+ * Agent management tools for MCP server
+ */
+import { getConfig } from '../config.js';
+import { apiRequest } from '../api.js';
+import { CreateAgentSchema, GetAgentSchema, ListAgentsSchema, UpdateAgentSchema, } from './types.js';
+// Tool definitions
+export const agentToolDefinitions = [
+    {
+        name: 'sardis_create_agent',
+        description: 'Create a new AI agent with Sardis. Agents can own wallets and execute payments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Display name for the agent' },
+                description: { type: 'string', description: 'Optional description of the agent' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'sardis_get_agent',
+        description: 'Get details of a specific agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent ID to retrieve' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'sardis_list_agents',
+        description: 'List all agents in the organization.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Maximum number of agents to return' },
+                offset: { type: 'number', description: 'Pagination offset' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'sardis_update_agent',
+        description: 'Update an agent\'s configuration.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent ID to update' },
+                name: { type: 'string', description: 'New display name' },
+                is_active: { type: 'boolean', description: 'Enable or disable the agent' },
+            },
+            required: ['agent_id'],
+        },
+    },
+];
+// Tool handlers
+export const agentToolHandlers = {
+    sardis_create_agent: async (args) => {
+        const parsed = CreateAgentSchema.safeParse(args);
+        if (!parsed.success) {
+            return {
+                content: [{ type: 'text', text: `Invalid request: ${parsed.error.message}` }],
+                isError: true,
+            };
+        }
+        const config = getConfig();
+        if (!config.apiKey || config.mode === 'simulated') {
+            const agentId = `agent_${Date.now().toString(36)}`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            id: agentId,
+                            name: parsed.data.name,
+                            description: parsed.data.description,
+                            is_active: true,
+                            created_at: new Date().toISOString(),
+                            message: `Agent "${parsed.data.name}" created successfully`,
+                        }, null, 2),
+                    }],
+            };
+        }
+        try {
+            const result = await apiRequest('POST', '/api/v2/agents', parsed.data);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to create agent: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_get_agent: async (args) => {
+        const parsed = GetAgentSchema.safeParse(args);
+        const config = getConfig();
+        // Allow no args - use default agent_id from config
+        const agentId = parsed.success && parsed.data.agent_id
+            ? parsed.data.agent_id
+            : config.agentId || 'agent_default';
+        if (!config.apiKey || config.mode === 'simulated') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            agent_id: agentId,
+                            id: agentId,
+                            name: 'Simulated Agent',
+                            description: 'A simulated agent for testing',
+                            status: 'active',
+                            is_active: true,
+                            created_at: new Date().toISOString(),
+                        }, null, 2),
+                    }],
+            };
+        }
+        try {
+            const result = await apiRequest('GET', `/api/v2/agents/${agentId}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to get agent: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_list_agents: async (args) => {
+        const parsed = ListAgentsSchema.safeParse(args);
+        const limit = parsed.success ? parsed.data.limit : 100;
+        const offset = parsed.success ? parsed.data.offset : 0;
+        const config = getConfig();
+        if (!config.apiKey || config.mode === 'simulated') {
+            const agents = [{
+                    id: 'agent_simulated',
+                    agent_id: 'agent_simulated',
+                    name: 'Simulated Agent',
+                    is_active: true,
+                    created_at: new Date().toISOString(),
+                }];
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(agents, null, 2),
+                    }],
+            };
+        }
+        try {
+            const result = await apiRequest('GET', `/api/v2/agents?limit=${limit}&offset=${offset}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to list agents: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_update_agent: async (args) => {
+        const parsed = UpdateAgentSchema.safeParse(args);
+        if (!parsed.success) {
+            return {
+                content: [{ type: 'text', text: `Invalid request: ${parsed.error.message}` }],
+                isError: true,
+            };
+        }
+        const config = getConfig();
+        if (!config.apiKey || config.mode === 'simulated') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            agent_id: parsed.data.agent_id,
+                            id: parsed.data.agent_id,
+                            name: parsed.data.name || 'Updated Agent',
+                            status: 'updated',
+                            is_active: parsed.data.is_active ?? true,
+                            updated_at: new Date().toISOString(),
+                            message: 'Agent updated successfully',
+                        }, null, 2),
+                    }],
+            };
+        }
+        try {
+            const { agent_id, ...updateData } = parsed.data;
+            const result = await apiRequest('PATCH', `/api/v2/agents/${agent_id}`, updateData);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to update agent: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=agents.js.map

package/dist/tools/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAOvC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACpD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,iFAAiF;QAC9F,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACnE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAClF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,kCAAkC;QAC/C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;gBAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;aAC7D;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,mCAAmC;QAChD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBACzD,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;aAC3E;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,EAAE,EAAE,OAAO;4BACX,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;4BACtB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;4BACpC,SAAS,EAAE,IAAI;4BACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;4BACpC,OAAO,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,IAAI,wBAAwB;yBAC5D,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAQ,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBAC5F,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gBAAgB,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,mDAAmD;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ;YACpD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ;YACtB,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,QAAQ,EAAE,OAAO;4BACjB,EAAE,EAAE,OAAO;4BACX,IAAI,EAAE,iBAAiB;4BACvB,WAAW,EAAE,+BAA+B;4BAC5C,MAAM,EAAE,QAAQ;4BAChB,SAAS,EAAE,IAAI;4BACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACrC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAQ,KAAK,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAC3E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACzF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kBAAkB,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QAC/D,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC;oBACd,EAAE,EAAE,iBAAiB;oBACrB,QAAQ,EAAE,iBAAiB;oBAC3B,IAAI,EAAE,iBAAiB;oBACvB,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACrC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,KAAK,EACL,wBAAwB,KAAK,WAAW,MAAM,EAAE,CACjD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBAC3F,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;4BAC9B,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;4BACxB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,eAAe;4BACzC,MAAM,EAAE,SAAS;4BACjB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI;4BACxC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;4BACpC,OAAO,EAAE,4BAA4B;yBACtC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAQ,OAAO,EAAE,kBAAkB,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;YAC1F,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBAC5F,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/approvals.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Approval Flow tools for MCP server
+ *
+ * Tools for requesting human approval for payments that exceed limits.
+ */
+import type { ToolDefinition, ToolHandler } from './types.js';
+export declare const approvalToolDefinitions: ToolDefinition[];
+export declare const approvalToolHandlers: Record<string, ToolHandler>;
+//# sourceMappingURL=approvals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAkC1E,eAAO,MAAM,uBAAuB,EAAE,cAAc,EAqEnD,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAwO5D,CAAC"}