{
  "mcpServers": {
    "karen": {
      "command": "npx",
      "args": ["tsx", "path/to/karen/src/mcp/server.ts"]
    }
  }
}

interface CreateWalletResponse {
  walletId: string
  name: string
  address: string
  message: string
}

{
  "name": "karen_create_wallet",
  "arguments": {
    "name": "my-trading-wallet"
  }
}

interface BalanceResponse {
  wallet: string
  address: string
  sol: number
  tokens: TokenBalance[]
}

interface TokenBalance {
  mint: string
  symbol?: string
  balance: number
  decimals: number
  uiBalance: number
}

interface WalletInfo {
  id: string
  name: string
  publicKey: string
  createdAt: string
  derivationIndex?: number
  tags: string[]
}

interface TransferResponse {
  status: 'confirmed' | 'failed' | 'blocked'
  signature?: string
  error?: string
  guardrails: string[]
}

{
  "name": "karen_swap",
  "arguments": {
    "walletId": "abc-123",
    "inputToken": "SOL",
    "outputToken": "USDC",
    "amount": 0.5,
    "slippageBps": 50
  }
}

interface TransactionRecord {
  id: string
  walletId: string
  agentId?: string
  type: TransactionType
  status: 'pending' | 'confirmed' | 'failed' | 'blocked'
  signature?: string
  details: TransactionDetails
  guardrailsApplied: string[]
  timestamp: string
  error?: string
}