Permite que los agentes de IA ejecuten operaciones basadas en Stellar, gestionen acciones tokenizadas y liquiden micropagos x402 a través de una interfaz MCP estandarizada.
También conocido como FurlPay/furlpay-cli, @furlpay/cli
- Stars
- 0
- Herramientas
- 7
- Descargas, 30 días
- 247
- Última versión
- 0.2.2
- Último commit
- 15 nov 2026
- Licencia
- MIT
¿Qué es furlpay-cli MCP?
furlpay-cli es un MCP server. Permite que los agentes de IA ejecuten operaciones basadas en Stellar, gestionen acciones tokenizadas y liquiden micropagos x402 a través de una interfaz MCP estandarizada. Expone 7 herramientas, como furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade.
Resumen generado a partir del README del proyecto
Acerca del MCP server de furlpay-cli
FurlPay CLI proporciona una capa de ejecución de alto rendimiento para que desarrolladores y agentes de IA autónomos interactúen con la red Stellar. Permite la gestión de acciones tokenizadas y activos del mundo real a través de una interfaz estandarizada de Model Context Protocol.
El sistema admite actividades de trading complejas, como la ejecución de órdenes limitadas en el Stellar Decentralized Exchange y el enrutamiento de liquidez a través de pools de Soroban AMM. Incluye herramientas especializadas para liquidar micropagos x402 utilizando un sub-ledger de compensación interna de TigerBeetle y para gestionar activos regulados con cumplimiento SEP-8. Los agentes de IA pueden utilizar session keys delegadas con políticas de gasto específicas para realizar tareas autónomas como el barrido de tesorería o la liquidación de facturas.
Esta herramienta está diseñada para integrarse en entornos de ejecución de IA como Claude, Cursor o Gemini. Al ejecutar el servidor en modo stdio, los agentes obtienen acceso a herramientas específicas para operaciones financieras mientras cumplen con restricciones de seguridad como controles de OFAC y límites de velocidad.
Qué puedes hacer con él
- 1Liquidar desafíos de micropagosUn agente de IA puede resolver solicitudes de pago HTTP 402 verificando los límites de las políticas y liquidando a través de un ledger interno.
- 2Automatizar la gestión de rendimiento de tesoreríaUn desarrollador puede instruir a un agente para mover fondos inactivos hacia fondos del mercado monetario para obtener rendimiento on-chain.
- 3Ejecutar operaciones con activos reguladosLos usuarios pueden realizar órdenes limitadas para acciones tokenizadas como JQQQ asegurando el cumplimiento de los requisitos del emisor.
- 4Gestionar permisos de agentes autónomosLos desarrolladores pueden crear session keys efímeras que restrinjan a un agente de IA a activos específicos y topes de gasto diarios.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar furlpay-cli MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar furlpay-cli MCP en Claude Code
$ claude mcp add furlpay-cli -- npx -y @furlpay/cliInstalar furlpay-cli MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}Instalar furlpay-cli MCP en VS Code
.vscode/mcp.json
{
"servers": {
"furlpay-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}Instalar furlpay-cli MCP en VS Code CLI
$ code --add-mcp '{"name":"furlpay-cli","type":"stdio","command":"npx","args":["-y","@furlpay/cli"]}'Instalar furlpay-cli MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}Instalar furlpay-cli MCP en Codex
$ codex mcp add furlpay-cli -- npx -y @furlpay/cliInstalar furlpay-cli MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.furlpay-cli] command = "npx" args = ["-y", "@furlpay/cli"]
Instalar furlpay-cli MCP en Gemini CLI
$ gemini mcp add -s user furlpay-cli npx -- -y @furlpay/cliInstalar furlpay-cli MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}Herramientas de furlpay-cli MCP 7
Detectado desde el READMEfurlpay_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 | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblefurlpay/furlpay-cli is public and reachablegithub.com/furlpay/furlpay-cli ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/furlpay/furlpay-cli ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @furlpay/cliAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre furlpay-cli MCP
¿Cómo agrego furlpay-cli MCP a Claude Code?
Ejecuta claude mcp add furlpay-cli -- npx -y @furlpay/cli en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego furlpay-cli MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona furlpay-cli MCP?
Expone 7 herramientas, incluidas furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade, furlpay_trade_perp, furlpay_get_hlp_yield.
¿Cómo puedo usar FurlPay con un agente de IA como Claude o Cursor?
Puedes ejecutar la CLI en modo MCP para proporcionar un servidor stdio estandarizado para agentes autónomos.
¿Qué tipo de activos puedo operar con FurlPay?
La plataforma admite acciones tokenizadas en Stellar, fondos del mercado monetario, stablecoins y contratos perpetuos en Hyperliquid.
¿FurlPay es compatible con la conectividad de hardware wallets?
Sí, es compatible con la conexión de hardware wallets Ledger (Nano S / X / Stax) a través de USB HID.
¿Puedo establecer límites de gasto para mi agente de IA?
Sí, puedes generar una session key delegada con límites diarios específicos y activos permitidos.