mcpField
F
furlpay-cli

furlpay-cli

Local
github.com/FurlPayFinance0Updated 16w ago
Repository

About furlpay-cli

furlpay-cli is a terminal client for FurlPay, for users and developers handling payments, investing, travel bookings, and cards. It also includes an interactive dashboard, webhook tools, and an MCP server mode.

Key features

  1. 01Manage stablecoin balances and transfers
  2. 02Swap and bridge tokens
  3. 03Trade fractional stocks and view portfolios
  4. 04Search and book travel
  5. 05Control cards and USDC yield
  6. 06Forward and test webhooks

Use cases

  1. 01Check balances and send stablecoins from a terminal
  2. 02Place orders and track a portfolio
  3. 03Search flights or hotels and book travel
  4. 04Test webhook events

MCP support

`furlpay mcp` runs an MCP server over stdio with 18 tools, including balance, stablecoin transfer, token swaps, investing, travel, and card controls. It reuses the `furlpay login` session; public tools such as markets, chain status, and travel search work while logged out.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "furlpay-furlpay-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@furlpay/cli"
      ]
    }
  }
}
Run commandnpx -y @furlpay/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@furlpay/cli0.2.2

Tools

18

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

@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.

npm Node.js JavaScript Dependencies MCP USDC License

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.