Command reference for kobaru-mcp, the CLI that connects AI agents to paid APIs through Effortless MCP. Install globally:All commands accept --help for inline usage.
Contents#
setup — Interactive wizard add — Register a merchant remove — Unregister a merchant list — Show registered merchants status — Wallet address and balance
setup#
Interactive wizard that configures everything in one flow: merchant installation, AI client integration, wallet provider, wallet creation, and spending budget.Pass a target to skip the merchant prompt:| Flag | Description |
|---|
--skip-ai | Skip AI client integration |
--skip-wallet | Skip wallet creation |
--skip-budget | Skip budget configuration |
--skip-merchant | Skip merchant installation |
-f, --force | Re-run all stages even if already configured |
The wizard detects your AI client (Claude Code, Cursor, Windsurf, Codex, OpenCode, Claude Desktop, Gemini CLI, Antigravity) and writes the MCP config to the correct file automatically. If your client is not listed, the wizard prints manual setup instructions.During budget configuration, the wizard prompts for three independent limits: per-request max, daily max, and lifetime total. You can set any combination of these.
add#
Register a merchant as an MCP server in your AI client's config. Aliases: install, in.If you add a merchant-level entry while individual service entries exist, the CLI prompts you to replace them. Restart your AI client after adding a merchant.
remove#
Remove a merchant from your AI client's config. Aliases: rm, delete, del.If multiple service entries exist for a merchant, the CLI prompts you to choose which to remove or remove all at once.
list#
List all registered Kobaru MCP servers. Aliases: ls.
upgrade#
Refresh tool definitions from the Kobaru directory without reinstalling. Aliases: update, up.
status#
Show wallet provider, address, network, and USDC balance.| Flag | Description |
|---|
--json | Output as JSON |
Provider: builtin
Address: 0x1234...abcd
Network: SKALE Base Sepolia (eip155:324705682)
Balance: 5.00 USDC
wallet init#
Create a payment wallet. The private key is encrypted and stored locally in ~/.kobaru/.| Flag | Default | Description |
|---|
--wallet <provider> | builtin | builtin or coinbase |
--network <caip2> | eip155:324705682 | Network identifier (see Networks) |
--mode <mode> | machine-bound | Encryption: machine-bound, password, or env-injected |
--keychain | — | Store key in OS keychain instead of encrypted file |
--force | — | Overwrite an existing wallet |
The --keychain and --mode flags are mutually exclusive.Coinbase AWAL users: This command directs you to npx awal for wallet setup.
wallet fund#
Display the wallet address so you can send USDC to it.Send USDC on the same network your wallet is configured for (SKALE Base Sepolia by default — gasless, you only need USDC).Coinbase AWAL users: This command directs you to Coinbase's funding tools.
wallet info#
Show wallet address, network, key storage method, and encryption mode.| Flag | Description |
|---|
--json | Output as JSON |
Address: 0x1234...abcd
Network: SKALE Base Sepolia (eip155:324705682)
Key storage: OS keychain
wallet budget set#
Set the daily spending limit in USDC.| Argument | Description |
|---|
<amount> | Daily limit in USDC (must be a positive number) |
To configure per-request and lifetime limits, use the setup wizard (kobaru-mcp setup), which prompts for all three limit types.Daily limits reset at midnight UTC.Coinbase AWAL users: Budgets are managed by Coinbase. This command directs you to npx awal.
wallet budget status#
Show daily limit, amount spent today, remaining budget, and transaction count.| Flag | Description |
|---|
--json | Output as JSON |
Daily limit: 5.00 USDC
Today spent: 1.25 USDC (3 transactions)
Remaining: 3.75 USDC
Coinbase AWAL users: This command directs you to npx awal.
wallet migrate#
Move your private key between storage backends.If the current wallet uses password encryption, the CLI prompts for the password before migrating.| Flag | Default | Description |
|---|
--mode <mode> | machine-bound | Encryption mode: machine-bound or password |
Wallet providers#
| Provider | Key management | Networks | Budget control |
|---|
| Kobaru Wallet (default) | Local encrypted file or OS keychain | SKALE Base Sepolia, SKALE Base, Base Mainnet, Base Sepolia | CLI (wallet budget set) |
| Coinbase AWAL | Coinbase-managed | Base Mainnet, Base Sepolia | Coinbase infrastructure |
Choose your provider during kobaru-mcp setup or with kobaru-mcp wallet init --wallet <provider>. For a detailed comparison, see Wallet providers.Both providers are transparent to AI agents — the same MCP tools work regardless of which wallet you use.
Networks#
| Network | ID | Gas | Notes |
|---|
| SKALE Base Sepolia | eip155:324705682 | Free | Default. Testnet. |
| SKALE Base | eip155:1187947933 | Free | Mainnet. |
| Base Mainnet | eip155:8453 | ~$0.001 | Requires ETH for gas. |
| Base Sepolia | eip155:84532 | ~$0.001 | Testnet. Requires ETH for gas. |
Set the network during wallet creation:
Environment variables#
| Variable | Description |
|---|
KOBARU_WALLET_KEY | Base64-encoded encryption key for env-injected mode. |
KOBARU_PRIVATE_KEY | Hex-encoded private key (0x + 64 hex). Bypasses all wallet encryption. |
KOBARU_BASE_RPC_URL | Custom RPC endpoint for Base Mainnet. |
KOBARU_BASE_SEPOLIA_RPC_URL | Custom RPC endpoint for Base Sepolia. |
Modified at 2026-02-25 19:28:00
