FibX

Run directly withnpx(no install needed):

Step 1: Get a Price Quote (no auth needed)

Try FibX instantly — no sign-up, no wallet, no keys:

npx fibx quote 0.01 ETH USDC # Check price on Base npx fibx quote 100 USDC DAI --chain base # Compare pairs npx fibx quote 0.5 MON USDC --chain monad # Check Monad prices

Option A — Email Login(Privy Server Wallet, no keys to manage):

npx fibx auth login you@email.com # Sends OTP to your email npx fibx auth verify you@email.com 123456 # Verify & create wallet

Option B — Import Private Key(use an existing wallet):

npx fibx auth import # Paste your key (encrypted at rest)

npx fibx trade 0.01 ETH USDC # Execute the swap npx fibx balance # Check your balances

That's it. Three steps from zero to first swap.

# Email OTP (uses Privy server wallet) npx fibx auth login user@example.com npx fibx auth verify user@example.com 123456 # Or import a private key (local signing, no server needed) npx fibx auth import # Check session status npx fibx status # Logout npx fibx auth logout

Security:When usingauth import, your private key is encrypted at rest with AES-256-GCM. The encryption key is auto-generated per machine and stored in the OS config directory (e.g.~/.config/fibx-nodejs/encryption-keyon Linux). You can also set theFIBX_SESSION_SECRETenvironment variable for CI/Docker environments.

npx fibx balance npx fibx balance --chain citrea

Consolidated cross-chain portfolio view with USD valuations:

npx fibx portfolio # Table output across all chains npx fibx portfolio --json # Structured JSON for scripting

Shows all token holdings across Base, Citrea, HyperEVM, and Monad with USD values. Includes DeFi positions (Aave V3 collateral/debt) and total portfolio net worth. Token prices are sourced live from Fibrous.

npx fibx send 0.001 0xRecipient # Send native token on Base (ETH) npx fibx send 10 0xRecipient USDC # Send ERC-20 on Base npx fibx send 1 0xRecipient --chain monad # Send MON on Monad npx fibx send 0.1 0xRecipient --simulate # Preview without sending

npx fibx quote 0.01 ETH USDC # Price check on Base npx fibx quote 1 MON USDC --chain monad # Check Monad prices npx fibx quote 0.1 ETH USDC --json # JSON output for scripts

No wallet or authentication required.Usequoteto explore prices, thentradeto execute.

npx fibx trade <amount> <from> <to> npx fibx trade 0.0001 ETH USDC npx fibx trade 20 USDC DAI npx fibx trade 1 MON USDC --chain monad npx fibx trade 0.1 ETH USDC --simulate # Preview without broadcasting

Options:--slippage <n>(default: 0.5%),--approve-max,--simulate,--json

Note:Thetradecommand automatically detectsWrap(Native -> Wrapped) andUnwrap(Wrapped -> Native) operations and executes them directly via contract calls, bypassing aggregator routing to save gas.

npx fibx tx-status <hash> npx fibx tx-status 0x123...abc --chain monad

npx fibx address # Print active wallet address npx fibx wallets # Show active wallet details

npx fibx aave status # Account health npx fibx aave markets # List all active reserves with APY & TVL npx fibx aave supply 1 ETH # Auto-wraps ETH -> WETH and supplies npx fibx aave supply 100 USDC # Supply ERC-20 npx fibx aave borrow 50 USDC # Borrow npx fibx aave repay 50 USDC # Repay npx fibx aave repay max ETH # Auto-wraps ETH and repays full WETH debt npx fibx aave withdraw max ETH # Withdraws WETH and auto-unwraps to ETH npx fibx aave supply 1 ETH --simulate # Preview without broadcasting

Note:supply,repay, andwithdrawsupport automaticETH <-> WETHwrapping/unwrapping on Base.

Set custom RPC URLs to avoid rate limits on public endpoints:

npx fibx config set-rpc base https://mainnet.base.org npx fibx config get-rpc base npx fibx config reset-rpc base # Reset single chain to default npx fibx config reset-rpc # Reset all chains to default npx fibx config list

Hot-reload:Config changes are picked up automatically — no need to restart the CLI or MCP server.

The MCP server exposes11 toolsacross 4 categories (Auth & Config, Wallet & Portfolio, Trading, DeFi). All write operations support asimulate=truepreview that does not broadcast; gas estimates are returned only where available.

Letting an AI agent operate a wallet requires controls outside the model. fibx combines signing-layer policies, server-side validation, client hints, and explicit previews. These controls reduce risk, but the server credentials, MCP client configuration, and deployment policy remain part of the trust boundary:

Note:policies are attached when a wallet is created. Wallets provisioned before policies were introduced keep signing without them until migrated.

This repository is the CLI and MCP server. Three sibling repositories complete the stack:

src/ ├── commands/ # CLI commands (auth, trade, send, aave, config) ├── mcp/ # Modular MCP server │ ├── server.ts # Entry point + MCP_INSTRUCTIONS │ ├── tools/ # Tool registrations (auth, wallet, trade, defi) │ └── handlers/ # Tool implementations ├── services/ # Business logic (chain, fibrous, auth, defi, portfolio) └── lib/ # Shared utilities (errors, fetch, format, crypto)

pnpm install pnpm dev # run the CLI from source pnpm test # vitest unit tests pnpm typecheck # tsc --noEmit pnpm lint # eslint pnpm build # tsup bundle to dist/

Live cross-DEX crypto prices read from on-chain pool state: per-venue price, liquidity depth and gross cross-venue spread across BSC, Polygon, Arbitrum, Base, Avalanche and Optimism. Works keyless, no account.

DeFi liquidity-pool scores and Enter/Hold/Exit verdicts for Solana and EVM, with a public miss-inclusive track record. Free keyless API and MCP server.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.

An AI gateway for the Blend Protocol on Stellar, enabling DeFi actions like lending, borrowing, and pool creation through AI assistants or apps.

MCP server for dry-run EVM transaction simulation via Crypto APIs

MCP server for DeFi data — real-time crypto prices, token analytics, wallet balances, and on-chain data across multiple chains.

Real-time DeFi lending rates across 14+ protocols (Aave, Morpho, Spark, Compound, Venus, etc). Query borrow/supply rates, c ompare platforms, calculate looping strategies on 6 chains (Ethereum, Arbitrum, Base, BSC, Solana, HyperEVM).

Cross-protocol DeFi yield opportunities with risk metrics via DefiLlama. 16,000+ pools across 60+ chains. Risk classification, APY trends, and yield comparison.