FibX MCP server

FibX

A command-line tool and MCP server for DeFi operations on Base, HyperEVM, and Monad, powered by Fibrous aggregation. Sign with your own wallet over WalletConnect, with a Privy server wallet, or with an imported key — every path bounded by a signing policy that lives on your machine.

Features

• Multi-Chain Support: Base, HyperEVM, and Monad
• Portfolio: Cross-chain portfolio overview with USD valuations and DeFi positions
• Token Swaps: Optimal routing via Fibrous aggregation with auto-slippage
• Transfers: Send ETH or any ERC-20 token
• Aave V3: Supply, borrow, repay, withdraw, and browse markets on Base
• MCP Server: Built-in AI agent integration for Cursor, Claude Desktop, and Antigravity (19 tools)
• The FibX app, in the chat: in hosts that render MCP Apps UI such as Claude Desktop, open_fibx shows the wallet, balances, signing policy and a swap form with the Fibrous route inline — the model opens it, and you press Simulate and Swap
• Agent Skills: Prompt-based AI skills via fibx-skills
• Your own wallet: Pair over WalletConnect and approve every transaction on your phone
• Privy Server Wallets: Server-side signing — the CLI receives signed transaction payloads or signatures, not Privy app credentials or raw keys
• Private Key Import: Use an existing wallet with AES-256-GCM encrypted local storage
• Local signing policy: A file you own — native value cap per chain, allowed chains, allowed destinations, expiry — enforced before every signature on all three paths (Privy adds its own server-side policy on top)

Supported Chains

Installation

Run directly with npx (no install needed):

npx fibx status

Or install globally:

npm install -g fibx

Requirements

• Node.js >= 18
• A running fibx-server instance (required for Privy wallet operations; not needed for private key imports)

Quick Start — First Swap in 3 Minutes

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

Step 2: Authenticate (pick one)

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)

Step 3: Execute

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.

Usage

Choosing how FibX signs

Run fibx auth setup and it will ask. The three paths differ on one thing:

Shortened. The full README is on GitHub.