표준화된 MCP 인터페이스를 통해 AI agent가 Stellar 기반 거래를 실행하고, 토큰화된 주식을 관리하며, x402 micropayments를 결제할 수 있도록 지원합니다.
다른 이름 FurlPay/furlpay-cli, @furlpay/cli
- 스타
- 0
- Tools
- 7
- 다운로드, 30일
- 247
- 최신 버전
- 0.2.2
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- MIT
furlpay-cli MCP란?
furlpay-cli은(는) MCP server입니다. 표준화된 MCP 인터페이스를 통해 AI agent가 Stellar 기반 거래를 실행하고, 토큰화된 주식을 관리하며, x402 micropayments를 결제할 수 있도록 지원합니다. 7개 도구를 제공합니다. 예: furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade.
프로젝트 README에서 생성된 요약
furlpay-cli MCP server 정보
FurlPay CLI는 개발자와 자율형 AI agent가 Stellar 네트워크와 상호작용할 수 있는 고성능 실행 레이어를 제공합니다. 표준화된 Model Context Protocol 인터페이스를 통해 토큰화된 주식 및 실물 자산(RWA) 관리를 가능하게 합니다. 사용자는 Ledger 하드웨어 wallet, WalletConnect를 통한 모바일 wallet, 브라우저 extension 등 다양한 wallet 유형을 연결하여 안전한 트랜잭션을 수행할 수 있습니다.
이 시스템은 Stellar Decentralized Exchange에서 지정가 주문을 실행하거나 Soroban AMM pool을 통해 유동성을 라우팅하는 등 복잡한 거래 활동을 지원합니다. 또한 TigerBeetle 내부 네팅 sub-ledger를 사용한 x402 micropayments 결제와 SEP-8 규정을 준수하는 규제 자산 관리 기능을 포함합니다. AI agent는 특정 지출 정책이 적용된 위임된 session key를 사용하여 자금 관리(treasury sweeping)나 인보이스 결제와 같은 자율적인 작업을 수행할 수 있습니다.
이 도구는 Claude, Cursor 또는 Gemini와 같은 AI runtime에 통합되도록 설계되었습니다. server를 stdio 모드로 실행하면 agent는 OFAC 체크 및 거래 속도 제한과 같은 안전 제약 조건을 준수하면서 금융 운영을 위한 특정 도구에 접근할 수 있습니다.
활용 사례
- 1micropayment 문제 해결AI agent가 정책 한도를 확인하고 내부 ledger를 통해 결제함으로써 HTTP 402 결제 요청을 해결할 수 있습니다.
- 2자금 수익률 관리 자동화개발자가 agent에게 유휴 자금을 머니마켓 펀드로 이동시켜 온체인 수익을 창출하도록 지시할 수 있습니다.
- 3규제 자산 거래 실행사용자는 발행사 요구 사항을 준수하면서 JQQQ와 같은 토큰화된 주식에 대한 지정가 주문을 수행할 수 있습니다.
- 4자율형 agent 권한 관리개발자는 AI agent가 특정 자산과 일일 지출 한도 내에서만 활동하도록 제한하는 일시적인 session key를 생성할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
furlpay-cli MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 furlpay-cli MCP 설치
$ claude mcp add furlpay-cli -- npx -y @furlpay/cliCursor에 furlpay-cli MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}VS Code에 furlpay-cli MCP 설치
.vscode/mcp.json
{
"servers": {
"furlpay-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}VS Code CLI에 furlpay-cli MCP 설치
$ code --add-mcp '{"name":"furlpay-cli","type":"stdio","command":"npx","args":["-y","@furlpay/cli"]}'Claude Desktop에 furlpay-cli MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}Codex에 furlpay-cli MCP 설치
$ codex mcp add furlpay-cli -- npx -y @furlpay/cliCodex config.toml에 furlpay-cli MCP 설치
~/.codex/config.toml
[mcp_servers.furlpay-cli] command = "npx" args = ["-y", "@furlpay/cli"]
Gemini CLI에 furlpay-cli MCP 설치
$ gemini mcp add -s user furlpay-cli npx -- -y @furlpay/cliGemini settings.json에 furlpay-cli MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}furlpay-cli MCP 도구 7
README에서 감지됨furlpay_settle_invoicefurlpay_sweep_treasuryfurlpay_tradefurlpay_trade_perpfurlpay_get_hlp_yieldfurlpay_balancefurlpay_get_quote
| furlpay_settle_invoice | — | |
| furlpay_sweep_treasury | — | |
| furlpay_trade | — | |
| furlpay_trade_perp | — | |
| furlpay_get_hlp_yield | — | |
| furlpay_balance | — | |
| furlpay_get_quote | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능furlpay/furlpay-cli is public and reachablegithub.com/furlpay/furlpay-cli ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/furlpay/furlpay-cli ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @furlpay/cli통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음1 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음7 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기@furlpay/cli
FurlPay CLI — Stellar Tokenized Equities & RWAs, SDEX/Soroban Trading, x402 Micropayments & MCP Server.
High-performance terminal execution layer written in TypeScript for connecting Stellar hardware wallets, executing limit orders on the Stellar Decentralized Exchange (SDEX), routing cross-asset liquidity through Soroban AMMs, verifying SEP-8 compliance on regulated tokenized equities (JQQQ, Securitize NVDA) and money market funds (FOBXX, USTBL), settling x402 micropayments, and running autonomous Model Context Protocol (MCP) agent trading runtimes.
npm install -g @furlpay/cli
furlpay wallet connect ledger
furlpay trade terminal --pair JQQQ/USDC
System Architecture
1. End-to-End System Architecture
graph TD
subgraph ClientAndRuntimes["Client and Agent Runtimes"]
TUI["Interactive Terminal UI (ratatui/crossterm style ANSI)"]
Headless["Headless Scripting and CI Automation"]
AgentRuntime["Autonomous AI Agent (Claude, Cursor, Gemini MCP)"]
end
subgraph CoreEngine["FurlPay CLI Core (TypeScript Engine)"]
WalletLayer["Wallet Connector Layer (Ledger, SEP-7, Loopback, Keystore, AgentKey)"]
SOR["Smart Order Router (SDEX CLOB + Soroban AMM + Path Payments)"]
Compliance["SEP-8 and Compliance Engine (KYC Whitelist and Co-Signer)"]
AgentTrust["Agent Trust Engine (OFAC/SDN, Velocity and Spend Limits)"]
end
subgraph RelayerAndGateway["FurlPay Relayer and Settlement Gateway"]
Sponsor["Fee-Bump Relayer (Gasless Zero-XLM Trading UX)"]
TigerBeetle["TigerBeetle Internal Netting Sub-Ledger (x402 Micropayments)"]
end
subgraph SettlementLayer["Stellar Network (Protocol 26 Settlement)"]
SDEX["SDEX Central Limit Order Books (MEV-Free SCP Shuffling)"]
Soroban["Soroban Smart Contract AMMs (SEP-41 Token Pools)"]
SAC["Soroban SAC RWA Contracts (FOBXX Benji, JQQQ, USTBL)"]
end
TUI --> WalletLayer
Headless --> WalletLayer
AgentRuntime --> AgentTrust
AgentTrust --> WalletLayer
WalletLayer --> SOR
SOR --> Compliance
Compliance --> Sponsor
AgentTrust --> TigerBeetle
Sponsor --> SDEX
Sponsor --> Soroban
Sponsor --> SAC
2. Multi-Interface Wallet Connectivity Topology
graph TD
subgraph CustodyAndInterfaces["Wallet Custody and Interface Layer"]
Ledger["1. Ledger Hardware Wallet (Nano S / X / Stax via APDU USB HID)"]
Mobile["2. Mobile Wallets via SEP-0007 and WalletConnect v2 (Terminal ASCII QR)"]
Loopback["3. Browser Extension Loopback (Freighter and Albedo on 127.0.0.1:4024)"]
Keystore["4. Local Encrypted Keystore (BIP-39 / PBKDF2 / AES-256-GCM)"]
AgentKey["5. Delegated Agent Session Key (Ephemeral Ed25519 with Policy Limit)"]
end
subgraph SignerAbstractionLayer["Signer Abstraction Layer (ISigner)"]
Signer["Signer Trait Interface: getPublicKey, signTransaction, clearSignVerification"]
end
subgraph TradePipeline["Transaction and Execution Pipeline"]
Builder["Stellar Transaction and Fee-Bump Envelope Builder"]
end
Ledger --> Signer
Mobile --> Signer
Loopback --> Signer
Keystore --> Signer
AgentKey --> Signer
Signer --> Builder
3. Trade Execution, Smart Order Routing & SEP-8 Compliance Lifecycle
flowchart TD
UserReq["Trade Request: furlpay trade buy/limit/swap"] --> SOR["Smart Order Router (SOR)"]
SOR --> SDEX_Check["Evaluate SDEX Central Limit Order Book"]
SOR --> AMM_Check["Evaluate Soroban AMM Pools (SEP-41)"]
SOR --> Path_Check["Evaluate Cross-Asset Path Payment Multi-Hop Graph"]
SDEX_Check --> BestRoute["Select Optimal Route with Minimum Slippage"]
AMM_Check --> BestRoute
Path_Check --> BestRoute
BestRoute --> RegCheck{"Regulated Asset? (e.g. JQQQ, FOBXX)"}
RegCheck -- "Yes (AUTHORIZATION_REQUIRED)" --> SEP8_Query["Query Issuer stellar.toml Approval Server"]
SEP8_Query --> SEP8_Submit["Pre-flight submit partially signed XDR"]
SEP8_Submit --> KYC_Gate{"KYC Whitelist Verified?"}
KYC_Gate -- "Approved" --> SEP8_Attach["Attach Issuer Multi-Sig Co-Signature"]
KYC_Gate -- "Action Required" --> KYC_Prompt["Return Interactive KYC Onboarding URL"]
RegCheck -- "No (Standard SAC)" --> SponsorCheck{"--sponsor flag passed?"}
SEP8_Attach --> SponsorCheck
SponsorCheck -- "Yes" --> FeeBump["Wrap into Stellar FeeBumpTransaction (Paid by FurlPay Vault)"]
SponsorCheck -- "No" --> UserFee["User Pays Native XLM Inclusion Fee"]
FeeBump --> StellarCore["Stellar Core Consensus (SCP 5s Block)"]
UserFee --> StellarCore
StellarCore --> Settlement["Finalized Settlement: Randomized Execution and Uniform Price"]
4. Autonomous Agent MCP & x402 Micropayments Workflow
sequenceDiagram
autonumber
actor Agent as Autonomous AI Agent (Claude / Cursor / Gemini)
participant MCP as FurlPay MCP Server (stdio)
participant Trust as Agent Trust Engine
participant TB as TigerBeetle Sub-Ledger
participant Stellar as Stellar Network (Protocol 26)
Note over Agent,MCP: Machine-to-Machine Commerce / x402 Resolution
Agent->>MCP: tools/call: furlpay_settle_invoice { challengeHeader, maxCost }
MCP->>Trust: Validate Policy (OFAC/SDN check, singleTxCap, dailyVelocity)
Trust-->>MCP: Policy Approved (Clean sanctions score, budget available)
MCP->>TB: Internal Netting Ledger Transfer (<$0.0001 cost, <1ms)
TB-->>MCP: Settle Tx furlpay_net_991823
MCP-->>Agent: { status: "SETTLED", authHeader: "Authorization: x402 ..." }
Note over Agent,MCP: Automated Idle Treasury Yield Sweeping
Agent->>MCP: tools/call: furlpay_sweep_treasury { amountUsd: 450.00 }
MCP->>Stellar: Soroban SAC Deposit into Franklin FOBXX (Benji) Contract
Stellar-->>MCP: Shares Minted (4.85% APY On-Chain Yield)
MCP-->>Agent: { status: "SUCCESS", shares_minted: "450.00", apy: "4.85%" }
Stellar Commands Reference
1. Stellar Wallet & Hardware Custody (furlpay wallet)
# Connect Ledger Nano S/X/Stax over USB HID (derivation: m/44'/148'/0')
furlpay wallet connect ledger --derivation-index 0
# Connect mobile wallets via SEP-0007 / WalletConnect v2 (displays high-contrast ASCII QR)
furlpay wallet connect walletconnect --qr
furlpay wallet connect sep7
# Browser loopback bridge on 127.0.0.1:4024 for Freighter & Albedo extension
furlpay wallet connect extension --port 4024
# Generate delegated session key for autonomous AI agent with spending policy cap
furlpay wallet agent-keygen \
--name agent-alpha \
--daily-limit 50.00 \
--allowed-assets USDC,JQQQ,FOBXX \
--expiry 7d
# Import private key or 12/24-word mnemonic into PBKDF2/AES-256-GCM encrypted keystore
furlpay wallet import --name desk-primary --mnemonic
furlpay wallet list
2. SDEX & Soroban Trading Execution (furlpay trade)
# SDEX Central Limit Buy Order for Janus Henderson Nasdaq-100 (JQQQ) with gasless sponsorship
furlpay trade limit \
--side buy \
--asset JQQQ:GDXFE4P76X667RKYHVMZ4H5XQWPLK3X72Z7YXZGHK8R5M7OQ3V7QJQQQ \
--against USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN \
--amount 25 \
--price 104.20 \
--sponsor
# Path payment strict send (market buy) with guaranteed dest_min and zero MEV
furlpay trade market-buy \
--asset JQQQ:GDXFE4P76X667RKYHVMZ4H5XQWPLK3X72Z7YXZGHK8R5M7OQ3V7QJQQQ \
--with USDC \
--spend 1000.00 \
--slippage 0.5 \
--sponsor
# Soroban AMM SEP-41 liquidity pool swap with pre-flight gas simulation
furlpay trade swap \
--pool-id 7c8e99...SOROBAN_AMM \
--sell-asset USDC \
--sell-amount 500 \
--min-receive 4.88 \
--asset FOBXX
# Interactive real-time ASCII depth chart & order book
furlpay trade terminal --pair JQQQ/USDC
3. Order Management (furlpay order)
# List resting open limit orders
furlpay order list --pair JQQQ/USDC
# Inspect specific SDEX order
furlpay order inspect --offer-id 8829104
# Gasless cancellation via Fee-Bump Relayer
furlpay order cancel --offer-id 8829104 --sponsor
# Batch cancel all resting offers for a pair
furlpay order cancel-all --pair NVDA/USDC
4. Tokenized Stocks & RWAs (furlpay rwa)
# List institutional tokenized equities and money market funds
furlpay rwa list --category equities,treasuries
# Inspect SEP-8 compliance parameters and SEC CIK registry details
furlpay rwa inspect --asset JQQQ
furlpay rwa inspect --asset FOBXX
# Initiate or refresh accredited investor KYC verification
furlpay rwa kyc --asset FOBXX --interactive
5. HTTP 402 Micropayments (furlpay x402)
# Settle an HTTP 402 payment challenge via TigerBeetle sub-ledger (<$0.0001 cost)
furlpay x402 pay \
--challenge-header 'WWW-Authenticate: x402 recipient="GBLX99API", amount="0.0005", token="USDC"' \
--max-cost 0.005
6. Hyperliquid L1 Perpetuals & Microstructure (furlpay hyperliquid, furlpay market)
# Check Hyperliquid validator connectivity, active universe, and canonical HLP vault
furlpay hyperliquid status
# List tradeable perpetual contracts with mark price, funding rate, and open interest
furlpay hyperliquid markets
# Realtime L2 order book, depth bands (10/25/50 bps), OFI, micro-price, and slippage
furlpay market BTC
furlpay market BTC --slippage 0.5 --side buy
# Execute authenticated L1 perpetual order via EIP-712 Phantom Agent
furlpay hyperliquid trade --symbol BTC --side buy --size 0.05 --leverage 5 --limit 75000
# Inspect account equity, margin ratio, unrealized PnL, and open positions
furlpay account balance
furlpay account positions
# Manage pre-trade risk controls and emergency kill-switch
furlpay trading limits --max-single-order 50000 --max-leverage 20
furlpay trading kill-switch --symbol BTC
# Inspect and deposit into HLP clearinghouse vault (with 4-day lockup notification)
furlpay earn hlp stats
furlpay earn hlp deposit 1000
7. Escrow & Time-Locked Settlement Scheme (furlpay escrow)
# Create deterministic cryptographic delivery escrow with SHA-256 proof hash
furlpay escrow create \
--seller 0x70997970C51812dc3A010C7d01b50e0d17dc79C8 \
--arbiter 0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC \
--amount 5000 \
--timeout-days 7 \
--proof-hash 0x2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824
# Fund escrow
furlpay escrow fund --id escrow_1710000000000
# Submit delivery proof and release funds
furlpay escrow release --id escrow_1710000000000 --preimage "invoice_fulfillment_secret_123"
Model Context Protocol (MCP) AI Agents
The CLI provides a standardized STDIO MCP server for Claude, Cursor, Gemini, and autonomous AI trading agents:
furlpay mcp --wallet agent-alpha
Add to your MCP configuration (claude_desktop_config.json / Cursor):
{
"mcpServers": {
"furlpay-execution": {
"command": "furlpay",
"args": ["mcp", "--wallet", "agent-alpha"]
}
}
}
Exposed MCP Tools:
furlpay_settle_invoice: Settle x402 payment challenges with Agent Trust Engine policy checks (OFAC/SDN check, velocity limit, spend caps).furlpay_sweep_treasury: Detect idle USDC and sweep into Franklin Templeton FOBXX (Benji) yield on Soroban or Hyperliquid HLP.furlpay_trade: Execute limit orders, path payments, or AMM swaps with delegated budget enforcement on Stellar.furlpay_trade_perp: Execute perpetual futures orders on Hyperliquid L1 (BTC-PERP, ETH-PERP, NVDA-PERP, HYPE-PERP).furlpay_get_hlp_yield: Query live performance, share price, and 30-day trailing APY for Hyperliquid HLP vault.furlpay_balance: Query balances across Stellar native assets, USDC, and tokenized RWAs.furlpay_get_quote: Retrieve optimal multi-hop quotes across SDEX and Soroban AMMs.
Multi-Chain Payments & Banking (Original Suite)
# Session & Account
furlpay login # email OTP login
furlpay whoami # active session and Safe address
furlpay balance # token balances across Arbitrum, Base, Optimism, Ethereum
# A2A Transfers & Payments
furlpay pay @recipient 10 usd # instant zero-fee transfer to verified handle
furlpay send 25 0xAbc... --token USDC --chain arbitrum
furlpay swap USDT USDC 100
furlpay bridge 100 --from eth --to arb
# Fractional Stocks & Travel
furlpay invest buy AAPL 50
furlpay travel search --city Tokyo --min-stars 4
furlpay dashboard
License
MIT © FurlPay Protocol & Systems Engineering Group.
furlpay-cli MCP 질문
furlpay-cli MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add furlpay-cli -- npx -y @furlpay/cli를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
furlpay-cli MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
furlpay-cli MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade, furlpay_trade_perp, furlpay_get_hlp_yield.
Claude 또는 Cursor와 같은 AI agent에서 FurlPay를 어떻게 사용하나요?
CLI를 MCP 모드로 실행하여 자율형 agent를 위한 표준 STDIO server를 제공할 수 있습니다.
FurlPay로 어떤 종류의 자산을 거래할 수 있나요?
Stellar 토큰화 주식, 머니마켓 펀드, stablecoins, Hyperliquid의 perpetual contracts를 지원합니다.
FurlPay는 하드웨어 wallet 연결을 지원하나요?
네, USB HID를 통해 Ledger 하드웨어 wallet(Nano S / X / Stax) 연결을 지원합니다.
AI agent에 지출 한도를 설정할 수 있나요?
네, 특정 일일 한도와 허용 자산이 지정된 위임된 session key를 생성할 수 있습니다.