# FibX

Fibrous for AI agents · CLI and MCP server · v0.10.1

Source: https://www.fibrous.finance/fibx

FibX lets AI agents trade through Fibrous. A CLI and an MCP server that let AI agents quote, swap and transfer on Base, HyperEVM and Monad, and use Aave V3 on Base, through Fibrous routing.

Listed in the official MCP Registry as `finance.fibrous/fibx`.

## Try it now

`npx fibx quote` asks Fibrous for a route and prints it. It needs no wallet and no account.

Executing a trade needs one of the three ways to sign, described under Safety model.

```
npx fibx quote 0.01 ETH USDC
```

```
✔ Quote ready
  input         0.01 ETH
  output        ~22.524249 USDC
  rate          1 ETH ≈ 2252.4249 USDC
  slippage      0.5%
  router        0x274602a953847d807231d2370072f5f4e4594b44
  chain         base

  → To execute: fibx trade 0.01 ETH USDC
```

Real output, captured 5 November 2026. Prices move by the second.

## Connect it to your agent

stdio · `npx -y fibx mcp-start`

Claude Desktop, Cursor and Antigravity read the same JSON from their own config file. Claude Code takes one command.

### Claude Desktop

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "fibx": {
      "command": "npx",
      "args": ["-y", "fibx", "mcp-start"]
    }
  }
}
```

Quit and reopen Claude Desktop afterwards.

### Cursor

`.cursor/mcp.json`

```json
{
  "mcpServers": {
    "fibx": {
      "command": "npx",
      "args": ["-y", "fibx", "mcp-start"]
    }
  }
}
```

Add it to the project, in `.cursor/mcp.json`.

### Antigravity

`~/.gemini/antigravity/mcp_config.json`

```json
{
  "mcpServers": {
    "fibx": {
      "command": "npx",
      "args": ["-y", "fibx", "mcp-start"]
    }
  }
}
```

The same JSON as Claude Desktop and Cursor.

### Claude Code

```
claude mcp add fibx -- npx -y fibx mcp-start
```

One command registers FibX as an MCP server.

## The FibX app, inside the chat

In hosts that render MCP Apps UI, `open_fibx` shows the wallet, balances, signing policy and a swap form with the Fibrous route inline. Claude Desktop does this today. The model opens the app; the user presses Simulate and Swap, and the model never does.

1. The model calls `open_fibx`. The app opens in the chat with your wallet, balances and signing policy.
2. You press Simulate. A dry run previews the transaction without broadcasting it.
3. You press Swap. The policy is checked before the signature. Over WalletConnect, you approve on your phone.

## Safety model

### Three ways to sign

1. your own wallet over WalletConnect, where every transaction is approved on your phone;
2. a Privy server wallet;
3. an imported key, encrypted at rest with AES-256-GCM.

### A local signing policy the user owns, enforced before every signature on all three paths

- a cap on the **native-token value** (ETH, HYPE, MON) of each transaction, per chain;
- allowed chains;
- allowed destinations;
- an expiry.

Token amounts are bounded by the allowed destinations, not by the value cap. A lapsed policy refuses everything.

### Simulate is available, not automatic.

Every write tool supports a `simulate` dry run that previews the transaction without broadcasting it. In the FibX app, Simulate and Swap are buttons the user presses.

## What it can do

FibX exposes 19 MCP tools in four groups. It also shows a cross-chain portfolio with USD values.

- The app (2): `open_fibx`, `list_tokens`
- Read-only (9): `get_quote`, `get_auth_status`, `get_connect_status`, `get_balance`, `get_portfolio`, `get_tx_status`, `get_aave_status`, `get_aave_markets`, `get_policy`
- Transactional (3), flagged `destructiveHint`: `swap_tokens`, `send_tokens`, `aave_action`
- Session and policy (5): `connect_wallet`, `config_action`, `set_policy_rule`, `clear_policy_rule`, `logout`

## Supported networks

| Network  | Value cap in | Aave V3 |
| -------- | ------------ | ------- |
| Base     | ETH          | Yes     |
| HyperEVM | HYPE         | No      |
| Monad    | MON          | No      |

FibX does not run on Starknet. The value cap is set per chain, in that chain's native token.

## The wider kit

- `fibx-skills`: Agent Skills for Claude Code, Cursor and other agents. [GitHub](https://github.com/Fibrous-Finance/fibx-skills)
- `fibx-telegram-bot`: DeFi execution in Telegram, bring your own model and key. [GitHub](https://github.com/Fibrous-Finance)
- `fibx-server`: A self-hostable Privy backend. [GitHub](https://github.com/Fibrous-Finance)
- `llms.txt`: Fibrous docs for LLMs. [docs.fibrous.finance](https://docs.fibrous.finance/llms.txt)

## Routing without an agent

The Fibrous API returns a quote and ready-to-execute calldata in one request. Fibrous adds no fee to API and SDK swaps.

- Fibrous API docs: https://docs.fibrous.finance
- FibX docs: https://docs.fibrous.finance/fibx-agent
- GitHub: https://github.com/Fibrous-Finance/fibx
- npm: https://www.npmjs.com/package/fibx