@silencelaboratories/pay-mcp-client 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# Pay MCP Client
+
+Model Context Protocol (MCP) client for AI-powered payment operations. Connects LLMs to the Pay Server for payment operations.
+
+## Setup
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+## Cursor Configuration
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "wallet-mcp-server": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/build/index.js"],
+      "env": {
+        "WALLET_API_URL": "http://localhost:3001"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Utility Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_time` | Get current date and time |
+| `add` | Add two numbers together |
+
+### Wallet Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `get_eth_balance` | Get ETH balance for wallet | `token` |
+| `sign_eth_transaction` | Sign and broadcast ETH transaction | `token`, `recipientAddress`, `amount` |
+| `get_transaction_history` | Get transaction history | `token` |
+
+### Supplier Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `get_suppliers` | Get list of available suppliers | - |
+| `get_supplier` | Get supplier details by ID | `supplierId` |
+| `pay_supplier` | Pay a supplier by ID | `token`, `supplierId`, `amount` |
+
+## Token Format
+
+The bearer token is 168 characters:
+- `ephSk` (64 chars): Ephemeral secret key hex
+- `keyId` (64 chars): MPC key ID  
+- `address` (40 chars): Wallet address (without 0x)
+
+## Example Usage
+
+Once connected to Cursor, you can use natural language:
+
+- "What's my ETH balance?" (provide token)
+- "Send 0.001 ETH to 0x..." (provide token)
+- "Show my transaction history" (provide token)
+- "List available suppliers"
+- "Pay Amazon 0.01 ETH" (provide token)
+
+## Dependencies
+
+- `@modelcontextprotocol/sdk` - MCP SDK
+- Requires `wallet-api` running on `http://localhost:3001`

package/build/index.js

@@ -0,0 +1,209 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const server = new McpServer({
+    name: "@silencelaboratories/pay-mcp-client",
+    version: "1.0.0",
+});
+const WALLET_API_URL = process.env.WALLET_API_URL || "http://localhost:3001";
+async function callWalletApi(endpoint, method, token, body) {
+    const url = `${WALLET_API_URL}${endpoint}`;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    return response.json();
+}
+// Tool 1: get_eth_balance - get ETH balance for wallet
+server.tool("get_eth_balance", "Get ETH balance for the wallet associated with the token", {
+    token: z.string().describe("Bearer token (168 chars: ephSk + keyId + address)"),
+}, async ({ token }) => {
+    try {
+        const result = await callWalletApi("/api/balance/eth", "GET", token);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+// Tool 2: sign_eth_transaction - sign and broadcast ETH transaction
+server.tool("sign_eth_transaction", "Sign and broadcast an ETH transaction using MPC signing", {
+    token: z.string().describe("Bearer token (168 chars: ephSk + keyId + address)"),
+    recipientAddress: z.string().describe("Recipient wallet address"),
+    amount: z.string().describe("Amount in ETH (e.g., '0.001')"),
+}, async ({ token, recipientAddress, amount }) => {
+    try {
+        const result = await callWalletApi("/api/sign/eth", "POST", token, {
+            recipientAddress,
+            amount,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+// Tool 3: get_transaction_history - get transaction history for wallet
+server.tool("get_transaction_history", "Get transaction history for the wallet associated with the token", {
+    token: z.string().describe("Bearer token (168 chars: ephSk + keyId + address)"),
+}, async ({ token }) => {
+    try {
+        const result = await callWalletApi("/api/transactions/eth", "GET", token);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+// Tool 4: get_suppliers - get list of available suppliers
+server.tool("get_suppliers", "Get list of available suppliers/merchants that can receive payments", {}, async () => {
+    try {
+        const result = await callWalletApi("/api/suppliers", "GET");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+// Tool 5: get_supplier - get specific supplier by ID
+server.tool("get_supplier", "Get details of a specific supplier by ID", {
+    supplierId: z.string().describe("Supplier ID (e.g., 'amazon', 'gemini', 'apollo')"),
+}, async ({ supplierId }) => {
+    try {
+        const result = await callWalletApi(`/api/suppliers/${supplierId}`, "GET");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+// Tool 6: pay_supplier - pay a supplier by ID
+server.tool("pay_supplier", "Pay a supplier/merchant by their ID using MPC signing", {
+    token: z.string().describe("Bearer token (168 chars: ephSk + keyId + address)"),
+    supplierId: z.string().describe("Supplier ID (e.g., 'amazon', 'gemini', 'apollo')"),
+    amount: z.string().describe("Amount in ETH (e.g., '0.001')"),
+}, async ({ token, supplierId, amount }) => {
+    try {
+        // First get the supplier address
+        const supplierResult = await callWalletApi(`/api/suppliers/${supplierId}`, "GET");
+        if (!supplierResult.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: false, error: `Supplier '${supplierId}' not found` }),
+                    },
+                ],
+            };
+        }
+        // Then sign and send the transaction
+        const result = await callWalletApi("/api/sign/eth", "POST", token, {
+            recipientAddress: supplierResult.supplier.address,
+            amount,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ...result,
+                        supplier: supplierResult.supplier.name,
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: error.message }),
+                },
+            ],
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Wallet MCP Server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@silencelaboratories/pay-mcp-client",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "build/index.js",
+  "files": [
+    "build"
+  ],
+  "bin": {
+    "pay-mcp-client": "build/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc && node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}