Ermöglicht es AI-Agenten, Trades auf Stellar-Basis auszuführen, tokenisierte Aktien zu verwalten und x402-Mikrozahlungen über eine standardisierte MCP-Schnittstelle abzuwickeln.
Auch bekannt als FurlPay/furlpay-cli, @furlpay/cli
- Stars
- 0
- Tools
- 7
- Downloads, 30 Tage
- 247
- Neueste Version
- 0.2.2
- Letzter Commit
- 15. Nov. 2026
- Lizenz
- MIT
Was ist furlpay-cli MCP?
furlpay-cli ist ein MCP server. Ermöglicht es AI-Agenten, Trades auf Stellar-Basis auszuführen, tokenisierte Aktien zu verwalten und x402-Mikrozahlungen über eine standardisierte MCP-Schnittstelle abzuwickeln. Er stellt 7 Tools bereit, etwa furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade.
Zusammenfassung generiert aus dem README des Projekts
Über furlpay-cli MCP server
Das FurlPay CLI bietet eine leistungsstarke Execution Layer für Entwickler und autonome AI-Agenten, um mit dem Stellar-Netzwerk zu interagieren. Es ermöglicht die Verwaltung von tokenisierten Aktien und Real-World-Assets über eine standardisierte Model Context Protocol Schnittstelle. Nutzer können verschiedene Wallet-Typen verbinden, einschließlich Ledger Hardware-Wallets, Mobile Wallets via WalletConnect und Browser-Extensions, um sichere Transaktionen zu ermöglichen.
Das System unterstützt komplexe Trading-Aktivitäten wie das Ausführen von Limit Orders auf der Stellar Decentralized Exchange und das Routing von Liquidität durch Soroban AMM Pools. Es enthält spezialisierte Tools für die Abwicklung von x402-Mikrozahlungen unter Verwendung eines TigerBeetle internen Netting-Sub-Ledgers sowie die Verwaltung regulierter Assets mit SEP-8 Compliance. AI-Agenten können delegierte Session Keys mit spezifischen Spending-Policies nutzen, um autonome Aufgaben wie Treasury Sweeping oder die Begleichung von Rechnungen durchzuführen.
Dieses Tool ist für die Integration in AI-Runtimes wie Claude, Cursor oder Gemini konzipiert. Durch das Ausführen des Servers im stdio-Modus erhalten Agenten Zugriff auf spezifische Tools für Finanzoperationen, während Sicherheitsbeschränkungen wie OFAC-Checks und Velocity Limits eingehalten werden.
Was du damit machen kannst
- 1Mikrozahlungs-Herausforderungen lösenEin AI-Agent kann HTTP 402 Zahlungsanfragen lösen, indem er Policy-Limits überprüft und die Zahlung über ein internes Ledger abwickelt.
- 2Treasury Yield Management automatisierenEin Entwickler kann einen Agenten anweisen, ungenutzte Mittel in Geldmarktfonds zu verschieben, um On-Chain-Renditen zu erzielen.
- 3Handel mit regulierten Assets ausführenNutzer können Limit Orders für tokenisierte Aktien wie JQQQ ausführen und dabei die Compliance mit den Anforderungen der Emittenten sicherstellen.
- 4Berechtigungen für autonome Agenten verwaltenEntwickler können kurzlebige Session Keys erstellen, die einen AI-Agenten auf bestimmte Assets und tägliche Ausgabenlimits beschränken.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du furlpay-cli MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenfurlpay-cli MCP in Claude Code installieren
$ claude mcp add furlpay-cli -- npx -y @furlpay/clifurlpay-cli MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}furlpay-cli MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"furlpay-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}furlpay-cli MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"furlpay-cli","type":"stdio","command":"npx","args":["-y","@furlpay/cli"]}'furlpay-cli MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}furlpay-cli MCP in Codex installieren
$ codex mcp add furlpay-cli -- npx -y @furlpay/clifurlpay-cli MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.furlpay-cli] command = "npx" args = ["-y", "@furlpay/cli"]
furlpay-cli MCP in Gemini CLI installieren
$ gemini mcp add -s user furlpay-cli npx -- -y @furlpay/clifurlpay-cli MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"furlpay-cli": {
"command": "npx",
"args": [
"-y",
"@furlpay/cli"
]
}
}
}furlpay-cli MCP tools 7
Erkannt aus dem 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 | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarfurlpay/furlpay-cli is public and reachablegithub.com/furlpay/furlpay-cli ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/furlpay/furlpay-cli ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @furlpay/cliBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen@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 Fragen
Wie füge ich furlpay-cli MCP zu Claude Code hinzu?
Führe claude mcp add furlpay-cli -- npx -y @furlpay/cli in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich furlpay-cli MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet furlpay-cli MCP?
Er stellt 7 Tools bereit, darunter furlpay_settle_invoice, furlpay_sweep_treasury, furlpay_trade, furlpay_trade_perp, furlpay_get_hlp_yield.
Wie kann ich FurlPay mit einem AI-Agenten wie Claude oder Cursor nutzen?
Du kannst das CLI im MCP-Modus ausführen, um einen standardisierten STDIO-Server für autonome Agenten bereitzustellen.
Welche Arten von Assets kann ich mit FurlPay handeln?
Die Plattform unterstützt tokenisierte Aktien auf Stellar, Geldmarktfonds, Stablecoins und Perpetual Contracts auf Hyperliquid.
Unterstützt FurlPay die Anbindung von Hardware-Wallets?
Ja, es unterstützt die Verbindung von Ledger Hardware-Wallets (Nano S / X / Stax) via USB HID.
Kann ich Ausgabenlimits für meinen AI-Agenten festlegen?
Ja, du kannst einen delegierten Session Key mit spezifischen Tageslimits und erlaubten Assets generieren.