@caypo/canton-mcp 0.1.0

package/src/tools/mpp.ts

@@ -0,0 +1,98 @@
+/**
+ * MPP Payment tools (3): caypo_pay, caypo_pay_status, caypo_services
+ */
+
+import type { CantonAgent } from "@caypo/canton-sdk";
+import type { ToolDef } from "./types.js";
+
+export function mppTools(agent: CantonAgent): ToolDef[] {
+  return [
+    {
+      name: "caypo_pay",
+      description: "Pay for an API call via MPP (HTTP 402 auto-handling). Fetches URL, handles payment if 402, returns response.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          url: { type: "string", description: "URL to fetch" },
+          method: { type: "string", description: "HTTP method", default: "GET" },
+          body: { type: "string", description: "Request body (JSON string)" },
+          maxPrice: { type: "string", description: "Maximum price willing to pay in USDCx" },
+        },
+        required: ["url"],
+      },
+      handler: async (args) => {
+        const { url, method, body, maxPrice } = args as {
+          url: string; method?: string; body?: string; maxPrice?: string;
+        };
+        const result = await agent.mpp.pay(url, {
+          method,
+          body,
+          maxPrice,
+          headers: body ? { "Content-Type": "application/json" } : undefined,
+        });
+        const responseBody = await result.response.text();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                status: result.response.status,
+                paid: result.paid,
+                receipt: result.receipt,
+                body: responseBody.slice(0, 2000),
+              }, null, 2),
+            },
+          ],
+        };
+      },
+    },
+    {
+      name: "caypo_pay_status",
+      description: "Check payment status by Canton update ID",
+      inputSchema: {
+        type: "object",
+        properties: {
+          updateId: { type: "string", description: "Canton transaction update ID" },
+        },
+        required: ["updateId"],
+      },
+      handler: async () => ({
+        content: [{ type: "text", text: "Payment status lookup requires gateway integration. Use the updateId with the Canton Ledger API directly." }],
+      }),
+    },
+    {
+      name: "caypo_services",
+      description: "List available MPP gateway services and pricing",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              gateway: "mpp.cayvox.io",
+              services: [
+                { name: "OpenAI", path: "/openai", price: "$0.001-$0.05" },
+                { name: "Anthropic", path: "/anthropic", price: "$0.01" },
+                { name: "fal.ai", path: "/fal", price: "$0.01-$0.10" },
+                { name: "Firecrawl", path: "/firecrawl", price: "$0.005-$0.02" },
+                { name: "Google Gemini", path: "/gemini", price: "$0.005-$0.02" },
+                { name: "Groq", path: "/groq", price: "$0.001-$0.005" },
+                { name: "Perplexity", path: "/perplexity", price: "$0.01" },
+                { name: "Brave Search", path: "/brave", price: "$0.001-$0.005" },
+                { name: "DeepSeek", path: "/deepseek", price: "$0.005" },
+                { name: "Resend", path: "/resend", price: "$0.005" },
+                { name: "Together AI", path: "/together", price: "$0.001-$0.02" },
+                { name: "ElevenLabs", path: "/elevenlabs", price: "$0.02-$0.05" },
+                { name: "OpenWeather", path: "/openweather", price: "$0.001" },
+                { name: "Google Maps", path: "/googlemaps", price: "$0.005" },
+                { name: "Judge0", path: "/judge0", price: "$0.002" },
+                { name: "Reloadly", path: "/reloadly", price: "$0.01+" },
+                { name: "Lob", path: "/lob", price: "$0.01-$0.50" },
+              ],
+            }, null, 2),
+          },
+        ],
+      }),
+    },
+  ];
+}

package/src/tools/safeguards.ts

@@ -0,0 +1,67 @@
+/**
+ * Safeguard tools (3): caypo_safeguards, caypo_set_limit, caypo_lock
+ */
+
+import type { CantonAgent } from "@caypo/canton-sdk";
+import type { ToolDef } from "./types.js";
+
+export function safeguardTools(agent: CantonAgent): ToolDef[] {
+  return [
+    {
+      name: "caypo_safeguards",
+      description: "View current safeguard settings: tx limit, daily limit, lock status, daily spending",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => {
+        const s = agent.safeguards.settings();
+        return {
+          content: [{ type: "text", text: JSON.stringify(s, null, 2) }],
+        };
+      },
+    },
+    {
+      name: "caypo_set_limit",
+      description: "Set per-transaction or daily spending limit",
+      inputSchema: {
+        type: "object",
+        properties: {
+          type: { type: "string", enum: ["tx", "daily"], description: "Limit type" },
+          amount: { type: "string", description: "Limit amount in USDCx" },
+        },
+        required: ["type", "amount"],
+      },
+      handler: async (args) => {
+        const { type, amount } = args as { type: "tx" | "daily"; amount: string };
+        if (type === "tx") {
+          agent.safeguards.setTxLimit(amount);
+        } else {
+          agent.safeguards.setDailyLimit(amount);
+        }
+        return {
+          content: [{ type: "text", text: `${type === "tx" ? "Per-transaction" : "Daily"} limit set to ${amount} USDCx` }],
+        };
+      },
+    },
+    {
+      name: "caypo_lock",
+      description: "Lock or unlock the wallet. When locked, all transactions are rejected.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          action: { type: "string", enum: ["lock", "unlock"], description: "Action to perform" },
+          pin: { type: "string", description: "PIN for lock/unlock" },
+        },
+        required: ["action"],
+      },
+      handler: async (args) => {
+        const { action, pin } = args as { action: "lock" | "unlock"; pin?: string };
+        if (action === "lock") {
+          agent.safeguards.lock(pin);
+          return { content: [{ type: "text", text: "Wallet locked. All transactions will be rejected until unlocked." }] };
+        } else {
+          agent.safeguards.unlock(pin ?? "");
+          return { content: [{ type: "text", text: "Wallet unlocked." }] };
+        }
+      },
+    },
+  ];
+}

