home / mcp / fibrous mcp server

Fibrous MCP Server

Provides an MCP server that coordinates Fibrous SDK tools for multi-chain DeFi operations via a dedicated HTTP/stdio endpoint.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ahmetenesdur-fibrous-mcp": {
      "url": "https://mcp.fibrous.finance/mcp",
      "headers": {
        "DEBUG": "false",
        "NODE_ENV": "development",
        "LOG_LEVEL": "info",
        "BASE_RPC_URL": "https://mainnet.base.org",
        "ENABLE_METRICS": "false",
        "SCROLL_RPC_URL": "https://rpc.scroll.io",
        "FIBROUS_API_KEY": "your_api_key_here",
        "BASE_PRIVATE_KEY": "0x...",
        "DEFAULT_SLIPPAGE": "1.0",
        "STARKNET_RPC_URL": "https://starknet-mainnet.public.blastapi.io",
        "SCROLL_PRIVATE_KEY": "0x...",
        "STARKNET_PUBLIC_KEY": "0x...",
        "STARKNET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Fibrous MCP Server enables AI agents to perform multi-chain DeFi operations by interfacing with the Fibrous SDK. It exposes a set of tools and supports multiple networks, allowing you to discover tokens, routes, and execute or estimate swaps through a unified MCP interface.

How to use

You connect your MCP client to the Fibrous MCP Server using a local stdio configuration. Define a server entry named fibrous_mcp that runs Node.js and points to the server’s entry script. This enables your client to request token data, routes, and swap actions through a standard client-server flow.

How to install

Prerequisites you need before installation:

- Node.js 18+

- pnpm (recommended)

- TypeScript 5.0+

Installation and setup flow you should follow exactly:

Additional setup and configuration

Prepare the environment and configuration for development or production use. Create your environment file from the example, and fill in RPC URLs and private keys for each network you plan to use.

Development and running the server

Build and run the MCP server locally using the standard development workflow.

Production deployment

Perform a clean production build and start the server in production mode to ensure optimized performance and stable operation.

Example commands

# Install dependencies
pnpm install

# Configure environment
cp .env.example .env
# Edit .env with your RPC URLs and private keys

# Build the project
pnpm build

# Start server
pnpm start

Available tools

get-supported-tokens

List all tokens supported by the MCP server so you can select assets for swaps or balances.

get-supported-protocols

Query available DeFi protocols and DEXs available for routing and execution.

get-best-route

Compute the optimal swap route between two tokens under current pool liquidity and constraints.

get-best-route-batch

Find optimal routes for batch swaps, available on supported networks (Starknet).

build-transaction

Generate transaction data for a given swap or operation to be signed by a wallet.

build-batch-transaction

Create batch transaction data for multiple operations (Starknet only).

format-token-amount

Convert between human-readable token amounts and their on-chain wei representation.

get-token

Fetch token details by address to display metadata such as symbol, decimals, and name.

execute-swap

Execute token swaps using your wallet configuration and signature flow.

estimate-swap

Estimate gas costs or fees for a proposed swap using your wallet context.