@caypo/canton-mcp 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/tools/index.ts","../src/tools/balance.ts","../src/tools/checking.ts","../src/tools/mpp.ts","../src/tools/safeguards.ts","../src/tools/traffic.ts","../src/tools/stubs.ts","../src/prompts/index.ts"],"sourcesContent":["/**\n * @caypo/canton-mcp — MCP server for Canton Network agent.\n * 33 tools + 20 prompts for AI agent integration.\n *\n * Transport: stdio (standard for Claude Desktop MCP servers)\n */\n\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { CantonAgent } from \"@caypo/canton-sdk\";\nimport { registerTools } from \"./tools/index.js\";\nimport { registerPrompts } from \"./prompts/index.js\";\n\nexport const CANTON_MCP_VERSION = \"0.1.0\";\n\nasync function main() {\n  // 1. Create agent\n  const agent = await CantonAgent.create({\n    token: process.env.CANTON_JWT ?? \"\",\n  });\n\n  // 2. Create MCP server\n  const server = new Server(\n    { name: \"caypo\", version: CANTON_MCP_VERSION },\n    { capabilities: { tools: {}, prompts: {} } },\n  );\n\n  // 3. Register tools and prompts\n  registerTools(server, agent);\n  registerPrompts(server);\n\n  // 4. Connect via stdio\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err) => {\n  console.error(\"MCP server failed to start:\", err);\n  process.exit(1);\n});\n","/**\n * Register all 33 tools on the MCP server.\n */\n\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport { balanceTools } from \"./balance.js\";\nimport { checkingTools } from \"./checking.js\";\nimport { mppTools } from \"./mpp.js\";\nimport { safeguardTools } from \"./safeguards.js\";\nimport { trafficTools } from \"./traffic.js\";\nimport { stubTools } from \"./stubs.js\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function registerTools(server: Server, agent: CantonAgent): void {\n  const allTools: ToolDef[] = [\n    ...balanceTools(agent),\n    ...checkingTools(agent),\n    ...mppTools(agent),\n    ...safeguardTools(agent),\n    ...trafficTools(agent),\n    ...stubTools(),\n  ];\n\n  const toolMap = new Map<string, ToolDef>();\n  for (const tool of allTools) {\n    toolMap.set(tool.name, tool);\n  }\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: allTools.map((t) => ({\n      name: t.name,\n      description: t.description,\n      inputSchema: t.inputSchema,\n    })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const tool = toolMap.get(request.params.name);\n    if (!tool) {\n      return {\n        content: [{ type: \"text\", text: `Unknown tool: ${request.params.name}` }],\n        isError: true,\n      };\n    }\n\n    try {\n      return await tool.handler((request.params.arguments ?? {}) as Record<string, unknown>);\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `Error: ${(err as Error).message}` }],\n        isError: true,\n      };\n    }\n  });\n}\n","/**\n * Balance & Info tools (5): caypo_balance, caypo_address, caypo_history, caypo_positions, caypo_rates\n */\n\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function balanceTools(agent: CantonAgent): ToolDef[] {\n  return [\n    {\n      name: \"caypo_balance\",\n      description: \"Get USDCx checking account balance and holding count\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => {\n        const bal = await agent.checking.balance();\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({\n                available: bal.available,\n                holdingCount: bal.holdingCount,\n                currency: \"USDCx\",\n                network: agent.wallet.network,\n              }, null, 2),\n            },\n          ],\n        };\n      },\n    },\n    {\n      name: \"caypo_address\",\n      description: \"Get Canton party ID (address) and network info\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => ({\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify({\n              partyId: agent.wallet.address,\n              network: agent.wallet.network,\n              format: \"<DisplayName>::<hex-fingerprint>\",\n            }, null, 2),\n          },\n        ],\n      }),\n    },\n    {\n      name: \"caypo_history\",\n      description: \"Get recent transaction history\",\n      inputSchema: {\n        type: \"object\",\n        properties: { limit: { type: \"number\", description: \"Max transactions to return\", default: 20 } },\n      },\n      handler: async (args) => {\n        const history = await agent.checking.history({ limit: (args as { limit?: number }).limit });\n        return {\n          content: [{ type: \"text\", text: JSON.stringify(history, null, 2) }],\n        };\n      },\n    },\n    {\n      name: \"caypo_positions\",\n      description: \"View DeFi positions (Coming in Phase 3)\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => ({\n        content: [{ type: \"text\", text: \"DeFi positions are not yet available. Coming in Phase 3 when Canton DeFi protocols launch.\" }],\n      }),\n    },\n    {\n      name: \"caypo_rates\",\n      description: \"Get exchange rates and APYs (Coming in Phase 3)\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => ({\n        content: [{ type: \"text\", text: \"Exchange rates and APYs are not yet available. Coming in Phase 3.\" }],\n      }),\n    },\n  ];\n}\n","/**\n * Checking tools (3): caypo_send, caypo_receive, caypo_contacts\n */\n\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function checkingTools(agent: CantonAgent): ToolDef[] {\n  return [\n    {\n      name: \"caypo_send\",\n      description: \"Send USDCx to a recipient via TransferFactory_Transfer. Checks safeguards before sending.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          recipient: { type: \"string\", description: \"Recipient Canton party ID\" },\n          amount: { type: \"string\", description: \"Amount of USDCx to send (string, e.g. '1.50')\" },\n          memo: { type: \"string\", description: \"Optional memo\" },\n        },\n        required: [\"recipient\", \"amount\"],\n      },\n      handler: async (args) => {\n        const { recipient, amount, memo } = args as { recipient: string; amount: string; memo?: string };\n        const result = await agent.checking.send(recipient, amount, { memo });\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({\n                status: \"success\",\n                amount,\n                recipient,\n                updateId: result.updateId,\n                completionOffset: result.completionOffset,\n                commandId: result.commandId,\n              }, null, 2),\n            },\n          ],\n        };\n      },\n    },\n    {\n      name: \"caypo_receive\",\n      description: \"Show party ID and deposit instructions for receiving USDCx\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => ({\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify({\n              partyId: agent.wallet.address,\n              network: agent.wallet.network,\n              instructions: \"Send USDCx to this party ID. The sender needs a TransferPreapproval or must use a 2-step TransferInstruction.\",\n            }, null, 2),\n          },\n        ],\n      }),\n    },\n    {\n      name: \"caypo_contacts\",\n      description: \"Manage contact list — list, add, or remove contacts\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          action: { type: \"string\", enum: [\"list\", \"add\", \"remove\"], default: \"list\" },\n          name: { type: \"string\", description: \"Contact name\" },\n          partyId: { type: \"string\", description: \"Contact party ID\" },\n        },\n      },\n      handler: async () => ({\n        content: [{ type: \"text\", text: \"Contact management coming soon. Use party IDs directly for now.\" }],\n      }),\n    },\n  ];\n}\n","/**\n * MPP Payment tools (3): caypo_pay, caypo_pay_status, caypo_services\n */\n\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function mppTools(agent: CantonAgent): ToolDef[] {\n  return [\n    {\n      name: \"caypo_pay\",\n      description: \"Pay for an API call via MPP (HTTP 402 auto-handling). Fetches URL, handles payment if 402, returns response.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          url: { type: \"string\", description: \"URL to fetch\" },\n          method: { type: \"string\", description: \"HTTP method\", default: \"GET\" },\n          body: { type: \"string\", description: \"Request body (JSON string)\" },\n          maxPrice: { type: \"string\", description: \"Maximum price willing to pay in USDCx\" },\n        },\n        required: [\"url\"],\n      },\n      handler: async (args) => {\n        const { url, method, body, maxPrice } = args as {\n          url: string; method?: string; body?: string; maxPrice?: string;\n        };\n        const result = await agent.mpp.pay(url, {\n          method,\n          body,\n          maxPrice,\n          headers: body ? { \"Content-Type\": \"application/json\" } : undefined,\n        });\n        const responseBody = await result.response.text();\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({\n                status: result.response.status,\n                paid: result.paid,\n                receipt: result.receipt,\n                body: responseBody.slice(0, 2000),\n              }, null, 2),\n            },\n          ],\n        };\n      },\n    },\n    {\n      name: \"caypo_pay_status\",\n      description: \"Check payment status by Canton update ID\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          updateId: { type: \"string\", description: \"Canton transaction update ID\" },\n        },\n        required: [\"updateId\"],\n      },\n      handler: async () => ({\n        content: [{ type: \"text\", text: \"Payment status lookup requires gateway integration. Use the updateId with the Canton Ledger API directly.\" }],\n      }),\n    },\n    {\n      name: \"caypo_services\",\n      description: \"List available MPP gateway services and pricing\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => ({\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify({\n              gateway: \"mpp.cayvox.io\",\n              services: [\n                { name: \"OpenAI\", path: \"/openai\", price: \"$0.001-$0.05\" },\n                { name: \"Anthropic\", path: \"/anthropic\", price: \"$0.01\" },\n                { name: \"fal.ai\", path: \"/fal\", price: \"$0.01-$0.10\" },\n                { name: \"Firecrawl\", path: \"/firecrawl\", price: \"$0.005-$0.02\" },\n                { name: \"Google Gemini\", path: \"/gemini\", price: \"$0.005-$0.02\" },\n                { name: \"Groq\", path: \"/groq\", price: \"$0.001-$0.005\" },\n                { name: \"Perplexity\", path: \"/perplexity\", price: \"$0.01\" },\n                { name: \"Brave Search\", path: \"/brave\", price: \"$0.001-$0.005\" },\n                { name: \"DeepSeek\", path: \"/deepseek\", price: \"$0.005\" },\n                { name: \"Resend\", path: \"/resend\", price: \"$0.005\" },\n                { name: \"Together AI\", path: \"/together\", price: \"$0.001-$0.02\" },\n                { name: \"ElevenLabs\", path: \"/elevenlabs\", price: \"$0.02-$0.05\" },\n                { name: \"OpenWeather\", path: \"/openweather\", price: \"$0.001\" },\n                { name: \"Google Maps\", path: \"/googlemaps\", price: \"$0.005\" },\n                { name: \"Judge0\", path: \"/judge0\", price: \"$0.002\" },\n                { name: \"Reloadly\", path: \"/reloadly\", price: \"$0.01+\" },\n                { name: \"Lob\", path: \"/lob\", price: \"$0.01-$0.50\" },\n              ],\n            }, null, 2),\n          },\n        ],\n      }),\n    },\n  ];\n}\n","/**\n * Safeguard tools (3): caypo_safeguards, caypo_set_limit, caypo_lock\n */\n\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function safeguardTools(agent: CantonAgent): ToolDef[] {\n  return [\n    {\n      name: \"caypo_safeguards\",\n      description: \"View current safeguard settings: tx limit, daily limit, lock status, daily spending\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => {\n        const s = agent.safeguards.settings();\n        return {\n          content: [{ type: \"text\", text: JSON.stringify(s, null, 2) }],\n        };\n      },\n    },\n    {\n      name: \"caypo_set_limit\",\n      description: \"Set per-transaction or daily spending limit\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          type: { type: \"string\", enum: [\"tx\", \"daily\"], description: \"Limit type\" },\n          amount: { type: \"string\", description: \"Limit amount in USDCx\" },\n        },\n        required: [\"type\", \"amount\"],\n      },\n      handler: async (args) => {\n        const { type, amount } = args as { type: \"tx\" | \"daily\"; amount: string };\n        if (type === \"tx\") {\n          agent.safeguards.setTxLimit(amount);\n        } else {\n          agent.safeguards.setDailyLimit(amount);\n        }\n        return {\n          content: [{ type: \"text\", text: `${type === \"tx\" ? \"Per-transaction\" : \"Daily\"} limit set to ${amount} USDCx` }],\n        };\n      },\n    },\n    {\n      name: \"caypo_lock\",\n      description: \"Lock or unlock the wallet. When locked, all transactions are rejected.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          action: { type: \"string\", enum: [\"lock\", \"unlock\"], description: \"Action to perform\" },\n          pin: { type: \"string\", description: \"PIN for lock/unlock\" },\n        },\n        required: [\"action\"],\n      },\n      handler: async (args) => {\n        const { action, pin } = args as { action: \"lock\" | \"unlock\"; pin?: string };\n        if (action === \"lock\") {\n          agent.safeguards.lock(pin);\n          return { content: [{ type: \"text\", text: \"Wallet locked. All transactions will be rejected until unlocked.\" }] };\n        } else {\n          agent.safeguards.unlock(pin ?? \"\");\n          return { content: [{ type: \"text\", text: \"Wallet unlocked.\" }] };\n        }\n      },\n    },\n  ];\n}\n","/**\n * Traffic tools (2): caypo_traffic, caypo_purchase_traffic\n */\n\nimport type { CantonAgent } from \"@caypo/canton-sdk\";\nimport type { ToolDef } from \"./types.js\";\n\nexport function trafficTools(agent: CantonAgent): ToolDef[] {\n  return [\n    {\n      name: \"caypo_traffic\",\n      description: \"Check validator traffic balance. Canton uses traffic budgets, not gas fees.\",\n      inputSchema: { type: \"object\", properties: {}, required: [] },\n      handler: async () => {\n        const bal = await agent.traffic.trafficBalance();\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({\n                ...bal,\n                note: \"Canton uses traffic budgets per validator, not per-transaction gas fees.\",\n              }, null, 2),\n            },\n          ],\n        };\n      },\n    },\n    {\n      name: \"caypo_purchase_traffic\",\n      description: \"Purchase additional traffic by burning Canton Coin (CC). Coming soon.\",\n      inputSchema: {\n        type: \"object\",\n        properties: {\n          ccAmount: { type: \"string\", description: \"Amount of CC to burn\" },\n        },\n        required: [\"ccAmount\"],\n      },\n      handler: async () => ({\n        content: [{ type: \"text\", text: \"Traffic purchase is not yet implemented. Requires validator admin API access.\" }],\n      }),\n    },\n  ];\n}\n","/**\n * Stub tools for Phase 3/4 features.\n * savings (4), credit (3), exchange (2), investment (8), rewards (2) = 19 stubs\n */\n\nimport type { ToolDef } from \"./types.js\";\n\nfunction stub(name: string, description: string, phase: string): ToolDef {\n  return {\n    name,\n    description: `${description} (Coming in ${phase})`,\n    inputSchema: { type: \"object\", properties: {} },\n    handler: async () => ({\n      content: [{ type: \"text\", text: `${description} is not yet available. Coming in ${phase} when Canton DeFi protocols launch.` }],\n    }),\n  };\n}\n\nexport function stubTools(): ToolDef[] {\n  return [\n    // Savings (4)\n    stub(\"caypo_save\", \"Deposit USDCx into savings for yield\", \"Phase 3\"),\n    stub(\"caypo_withdraw\", \"Withdraw from savings to checking\", \"Phase 3\"),\n    stub(\"caypo_rebalance_savings\", \"Rebalance savings across protocols\", \"Phase 3\"),\n    stub(\"caypo_earnings\", \"View savings earnings and APY\", \"Phase 3\"),\n    // Credit (3)\n    stub(\"caypo_borrow\", \"Borrow USDCx against collateral\", \"Phase 3\"),\n    stub(\"caypo_repay\", \"Repay borrowed amount\", \"Phase 3\"),\n    stub(\"caypo_health\", \"Check credit health factor\", \"Phase 3\"),\n    // Exchange (2)\n    stub(\"caypo_exchange\", \"Exchange tokens on Canton DEX\", \"Phase 3\"),\n    stub(\"caypo_quote\", \"Get exchange rate quote\", \"Phase 3\"),\n    // Investment (8)\n    stub(\"caypo_invest_buy\", \"Buy investment assets\", \"Phase 4\"),\n    stub(\"caypo_invest_sell\", \"Sell investment assets\", \"Phase 4\"),\n    stub(\"caypo_invest_earn\", \"Stake assets for yield\", \"Phase 4\"),\n    stub(\"caypo_invest_unearn\", \"Unstake assets\", \"Phase 4\"),\n    stub(\"caypo_invest_rebalance\", \"Rebalance investment portfolio\", \"Phase 4\"),\n    stub(\"caypo_portfolio\", \"View investment portfolio\", \"Phase 4\"),\n    stub(\"caypo_strategy_buy\", \"Execute investment strategy\", \"Phase 4\"),\n    stub(\"caypo_auto_invest\", \"Configure auto-invest DCA\", \"Phase 4\"),\n    // Rewards (2)\n    stub(\"caypo_claim_rewards\", \"Claim Canton Coin mining rewards\", \"Phase 3\"),\n    stub(\"caypo_reward_history\", \"View reward claim history\", \"Phase 3\"),\n  ];\n}\n","/**\n * Register all 20 prompts on the MCP server.\n * 5 fully implemented, 15 stubs.\n */\n\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\ninterface PromptDef {\n  name: string;\n  description: string;\n  arguments?: Array<{ name: string; description: string; required?: boolean }>;\n  handler: (args: Record<string, string>) => { messages: Array<{ role: string; content: { type: string; text: string } }> };\n}\n\nfunction stubPrompt(name: string, description: string): PromptDef {\n  return {\n    name,\n    description,\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Please provide a ${description.toLowerCase()}. Note: This prompt template will be enhanced in a future version.`,\n          },\n        },\n      ],\n    }),\n  };\n}\n\nconst prompts: PromptDef[] = [\n  // 5 fully implemented prompts\n  {\n    name: \"morning_briefing\",\n    description: \"Daily financial briefing — balance, spending, traffic, alerts\",\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Good morning! Please give me my daily Canton agent briefing:\n\n1. **Balance**: Call caypo_balance to get my current USDCx balance and holding count.\n2. **Spending**: Call caypo_safeguards to check my daily spending vs limits.\n3. **Traffic**: Call caypo_traffic to check validator traffic status.\n4. **Recent activity**: Call caypo_history with limit=5 to show recent transactions.\n\nFormat as a concise morning briefing with key numbers highlighted.`,\n          },\n        },\n      ],\n    }),\n  },\n  {\n    name: \"financial_report\",\n    description: \"Comprehensive financial report — all accounts, spending patterns, recommendations\",\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Generate a comprehensive financial report for my Canton agent:\n\n1. Call caypo_balance for current balance\n2. Call caypo_safeguards for spending limits and daily usage\n3. Call caypo_history with limit=20 for recent transactions\n4. Call caypo_traffic for traffic status\n\nAnalyze the data and provide:\n- Total balance and holding efficiency (suggest merging if >5 UTXOs)\n- Daily spending rate vs limits\n- Traffic consumption trend\n- Recommendations for limit adjustments`,\n          },\n        },\n      ],\n    }),\n  },\n  {\n    name: \"spending_analysis\",\n    description: \"Analyze recent spending patterns and suggest optimizations\",\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Analyze my spending patterns:\n\n1. Call caypo_history with limit=50\n2. Call caypo_safeguards for current limits\n3. Call caypo_balance for current balance\n\nThen:\n- Categorize spending (API calls, transfers, etc.)\n- Identify the most expensive API services\n- Suggest whether my safeguard limits are appropriate\n- Flag any unusual transaction patterns`,\n          },\n        },\n      ],\n    }),\n  },\n  {\n    name: \"security_audit\",\n    description: \"Security audit — check safeguards, wallet status, traffic health\",\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Perform a security audit of my Canton agent:\n\n1. Call caypo_safeguards — are limits set appropriately?\n2. Call caypo_traffic — is traffic healthy?\n3. Call caypo_balance — any concerns about holding count?\n4. Call caypo_address — verify network\n\nCheck for:\n- Are safeguard limits reasonable? (tx limit should be < 10% of balance)\n- Is the wallet locked when it should be?\n- Are there too many UTXOs? (>10 = recommend merge)\n- Is traffic balance sufficient?\n- Any signs of unusual activity?`,\n          },\n        },\n      ],\n    }),\n  },\n  {\n    name: \"onboarding\",\n    description: \"New user onboarding — explain Canton agent features and guide setup\",\n    handler: () => ({\n      messages: [\n        {\n          role: \"user\",\n          content: {\n            type: \"text\",\n            text: `Welcome a new user to CAYPO — their Canton Network agent bank account. Explain:\n\n1. **What CAYPO is**: A bank account for AI agents on Canton Network. Privacy-preserving, institutional-grade.\n2. **Key features**: USDCx checking account, MPP auto-payments for APIs, safeguards, traffic management.\n3. **How to get started**:\n   - Call caypo_address to show their party ID\n   - Call caypo_balance to check initial balance\n   - Call caypo_safeguards to review default limits\n   - Call caypo_services to see available paid APIs\n4. **Important concepts**:\n   - Canton uses party IDs, not addresses\n   - USDCx is USDC-backed via Circle xReserve\n   - Amounts are always strings (never floating point)\n   - Traffic replaces gas (validator-level, not per-tx)\n5. **Safety**: Safeguards protect against overspending. Always set appropriate limits.`,\n          },\n        },\n      ],\n    }),\n  },\n  // 15 stub prompts\n  stubPrompt(\"what_if\", \"What-if financial scenario analysis\"),\n  stubPrompt(\"optimize_yield\", \"Yield optimization recommendations\"),\n  stubPrompt(\"risk_assessment\", \"Risk assessment for current positions\"),\n  stubPrompt(\"investment_thesis\", \"Investment thesis generation\"),\n  stubPrompt(\"rebalance_plan\", \"Portfolio rebalance plan\"),\n  stubPrompt(\"savings_strategy\", \"Savings strategy recommendations\"),\n  stubPrompt(\"credit_health\", \"Credit health assessment\"),\n  stubPrompt(\"traffic_report\", \"Detailed traffic consumption report\"),\n  stubPrompt(\"market_overview\", \"Canton market overview\"),\n  stubPrompt(\"portfolio_review\", \"Investment portfolio review\"),\n  stubPrompt(\"defi_opportunities\", \"DeFi opportunities on Canton\"),\n  stubPrompt(\"weekly_summary\", \"Weekly financial summary\"),\n  stubPrompt(\"budget_plan\", \"Budget planning assistant\"),\n  stubPrompt(\"tax_summary\", \"Transaction tax summary\"),\n  stubPrompt(\"troubleshoot\", \"Troubleshoot Canton agent issues\"),\n];\n\nexport function registerPrompts(server: Server): void {\n  const promptMap = new Map<string, PromptDef>();\n  for (const p of prompts) {\n    promptMap.set(p.name, p);\n  }\n\n  server.setRequestHandler(ListPromptsRequestSchema, async () => ({\n    prompts: prompts.map((p) => ({\n      name: p.name,\n      description: p.description,\n      arguments: p.arguments,\n    })),\n  }));\n\n  server.setRequestHandler(GetPromptRequestSchema, async (request) => {\n    const prompt = promptMap.get(request.params.name);\n    if (!prompt) {\n      throw new Error(`Unknown prompt: ${request.params.name}`);\n    }\n    return prompt.handler((request.params.arguments ?? {}) as Record<string, string>);\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@caypo/canton-mcp",
+  "version": "0.1.0",
+  "description": "MCP server connecting Canton Network to Claude Desktop, Cursor, and Windsurf — 33 tools, 20 prompts",
+  "keywords": [
+    "canton",
+    "mcp",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "windsurf",
+    "payments",
+    "usdcx",
+    "model-context-protocol"
+  ],
+  "author": "Cayvox Labs <anil@cayvox.com>",
+  "homepage": "https://github.com/anilkaracay/Caypo/tree/main/packages/mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anilkaracay/Caypo.git",
+    "directory": "packages/mcp"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "caypo-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@caypo/canton-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  },
+  "license": "(Apache-2.0 OR MIT)",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+/**
+ * @caypo/canton-mcp — MCP server for Canton Network agent.
+ * 33 tools + 20 prompts for AI agent integration.
+ *
+ * Transport: stdio (standard for Claude Desktop MCP servers)
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CantonAgent } from "@caypo/canton-sdk";
+import { registerTools } from "./tools/index.js";
+import { registerPrompts } from "./prompts/index.js";
+
+export const CANTON_MCP_VERSION = "0.1.0";
+
+async function main() {
+  // 1. Create agent
+  const agent = await CantonAgent.create({
+    token: process.env.CANTON_JWT ?? "",
+  });
+
+  // 2. Create MCP server
+  const server = new Server(
+    { name: "caypo", version: CANTON_MCP_VERSION },
+    { capabilities: { tools: {}, prompts: {} } },
+  );
+
+  // 3. Register tools and prompts
+  registerTools(server, agent);
+  registerPrompts(server);
+
+  // 4. Connect via stdio
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error("MCP server failed to start:", err);
+  process.exit(1);
+});

package/src/prompts/index.ts

@@ -0,0 +1,207 @@
+/**
+ * Register all 20 prompts on the MCP server.
+ * 5 fully implemented, 15 stubs.
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  GetPromptRequestSchema,
+  ListPromptsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+interface PromptDef {
+  name: string;
+  description: string;
+  arguments?: Array<{ name: string; description: string; required?: boolean }>;
+  handler: (args: Record<string, string>) => { messages: Array<{ role: string; content: { type: string; text: string } }> };
+}
+
+function stubPrompt(name: string, description: string): PromptDef {
+  return {
+    name,
+    description,
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Please provide a ${description.toLowerCase()}. Note: This prompt template will be enhanced in a future version.`,
+          },
+        },
+      ],
+    }),
+  };
+}
+
+const prompts: PromptDef[] = [
+  // 5 fully implemented prompts
+  {
+    name: "morning_briefing",
+    description: "Daily financial briefing — balance, spending, traffic, alerts",
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Good morning! Please give me my daily Canton agent briefing:
+
+1. **Balance**: Call caypo_balance to get my current USDCx balance and holding count.
+2. **Spending**: Call caypo_safeguards to check my daily spending vs limits.
+3. **Traffic**: Call caypo_traffic to check validator traffic status.
+4. **Recent activity**: Call caypo_history with limit=5 to show recent transactions.
+
+Format as a concise morning briefing with key numbers highlighted.`,
+          },
+        },
+      ],
+    }),
+  },
+  {
+    name: "financial_report",
+    description: "Comprehensive financial report — all accounts, spending patterns, recommendations",
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Generate a comprehensive financial report for my Canton agent:
+
+1. Call caypo_balance for current balance
+2. Call caypo_safeguards for spending limits and daily usage
+3. Call caypo_history with limit=20 for recent transactions
+4. Call caypo_traffic for traffic status
+
+Analyze the data and provide:
+- Total balance and holding efficiency (suggest merging if >5 UTXOs)
+- Daily spending rate vs limits
+- Traffic consumption trend
+- Recommendations for limit adjustments`,
+          },
+        },
+      ],
+    }),
+  },
+  {
+    name: "spending_analysis",
+    description: "Analyze recent spending patterns and suggest optimizations",
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Analyze my spending patterns:
+
+1. Call caypo_history with limit=50
+2. Call caypo_safeguards for current limits
+3. Call caypo_balance for current balance
+
+Then:
+- Categorize spending (API calls, transfers, etc.)
+- Identify the most expensive API services
+- Suggest whether my safeguard limits are appropriate
+- Flag any unusual transaction patterns`,
+          },
+        },
+      ],
+    }),
+  },
+  {
+    name: "security_audit",
+    description: "Security audit — check safeguards, wallet status, traffic health",
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Perform a security audit of my Canton agent:
+
+1. Call caypo_safeguards — are limits set appropriately?
+2. Call caypo_traffic — is traffic healthy?
+3. Call caypo_balance — any concerns about holding count?
+4. Call caypo_address — verify network
+
+Check for:
+- Are safeguard limits reasonable? (tx limit should be < 10% of balance)
+- Is the wallet locked when it should be?
+- Are there too many UTXOs? (>10 = recommend merge)
+- Is traffic balance sufficient?
+- Any signs of unusual activity?`,
+          },
+        },
+      ],
+    }),
+  },
+  {
+    name: "onboarding",
+    description: "New user onboarding — explain Canton agent features and guide setup",
+    handler: () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Welcome a new user to CAYPO — their Canton Network agent bank account. Explain:
+
+1. **What CAYPO is**: A bank account for AI agents on Canton Network. Privacy-preserving, institutional-grade.
+2. **Key features**: USDCx checking account, MPP auto-payments for APIs, safeguards, traffic management.
+3. **How to get started**:
+   - Call caypo_address to show their party ID
+   - Call caypo_balance to check initial balance
+   - Call caypo_safeguards to review default limits
+   - Call caypo_services to see available paid APIs
+4. **Important concepts**:
+   - Canton uses party IDs, not addresses
+   - USDCx is USDC-backed via Circle xReserve
+   - Amounts are always strings (never floating point)
+   - Traffic replaces gas (validator-level, not per-tx)
+5. **Safety**: Safeguards protect against overspending. Always set appropriate limits.`,
+          },
+        },
+      ],
+    }),
+  },
+  // 15 stub prompts
+  stubPrompt("what_if", "What-if financial scenario analysis"),
+  stubPrompt("optimize_yield", "Yield optimization recommendations"),
+  stubPrompt("risk_assessment", "Risk assessment for current positions"),
+  stubPrompt("investment_thesis", "Investment thesis generation"),
+  stubPrompt("rebalance_plan", "Portfolio rebalance plan"),
+  stubPrompt("savings_strategy", "Savings strategy recommendations"),
+  stubPrompt("credit_health", "Credit health assessment"),
+  stubPrompt("traffic_report", "Detailed traffic consumption report"),
+  stubPrompt("market_overview", "Canton market overview"),
+  stubPrompt("portfolio_review", "Investment portfolio review"),
+  stubPrompt("defi_opportunities", "DeFi opportunities on Canton"),
+  stubPrompt("weekly_summary", "Weekly financial summary"),
+  stubPrompt("budget_plan", "Budget planning assistant"),
+  stubPrompt("tax_summary", "Transaction tax summary"),
+  stubPrompt("troubleshoot", "Troubleshoot Canton agent issues"),
+];
+
+export function registerPrompts(server: Server): void {
+  const promptMap = new Map<string, PromptDef>();
+  for (const p of prompts) {
+    promptMap.set(p.name, p);
+  }
+
+  server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: prompts.map((p) => ({
+      name: p.name,
+      description: p.description,
+      arguments: p.arguments,
+    })),
+  }));
+
+  server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const prompt = promptMap.get(request.params.name);
+    if (!prompt) {
+      throw new Error(`Unknown prompt: ${request.params.name}`);
+    }
+    return prompt.handler((request.params.arguments ?? {}) as Record<string, string>);
+  });
+}

package/src/tools/balance.ts

@@ -0,0 +1,79 @@
+/**
+ * Balance & Info tools (5): caypo_balance, caypo_address, caypo_history, caypo_positions, caypo_rates
+ */
+
+import type { CantonAgent } from "@caypo/canton-sdk";
+import type { ToolDef } from "./types.js";
+
+export function balanceTools(agent: CantonAgent): ToolDef[] {
+  return [
+    {
+      name: "caypo_balance",
+      description: "Get USDCx checking account balance and holding count",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => {
+        const bal = await agent.checking.balance();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                available: bal.available,
+                holdingCount: bal.holdingCount,
+                currency: "USDCx",
+                network: agent.wallet.network,
+              }, null, 2),
+            },
+          ],
+        };
+      },
+    },
+    {
+      name: "caypo_address",
+      description: "Get Canton party ID (address) and network info",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              partyId: agent.wallet.address,
+              network: agent.wallet.network,
+              format: "<DisplayName>::<hex-fingerprint>",
+            }, null, 2),
+          },
+        ],
+      }),
+    },
+    {
+      name: "caypo_history",
+      description: "Get recent transaction history",
+      inputSchema: {
+        type: "object",
+        properties: { limit: { type: "number", description: "Max transactions to return", default: 20 } },
+      },
+      handler: async (args) => {
+        const history = await agent.checking.history({ limit: (args as { limit?: number }).limit });
+        return {
+          content: [{ type: "text", text: JSON.stringify(history, null, 2) }],
+        };
+      },
+    },
+    {
+      name: "caypo_positions",
+      description: "View DeFi positions (Coming in Phase 3)",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({
+        content: [{ type: "text", text: "DeFi positions are not yet available. Coming in Phase 3 when Canton DeFi protocols launch." }],
+      }),
+    },
+    {
+      name: "caypo_rates",
+      description: "Get exchange rates and APYs (Coming in Phase 3)",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({
+        content: [{ type: "text", text: "Exchange rates and APYs are not yet available. Coming in Phase 3." }],
+      }),
+    },
+  ];
+}

