Skip to main content
The Wallet toolset gives AI agents self-awareness of their cryptographic identity, balances, and operational constraints.

create_wallet

Generate a new Solana keypair stored in the local AES-256-GCM encrypted keystore.
  • Input: label (optional) — human-readable name for the wallet
  • Returns: Wallet ID (UUID), public key, Solana Explorer link
  • Side effects: If a Master Funder is configured, the wallet is automatically seeded with SOL (amount set by AGENT_SEED_SOL)
  • Policy: A default spending policy is attached at creation

list_wallets

Returns all wallets loaded in the current KeyManager.
  • Input: None
  • Returns: Array of { wallet_id, label, publicKey, created_at }

get_balance

Fetches the full balance breakdown for a specific wallet.
  • Input: wallet_id
  • Returns: SOL balance + all SPL token balances (mint address, symbol, human-readable amount)

get_audit_logs

Pulls recent transaction attempts, signatures, and policy engine decisions.
  • Input: wallet_id (optional — omit for global logs)
  • Returns: Array of log entries with timestamp, action, outcome, and transaction signature

get_status

Returns system telemetry for the MCP server.
  • Input: None
  • Returns: Solana cluster, RPC URL, Kora availability, Master Funder status, total managed wallets

get_policy

Retrieves the active spending policy and current usage counters.
  • Input: wallet_id (optional)
  • Returns: Per-transaction limit, daily cap, hourly rate limit, consumed amounts, whitelist status