caypo.xyz · mpp.caypo.xyz · npm · Docs · GitHub
AI agents need to pay for things — API calls, compute, data, services. But agents can't hold money, authorize payments, or settle transactions on their own.
CAYPO gives AI agents their own bank account on Canton Network. Five accounts — checking, savings, credit, exchange, investment — all powered by USDCx stablecoins and the Machine Payments Protocol (MPP) by Stripe and Tempo. No credit cards, no API keys, no humans in the loop.
Canton Network is the institutional blockchain built by Digital Asset, backed by DTCC, Goldman Sachs, JPMorgan, and BNP Paribas. CAYPO is the bridge between Canton and the agentic economy.
- Privacy by default — Only sender and receiver see payment details. No public ledger exposure.
- Institutional compliance — DTCC, Goldman Sachs, JPMorgan, BNP Paribas already on Canton. Basel III compliant.
- USDCx by Circle — Institutional-grade stablecoin, 1:1 USDC-backed via xReserve, cross-chain via CCTP.
- Atomic settlement — Pay and settle in one transaction. No pending states, no chargebacks.
- Canton Coin rewards — Applications earn CC mining rewards based on usage (Cantonomics).
# Install the CLI
npm install -g @caypo/canton-cli
# Set up your agent wallet
caypo init
# Check balance
caypo balance
# Send USDCx
caypo send 10.00 to Bob::1220abcdef...
# Pay for an API call (auto-handles 402 flow)
caypo pay https://mpp.caypo.xyz/openai/v1/chat/completions --max-price 0.05
# Install MCP server for Claude Desktop
caypo mcp installsequenceDiagram
participant Agent
participant Gateway as CAYPO Gateway
participant Canton as Canton Network
Agent->>Gateway: POST /openai/v1/chat/completions
Gateway-->>Agent: 402 Payment Required<br/>amount="0.003" currency="USDCx"
Agent->>Canton: TransferFactory.Transfer (0.003 USDCx)
Canton-->>Agent: { updateId, completionOffset }
Agent->>Gateway: POST /openai/v1/chat + credential
Gateway->>Canton: Verify transaction
Canton-->>Gateway: Confirmed
Gateway-->>Agent: 200 OK + Payment-Receipt + response
| Package | Install | Description |
|---|---|---|
| @caypo/canton-sdk | npm i @caypo/canton-sdk |
Core SDK — Canton API client, USDCx, wallets, safeguards, MPP auto-pay |
| @caypo/mpp-canton | npm i @caypo/mpp-canton |
Canton payment method for MPP — accept and make USDCx payments |
| @caypo/canton-cli | npm i -g @caypo/canton-cli |
CLI — 36 commands: init, balance, send, pay, savings, credit, exchange, invest |
| @caypo/canton-mcp | npx @caypo/canton-mcp |
MCP server — 35 tools + 20 prompts for Claude, Cursor, Windsurf |
| @caypo/canton-gateway | npm i @caypo/canton-gateway |
API gateway — 17 services, 46 endpoints, pay-per-request |
Accept payments (server side):
import { cantonServer } from "@caypo/mpp-canton/server";
const server = cantonServer({
ledgerUrl: "http://localhost:7575",
token: process.env.CANTON_JWT,
userId: "ledger-api-user",
recipientPartyId: "Gateway::1220...",
network: "mainnet",
});
const receipt = await server.verify({ credential });
// { method: "canton", reference: updateId, status: "success" }Make payments (agent side):
import { CantonAgent } from "@caypo/canton-sdk";
const agent = await CantonAgent.create();
const { available } = await agent.checking.balance();
const result = await agent.mpp.pay("https://mpp.caypo.xyz/openai/v1/chat/completions", {
method: "POST",
body: JSON.stringify({ model: "gpt-4o", messages: [{ role: "user", content: "Hello" }] }),
maxPrice: "0.05",
});
// result.response.status → 200
// result.receipt → { updateId, amount: "0.003", ... }caypo mcp installThen ask Claude: "What's my CAYPO balance?" or "Send 5 USDCx to Alice::1220..."
35 tools — balance, send, pay, savings, credit, exchange, invest, safeguards, traffic, and more. 20 prompts — morning briefing, financial report, security audit, spending analysis.
Gateway Services — 17 services, 46 endpoints
Pay-per-request access. No API keys needed — just USDCx.
| Service | Endpoints | Price |
|---|---|---|
| OpenAI | chat, embeddings, images, audio | $0.001 – $0.05 |
| Anthropic | messages | $0.01 |
| fal.ai | image gen, audio, video | $0.01 – $0.10 |
| Firecrawl | scrape, crawl, map, extract | $0.005 – $0.02 |
| Google Gemini | chat, reasoning, embeddings | $0.005 – $0.02 |
| Groq | chat, embeddings | $0.001 – $0.005 |
| Perplexity | chat with search | $0.01 |
| Brave Search | web, images, news, videos | $0.001 – $0.005 |
| DeepSeek | chat | $0.005 |
| Resend | send email, batch | $0.005 |
| Together AI | chat, embeddings, images | $0.001 – $0.02 |
| ElevenLabs | TTS, voice clone | $0.02 – $0.05 |
| OpenWeather | current, forecast | $0.001 |
| Google Maps | geocode, places, directions | $0.005 |
| Judge0 | execute code, languages | $0.002 |
| Reloadly | gift cards | $0.01+ |
| Lob | postcards, letters, address verify | $0.01 – $0.50 |
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ MCP Server │ │ CLI │ │ Gateway │
│ 35 tools │ │ 36 commands│ │ 17 services │
│ 20 prompts │ │ │ │ 46 endpts │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
└────────────────┼────────────────┘
┌────────▼────────┐
│ @caypo/canton-sdk│
│ │
│ CantonAgent │
│ 5 Accounts │
│ Keystore (AES) │
│ SafeguardMgr │
└────────┬────────┘
│
┌────────▼────────┐
│ @caypo/mpp-canton│
│ │
│ cantonMethod │
│ cantonClient │
│ cantonServer │
└────────┬────────┘
│
┌────────▼────────┐
│ Canton Network │
│ USDCx (CIP-56) │
│ CC · Privacy │
└─────────────────┘
312 tests — 100% passing
14 E2E tests against live Canton DevNet (Splice v0.5.12)
35 MCP tools — all live
20 MCP prompts — all implemented
46 gateway endpoints — /health returns 200
Run pnpm verify to reproduce all checks locally.
| Version | Features | Status |
|---|---|---|
| v0.1 | MPP payment method, Core SDK, CLI (8 cmds), MCP server (14 tools), Gateway | Done |
| v0.2 | Savings, Credit, Exchange, Investment, 35 MCP tools, 36 CLI commands, Agent Skills, Gateway live, Landing page | Done |
| v1.0 | Production hardening, full Canton mainnet support | Next |
| v1.1 | Session intent (streaming payments, pay-per-token) | Planned |
| v2.0 | Real DeFi protocol adapters, Temple DEX integration | Planned |
pnpm install # Install dependencies
pnpm build # Build all packages
pnpm test # Run 312 tests
pnpm test:e2e # E2E tests (needs Canton sandbox)
pnpm verify # Full verification suiteWe welcome contributions. Please open an issue or submit a PR. See ARCHITECTURE.md for code structure overview.
Canton Network mainnet validator. Canton Catalyst 2026 — 1st place winner.
Dual-licensed under Apache 2.0 and MIT. Copyright 2026 Cayvox Labs.