furlpay-cli

@furlpay/cli

在终端中使用 FurlPay：稳定币余额与转账、代币兑换、股票碎股交易、酒店和航班预订、Visa 卡控件、USDC 收益、Webhook 工具——还有交互式仪表盘，以及供 AI Agent 使用的 MCP 服务模式。

零依赖。npx @furlpay/cli 即可立即启动。

技术栈： 纯 Node.js（http/https、readline、crypto——无运行时软件包）、手工编写的 ANSI TUI、用于 MCP 传输的换行符分隔 JSON-RPC 2.0、HMAC-SHA256 Webhook 签名。

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

命令

身份验证与配置

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

钱包与支付

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

投资

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

旅行 · 卡片 · 收益

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

开发者工具

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 服务（AI Agent）

furlpay mcp     # stdio MCP server — 18 tools

在 Claude Code / 任意 MCP 客户端中注册：

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

工具包括 get_balance、send_stablecoin、swap_tokens、get_portfolio、place_order、get_quote、search_travel、book_travel、earn_deposit、set_card_controls、chain_status 等。身份验证会复用 furlpay login 会话；公开工具（市场、链、旅行搜索）无需登录即可使用。

仪表盘

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

键盘快捷键：h 首页 · p 投资组合 · e 收益 · t 交易 · m 市场 · r 刷新 · q 退出。每 20s 自动刷新。

输出格式

每个列表命令都支持 --output json|csv|table（默认为 table）和 --quiet（原始值，每行一个——适用于脚本）。执行更改的命令会提示确认；传入 --yes 可跳过确认（适用于 CI/脚本）。

配置

状态保存在 ~/.furlpay/config.json 中：环境（sandbox/live）、各环境的会话、Webhook 转发目标和签名密钥。--env、--api-base 可按次调用覆盖配置。