Fibrous MCP Server

MCP server providing AI agents with tools for multi-chain DeFi operations using the Fibrous SDK.

- get-supported-tokens- List available tokens
- get-supported-protocols- List DEX protocols
- get-best-route- Find optimal swap routes
- get-best-route-batch- Find optimal routes for batch swaps (Starknet only)
- build-transaction- Generate transaction data
- build-batch-transaction- Generate batch transaction data (Starknet only)
- format-token-amount- Convert between human and wei formats
- get-token- Fetch token details by address
- execute-swap- Execute token swaps (requires wallet config)
- estimate-swap- Estimate gas costs (requires wallet config)

- Base- Uniswap V3, Aerodrome, SwapBased
- Starknet- JediSwap, MySwap, 10kSwap, Ekubo
- Scroll- Uniswap V3, SyncSwap, iZiSwap

# 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

NODE_ENV=development DEFAULT_SLIPPAGE=1.0

# Base Network BASE_RPC_URL=https://mainnet.base.org BASE_PRIVATE_KEY=0x... # Starknet Network STARKNET_RPC_URL=https://starknet-mainnet.public.blastapi.io STARKNET_PRIVATE_KEY=0x... STARKNET_PUBLIC_KEY=0x... # Scroll Network SCROLL_RPC_URL=https://rpc.scroll.io SCROLL_PRIVATE_KEY=0x...

# Debug configuration DEBUG=false LOG_LEVEL=info ENABLE_METRICS=false # API optimization FIBROUS_API_KEY=your_api_key_here

{ "mcpServers": { "fibrous-mcp": { "command": "node", "args": ["/path/to/fibrous-mcp/build/src/index.js"] } } }

- Node.js 18+
- pnpm (recommended)
- TypeScript 5.0+

# Clone repository git clone <repository-url> cd fibrous-mcp # Install dependencies pnpm install # Start development server pnpm dev # Watch mode with auto-reload pnpm dev:watch

# Type checking pnpm typecheck # Linting pnpm lint pnpm lint:fix # Code formatting pnpm format pnpm format:check

Comprehensive test suite with82.6% coverageacross all modules:

# Run all tests pnpm test # Watch mode for development pnpm test:watch # Coverage report pnpm test:coverage # CI mode pnpm test:ci

- 167/167 tests passing
- 10 test suites, ~3.1s execution
- Native BigInt with router-sdk v0.6.0

- API endpoints: 17 tests
- Server configuration: 14 tests
- Tool handlers: 14 tests
- Utilities: 122 tests (BigInt operations, configuration, responses, swap logic, validation)

- Statements: 82.56%
- Branches: 73.46%
- Functions: 75.71%
- Lines: 83.18%

- Router SDK v0.6.0: Latest Fibrous SDK compatibility
- 50KB smaller bundle: Removed BigNumber.js dependency
- Faster calculations: Native JavaScriptbigintoperations
- Modern standards: ES2022+ features

// Example: Native BigInt usage const amount = BigInt("1000000000000000000"); // 1 ETH const route = await router.getBestRoute(amount, tokenIn, tokenOut, "base");

- MCP Protocol: Model Context Protocol compliance
- Type Safety: Full TypeScript implementation
- Error Handling: Comprehensive error management
- Security: Environment variable validation and masking

# Production build pnpm build:clean # Production start NODE_ENV=production pnpm start:prod

- Store private keys securely (use secrets management)
- Configure appropriate RPC endpoints
- Set up monitoring and logging
- Use HTTPS for all external connections

- Native BigInt: 2-3x faster than BigNumber.js
- Bundle Size: 50KB reduction vs v0.5.x
- Memory Usage: Optimized for long-running processes
- Rate Limiting: 200 req/min (configurable)

- Fibrous Finance- Main website
- Documentation- API docs
- MCP Protocol- MCP specifications
- Router SDK v0.6.0- Local SDK documentation

- https://api.fibrous.finance(200 req/min)
- https://graph.fibrous.finance
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Ensure all tests pass:pnpm test
- Submit a pull request

MCP server for Limitless Exchange prediction markets on Base. 34 tools for market access, limit order trading, wallet management, and position tracking.