package/src/tools/stubs.ts

@@ -0,0 +1,46 @@
+/**
+ * Stub tools for Phase 3/4 features.
+ * savings (4), credit (3), exchange (2), investment (8), rewards (2) = 19 stubs
+ */
+
+import type { ToolDef } from "./types.js";
+
+function stub(name: string, description: string, phase: string): ToolDef {
+  return {
+    name,
+    description: `${description} (Coming in ${phase})`,
+    inputSchema: { type: "object", properties: {} },
+    handler: async () => ({
+      content: [{ type: "text", text: `${description} is not yet available. Coming in ${phase} when Canton DeFi protocols launch.` }],
+    }),
+  };
+}
+
+export function stubTools(): ToolDef[] {
+  return [
+    // Savings (4)
+    stub("caypo_save", "Deposit USDCx into savings for yield", "Phase 3"),
+    stub("caypo_withdraw", "Withdraw from savings to checking", "Phase 3"),
+    stub("caypo_rebalance_savings", "Rebalance savings across protocols", "Phase 3"),
+    stub("caypo_earnings", "View savings earnings and APY", "Phase 3"),
+    // Credit (3)
+    stub("caypo_borrow", "Borrow USDCx against collateral", "Phase 3"),
+    stub("caypo_repay", "Repay borrowed amount", "Phase 3"),
+    stub("caypo_health", "Check credit health factor", "Phase 3"),
+    // Exchange (2)
+    stub("caypo_exchange", "Exchange tokens on Canton DEX", "Phase 3"),
+    stub("caypo_quote", "Get exchange rate quote", "Phase 3"),
+    // Investment (8)
+    stub("caypo_invest_buy", "Buy investment assets", "Phase 4"),
+    stub("caypo_invest_sell", "Sell investment assets", "Phase 4"),
+    stub("caypo_invest_earn", "Stake assets for yield", "Phase 4"),
+    stub("caypo_invest_unearn", "Unstake assets", "Phase 4"),
+    stub("caypo_invest_rebalance", "Rebalance investment portfolio", "Phase 4"),
+    stub("caypo_portfolio", "View investment portfolio", "Phase 4"),
+    stub("caypo_strategy_buy", "Execute investment strategy", "Phase 4"),
+    stub("caypo_auto_invest", "Configure auto-invest DCA", "Phase 4"),
+    // Rewards (2)
+    stub("caypo_claim_rewards", "Claim Canton Coin mining rewards", "Phase 3"),
+    stub("caypo_reward_history", "View reward claim history", "Phase 3"),
+  ];
+}

package/src/tools/traffic.ts

@@ -0,0 +1,44 @@
+/**
+ * Traffic tools (2): caypo_traffic, caypo_purchase_traffic
+ */
+
+import type { CantonAgent } from "@caypo/canton-sdk";
+import type { ToolDef } from "./types.js";
+
+export function trafficTools(agent: CantonAgent): ToolDef[] {
+  return [
+    {
+      name: "caypo_traffic",
+      description: "Check validator traffic balance. Canton uses traffic budgets, not gas fees.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => {
+        const bal = await agent.traffic.trafficBalance();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                ...bal,
+                note: "Canton uses traffic budgets per validator, not per-transaction gas fees.",
+              }, null, 2),
+            },
+          ],
+        };
+      },
+    },
+    {
+      name: "caypo_purchase_traffic",
+      description: "Purchase additional traffic by burning Canton Coin (CC). Coming soon.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ccAmount: { type: "string", description: "Amount of CC to burn" },
+        },
+        required: ["ccAmount"],
+      },
+      handler: async () => ({
+        content: [{ type: "text", text: "Traffic purchase is not yet implemented. Requires validator admin API access." }],
+      }),
+    },
+  ];
+}

package/src/tools/types.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool definition type for MCP server.
+ */
+
+export interface ToolResult {
+  content: Array<{ type: string; text: string }>;
+  isError?: boolean;
+}
+
+export interface ToolDef {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+  handler: (args: Record<string, unknown>) => Promise<ToolResult>;
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  dts: false,
+  clean: true,
+  sourcemap: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    passWithNoTests: true,
+  },
+});