io.github.FurlPay/furlpay-cli

@furlpay/cli

FurlPay from your terminal: stablecoin balances and transfers, token swaps, fractional stock trading, hotel & flight booking, Visa card controls, USDC yield, webhook tooling — plus an interactive dashboard and an MCP server mode for AI agents.

Zero dependencies. npx @furlpay/cli starts instantly.

Tech stack: pure Node.js (http/https, readline, crypto — no runtime packages), hand-rolled ANSI TUI, newline-delimited JSON-RPC 2.0 for the MCP transport, HMAC-SHA256 webhook signing.

npm install -g @furlpay/cli
furlpay login          # email OTP → session
furlpay dashboard      # interactive TUI

Commands

Auth & config

furlpay login                    # email one-time-code login
furlpay login --key sk_sandbox…  # or store an API/webhook key (dev tooling)
furlpay whoami                   # who am I + environment
furlpay logout
furlpay env sandbox|live         # switch environments (sandbox → localhost:8787)
furlpay config set sandboxUrl http://localhost:3000
furlpay status                   # API + every settlement chain's health

Wallet & payments

furlpay balance [--chain base] [--output json|csv] [--quiet]
furlpay wallet address           # Safe smart account + active modules
furlpay send 25 0xAbc… --token USDC --chain arbitrum   # gas-sponsored; --mfa for ≥$5k
furlpay swap USDT USDC 100 [--to-chain base] [--quote-only]
furlpay bridge 100 --from ethereum --to arbitrum       # CCTP-style route
furlpay tx list [--category swap]
furlpay tx 0xhash…               # on-chain lookup with explorer link

Investing

furlpay invest buy AAPL 50                 # $50 notional (fractional)
furlpay invest sell NVDA 2 --qty           # 2 shares
furlpay invest buy TSLA 100 --type limit --limit-price 380
furlpay invest portfolio                   # holdings + P&L, marked to live quotes
furlpay invest quote AAPL                  # live quote + AI digest + your position
furlpay invest dca create AAPL 50 --cadence week
furlpay market                             # indices + top movers

Travel · Cards · Earn

furlpay travel search --city Tokyo --checkin 2026-08-01 --checkout 2026-08-05 --min-stars 4
furlpay travel flights --from JFK --to NRT --date 2026-08-01
furlpay travel book --amount 450 --name "Park Hyatt" --city Tokyo   # USDC via x402 + cashback
furlpay travel bookings · furlpay travel cancel <id>

furlpay card list · create --type virtual · freeze <id> · unfreeze <id>
furlpay card limits <id> --daily 6000 · card transactions <id>

furlpay earn                     # positions, yield, best APY
furlpay earn apy                 # live Morpho vault APY/TVL table
furlpay earn deposit 500 · earn withdraw 200 · earn history

Developer tools

furlpay listen --forward-to localhost:3000/api/webhooks   # webhook forwarding
furlpay trigger card.transaction.authorized               # signed test events
furlpay events · furlpay logs --tail
furlpay api GET /api/markets/movers                        # raw authenticated calls
furlpay api POST /api/swaps --data '{"fromToken":"USDT","toToken":"USDC","amountIn":10}'
furlpay docs [topic]                                       # docs map + browser
furlpay completion bash|zsh|fish|powershell

MCP server (AI agents)

furlpay mcp     # stdio MCP server — 18 tools

Register in Claude Code / any MCP client:

{ "mcpServers": { "furlpay": { "command": "furlpay", "args": ["mcp"] } } }

Tools include get_balance, send_stablecoin, swap_tokens, get_portfolio, place_order, get_quote, search_travel, book_travel, earn_deposit, set_card_controls, chain_status and more. Auth reuses the furlpay login session; public tools (markets, chain, travel search) work logged out.

Dashboard

furlpay dashboard                # balances · portfolio · earn · transactions
furlpay dashboard --portfolio    # start on the portfolio view

Keyboard: h home · p portfolio · e earn · t transactions · m markets · r refresh · q quit. Auto-refreshes every 20s.

Output formats

Every listing command supports --output json|csv|table (default table) and --quiet (raw values, one per line — for scripts). Mutating commands prompt for confirmation; pass --yes to skip (CI/scripts).

Configuration

State lives in ~/.furlpay/config.json: environment (sandbox/live), per-environment sessions, webhook forward target and signing secret. --env, --api-base override per-invocation.