@caypo/canton-mcp 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,14 @@
+
+> @caypo/canton-mcp@0.1.0 build /Users/anil/Desktop/caypo/packages/mcp
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/anil/Desktop/caypo/packages/mcp/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js     21.32 KB
+ESM dist/index.js.map 37.47 KB
+ESM ⚡️ Build success in 11ms

package/.turbo/turbo-test.log

@@ -0,0 +1,12 @@
+
+> @caypo/canton-mcp@0.1.0 test /Users/anil/Desktop/caypo/packages/mcp
+> vitest run
+
+
+ RUN  v3.2.4 /Users/anil/Desktop/caypo/packages/mcp
+
+No test files found, exiting with code 0
+
+include: **/*.{test,spec}.?(c|m)[jt]s?(x)
+exclude:  **/node_modules/**, **/dist/**, **/cypress/**, **/.{idea,git,cache,output,temp}/**, **/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*
+

package/README.md

@@ -0,0 +1,84 @@
+# @caypo/canton-mcp
+
+**MCP server connecting [Canton Network](https://canton.network) to Claude Desktop, Cursor, and Windsurf**
+
+33 tools and 20 prompts for AI-assisted banking operations — check balances, send payments, pay for APIs, manage safeguards, and more.
+
+[![License](https://img.shields.io/badge/license-Apache--2.0%20%2F%20MIT-blue)](../../LICENSE-APACHE)
+[![Tools](https://img.shields.io/badge/MCP%20tools-33-purple)](../../)
+[![Prompts](https://img.shields.io/badge/MCP%20prompts-20-purple)](../../)
+
+## Install
+
+The easiest way:
+
+```bash
+caypo mcp install
+```
+
+Or manually add to your MCP config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "caypo": {
+      "command": "npx",
+      "args": ["@caypo/canton-mcp"],
+      "env": { "CANTON_AGENT_CONFIG": "~/.caypo/config.json" }
+    }
+  }
+}
+```
+
+## What You Can Ask
+
+Once installed, talk to your AI assistant naturally:
+
+> "What's my CAYPO balance?"
+
+> "Send 5 USDCx to Alice::1220..."
+
+> "Pay for a GPT-4 API call through the gateway"
+
+> "Show my spending limits and daily usage"
+
+> "Give me a morning financial briefing"
+
+> "Run a security audit on my agent wallet"
+
+## Tools (33)
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Balance & Info** | `caypo_balance`, `caypo_address`, `caypo_history`, `caypo_positions`, `caypo_rates` | Account overview |
+| **Checking** | `caypo_send`, `caypo_receive`, `caypo_contacts` | Send and receive USDCx |
+| **MPP Payments** | `caypo_pay`, `caypo_pay_status`, `caypo_services` | Pay for APIs, check status |
+| **Safeguards** | `caypo_safeguards`, `caypo_set_limit`, `caypo_lock` | Spending controls |
+| **Traffic** | `caypo_traffic`, `caypo_purchase_traffic` | Validator bandwidth |
+| **Savings** | 4 tools | Coming in Phase 3 |
+| **Credit** | 3 tools | Coming in Phase 3 |
+| **Exchange** | 2 tools | Coming in Phase 3 |
+| **Investment** | 8 tools | Coming in Phase 4 |
+| **Rewards** | 2 tools | Coming in Phase 3 |
+
+## Prompts (20)
+
+| Prompt | Description |
+|--------|-------------|
+| `morning_briefing` | Daily financial briefing with balance, spending, traffic |
+| `financial_report` | Comprehensive account analysis with recommendations |
+| `spending_analysis` | Categorize spending and identify patterns |
+| `security_audit` | Check safeguards, wallet status, traffic health |
+| `onboarding` | New user guide for Canton agent banking |
+| *+ 15 more* | what_if, optimize_yield, risk_assessment, budget_plan, ... |
+
+## Compatible With
+
+- **Claude Desktop** (Anthropic)
+- **Cursor** (AI code editor)
+- **Windsurf** (Codeium)
+- Any MCP-compatible AI tool
+
+## License
+
+Apache-2.0 OR MIT

package/SPEC.md

@@ -0,0 +1,93 @@
+# @cayvox/canton-mcp — MCP Server Specification (Production)
+
+## Stats: 33 tools + 20 prompts (matching t2000)
+
+## Installation
+
+```bash
+canton-agent mcp install
+# Creates config for Claude Desktop / Cursor / Windsurf
+```
+
+MCP config entry:
+```json
+{
+  "mcpServers": {
+    "canton-agent": {
+      "command": "npx",
+      "args": ["@cayvox/canton-mcp"],
+      "env": { "CANTON_AGENT_CONFIG": "~/.canton-agent/config.json" }
+    }
+  }
+}
+```
+
+Transport: **stdio** (standard for Claude Desktop MCP servers)
+
+## Tools (33)
+
+### Balance & Info (5)
+- `canton_balance` — All account balances (queries Holding contracts via `/v2/state/active-contracts`)
+- `canton_address` — Party ID and network info
+- `canton_history` — Transaction history via `/v2/updates/flats`
+- `canton_positions` — DeFi positions (Phase 3 stub)
+- `canton_rates` — Exchange rates and APYs (Phase 3 stub)
+
+### Checking (3)
+- `canton_send` — Send USDCx via TransferFactory_Transfer
+- `canton_receive` — Show party ID + deposit instructions
+- `canton_contacts` — Manage contact list (local JSON)
+
+### Savings (4) — Phase 3 stubs
+- `canton_save`, `canton_withdraw`, `canton_rebalance_savings`, `canton_earnings`
+
+### Credit (3) — Phase 3 stubs
+- `canton_borrow`, `canton_repay`, `canton_health`
+
+### Exchange (2) — Phase 3 stubs
+- `canton_exchange`, `canton_quote`
+
+### Investment (8) — Phase 4 stubs
+- `canton_invest_buy`, `canton_invest_sell`, `canton_invest_earn`, `canton_invest_unearn`
+- `canton_invest_rebalance`, `canton_portfolio`, `canton_strategy_buy`, `canton_auto_invest`
+
+### MPP Payments (3)
+- `canton_pay` — Pay for API via MPP (402 auto-handling)
+- `canton_pay_status` — Check payment by updateId
+- `canton_services` — List MPP gateway services
+
+### Safeguards (3)
+- `canton_safeguards` — View limits
+- `canton_set_limit` — Set tx/daily limits
+- `canton_lock` — Lock/unlock wallet
+
+### Traffic (2)
+- `canton_traffic` — Validator traffic balance
+- `canton_purchase_traffic` — Buy traffic with CC
+
+### Rewards (2) — Phase 3 stubs
+- `canton_claim_rewards`, `canton_reward_history`
+
+## Prompts (20)
+
+morning_briefing, financial_report, what_if, optimize_yield, risk_assessment,
+investment_thesis, rebalance_plan, savings_strategy, credit_health, spending_analysis,
+traffic_report, market_overview, portfolio_review, defi_opportunities, weekly_summary,
+budget_plan, tax_summary, onboarding, troubleshoot, security_audit
+
+## Implementation
+
+```typescript
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CantonAgent } from "@cayvox/canton-sdk";
+
+const agent = await CantonAgent.create();
+const server = new Server({ name: "canton-agent", version: "1.0.0" }, {
+  capabilities: { tools: {}, prompts: {} },
+});
+
+// Register tools and prompts...
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```