package/src/tools/checking.ts

@@ -0,0 +1,75 @@
+/**
+ * Checking tools (3): caypo_send, caypo_receive, caypo_contacts
+ */
+
+import type { CantonAgent } from "@caypo/canton-sdk";
+import type { ToolDef } from "./types.js";
+
+export function checkingTools(agent: CantonAgent): ToolDef[] {
+  return [
+    {
+      name: "caypo_send",
+      description: "Send USDCx to a recipient via TransferFactory_Transfer. Checks safeguards before sending.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          recipient: { type: "string", description: "Recipient Canton party ID" },
+          amount: { type: "string", description: "Amount of USDCx to send (string, e.g. '1.50')" },
+          memo: { type: "string", description: "Optional memo" },
+        },
+        required: ["recipient", "amount"],
+      },
+      handler: async (args) => {
+        const { recipient, amount, memo } = args as { recipient: string; amount: string; memo?: string };
+        const result = await agent.checking.send(recipient, amount, { memo });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                status: "success",
+                amount,
+                recipient,
+                updateId: result.updateId,
+                completionOffset: result.completionOffset,
+                commandId: result.commandId,
+              }, null, 2),
+            },
+          ],
+        };
+      },
+    },
+    {
+      name: "caypo_receive",
+      description: "Show party ID and deposit instructions for receiving USDCx",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              partyId: agent.wallet.address,
+              network: agent.wallet.network,
+              instructions: "Send USDCx to this party ID. The sender needs a TransferPreapproval or must use a 2-step TransferInstruction.",
+            }, null, 2),
+          },
+        ],
+      }),
+    },
+    {
+      name: "caypo_contacts",
+      description: "Manage contact list — list, add, or remove contacts",
+      inputSchema: {
+        type: "object",
+        properties: {
+          action: { type: "string", enum: ["list", "add", "remove"], default: "list" },
+          name: { type: "string", description: "Contact name" },
+          partyId: { type: "string", description: "Contact party ID" },
+        },
+      },
+      handler: async () => ({
+        content: [{ type: "text", text: "Contact management coming soon. Use party IDs directly for now." }],
+      }),
+    },
+  ];
+}

