# FibX

FibX — an MCP server and CLI for DeFi on Base, HyperEVM and Monad, routing swaps through Fibrous aggregation. The agent gets 19 tools for quotes, swaps, transfers, portfolio and Aave V3 on Base.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Fibrous-Finance
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Fibrous-Finance/fibx
- Updated: 2026-09-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/fibx

## What it does

FibX hands the agent tools for onchain work: price quotes and swaps with auto-slippage via the Fibrous router, ETH and ERC-20 transfers, a cross-chain portfolio view with USD values, and Aave V3 actions (supply, borrow, repay, withdraw) on Base. In hosts that render MCP Apps, like Claude Desktop, `open_fibx` brings the FibX app into the chat — wallet, balances and a swap form with the Fibrous route — where you press Simulate and Swap yourself.

\`fibx auth setup` offers three signing paths. Pair your own wallet over WalletConnect (a QR in the terminal, every transaction approved on your phone), use a Privy server wallet via email OTP, or import a key stored locally under AES-256-GCM encryption. On top of all three sits a local signing policy file: per-chain native value cap, allowed chains and destinations, an expiry — checked before every signature.

For safe testing there is `--simulate`, which previews write operations without broadcasting, plus `--json` output for scripting. Node.js 18 or newer is required, and Privy-based operations also need a running `fibx-server` instance; imported keys work without it.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FIBX_API_URL`, `FIBX_SESSION_SECRET`, `FIBX_WC_PROJECT_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FIBX_API_URL=<FIBX_API_URL> --env FIBX_SESSION_SECRET=<FIBX_SESSION_SECRET> --env FIBX_WC_PROJECT_ID=<FIBX_WC_PROJECT_ID> --transport stdio fibx -- npx -y fibx
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add fibx --env FIBX_API_URL=<FIBX_API_URL> --env FIBX_SESSION_SECRET=<FIBX_SESSION_SECRET> --env FIBX_WC_PROJECT_ID=<FIBX_WC_PROJECT_ID> -- npx -y fibx
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fibx": {
            "command": "npx",
            "args": [
                "-y",
                "fibx"
            ],
            "env": {
                "FIBX_API_URL": "<FIBX_API_URL>",
                "FIBX_SESSION_SECRET": "<FIBX_SESSION_SECRET>",
                "FIBX_WC_PROJECT_ID": "<FIBX_WC_PROJECT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fibx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "fibx"
            ],
            "env": {
                "FIBX_API_URL": "<FIBX_API_URL>",
                "FIBX_SESSION_SECRET": "<FIBX_SESSION_SECRET>",
                "FIBX_WC_PROJECT_ID": "<FIBX_WC_PROJECT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FIBX_API_URL=<FIBX_API_URL> -e FIBX_SESSION_SECRET=<FIBX_SESSION_SECRET> -e FIBX_WC_PROJECT_ID=<FIBX_WC_PROJECT_ID> fibx npx -y fibx
```
Replace <…> with your own values

## When to use it
- get a quote and swap tokens on Base, HyperEVM or Monad
- send ETH or any ERC-20 token from the agent chat
- view a cross-chain portfolio with USD valuations
- manage Aave V3 positions on Base through the agent
- cap what the agent may sign with a local signing policy

## Example prompts
- Quote 0.01 ETH to USDC on Base via fibx
- Swap 100 USDC to DAI and sign it with my wallet
- Show my portfolio across all chains and run `open_fibx`

## Similar
- [Hyperliquid Vaults — APR, TVL, Performance Rankings](https://affpapa.org/en/nevibecode/mcp/hyperliquid-vaults-apr-tvl-performance-rankings.md) — MCP server · 2481 installs
- [x402](https://affpapa.org/en/nevibecode/skills/starchild-x402.md) — skill · 1200 installs
- [hyperliquid](https://affpapa.org/en/nevibecode/skills/hyperliquid.md) — skill · 8700 installs
- [Hyperliquid Market Data — Orderbooks, Prices, OHLCV](https://affpapa.org/en/nevibecode/mcp/hyperliquid-market-data-orderbooks-prices-ohlcv.md) — MCP server · 6097 installs
- [hyperliquid-reader](https://affpapa.org/en/nevibecode/skills/hyperliquid-reader.md) — skill · 598 installs
- [Base Chain DeFi — Aerodrome, Moonwell Yields](https://affpapa.org/en/nevibecode/mcp/base-chain-defi-aerodrome-moonwell-yields.md) — MCP server · 2298 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