package/src/tools/index.ts

@@ -0,0 +1,60 @@
+/**
+ * Register all 33 tools on the MCP server.
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import type { CantonAgent } from "@caypo/canton-sdk";
+import { balanceTools } from "./balance.js";
+import { checkingTools } from "./checking.js";
+import { mppTools } from "./mpp.js";
+import { safeguardTools } from "./safeguards.js";
+import { trafficTools } from "./traffic.js";
+import { stubTools } from "./stubs.js";
+import type { ToolDef } from "./types.js";
+
+export function registerTools(server: Server, agent: CantonAgent): void {
+  const allTools: ToolDef[] = [
+    ...balanceTools(agent),
+    ...checkingTools(agent),
+    ...mppTools(agent),
+    ...safeguardTools(agent),
+    ...trafficTools(agent),
+    ...stubTools(),
+  ];
+
+  const toolMap = new Map<string, ToolDef>();
+  for (const tool of allTools) {
+    toolMap.set(tool.name, tool);
+  }
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: allTools.map((t) => ({
+      name: t.name,
+      description: t.description,
+      inputSchema: t.inputSchema,
+    })),
+  }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const tool = toolMap.get(request.params.name);
+    if (!tool) {
+      return {
+        content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],
+        isError: true,
+      };
+    }
+
+    try {
+      return await tool.handler((request.params.arguments ?? {}) as Record<string, unknown>);
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Error: ${(err as Error).message}` }],
+        isError: true,
+      };
+    }
+  });
+}