Arbitrum Bridge MCP Server

The most advanced cross-chain bridge tooling for AI agents - featuring intent-based bridging, multi-protocol intelligence, and production-grade security.

🔀 This is a specialized fork of - Enhanced with comprehensive Arbitrum bridge functionality, security improvements, and critical bug fixes.

Breakthrough Features

Intent-Based Bridging

• Natural Language Interface: "Bridge 100 USDC to Ethereum with low fees"

• Smart Protocol Selection: AI compares Across vs Stargate routes automatically

• Execution Planning: Complete transaction workflows with optimal parameters

Multi-Protocol Intelligence

• Across Protocol: Fast, secure bridging with UMA optimistic oracle

• Stargate V2: Credit-based bridging across 6+ chains

• Unified Interface: One API for multiple bridge protocols

Advanced Security

• Oracle Validation: Chainlink price feeds verify destination amounts

• Permit Integration: EIP-2612 & Permit2 for gasless approvals

• Slippage Protection: Dynamic slippage calculation with deadline enforcement

• MEV Protection: Built-in safeguards against front-running

Recent Fixes (v2.0.0)

Critical Issues Resolved

• ✅ L2 Bridge ABI Fix: Corrected bridgeEthFromArbitrum to use proper L2 bridge contract

• ✅ Contract Addresses: Replaced zero placeholders with official Arbitrum contracts

• ✅ Amount Format: Standardized all amounts to hex format for consistency

• ✅ Security Hardening: Added comprehensive security measures and validations

• ✅ Architecture: Complete refactor to EmberAGI-compatible standards

Verified Contract Addresses

• L1 Inbox: 0x4Dbd4fc535Ac27206064B68FfCf827b0A60BAB3f

• L1 Gateway Router: 0x72Ce9c846789fdB6fC1f34aC4AD25Dd9ef7031ef

• L2 Bridge: 0x8315177aB297bA92A06054cE80a67Ed4DBd7ed3a

• L2 Gateway Router: 0x5288c571Fd7aD117beA99bF60FE0846C4E84F933

Note: All critical bugs have been resolved. See ISSUES_RESOLVED.md for detailed information about the fixes.

Production Metrics

• 18+ Production-Ready Tools

• 1,547 lines of TypeScript

• Comprehensive Testing Suite

• Professional Documentation

• Multiple Demo Interfaces

Quick Start

Prerequisites

• Node.js 18+

• pnpm or npm

• Arbitrum RPC access

Installation

MCP Inspector Integration

Core Tools

Bridge Operations

• bridgeEthToArbitrum - Bridge ETH from Ethereum to Arbitrum

• bridgeEthFromArbitrum - Bridge ETH from Arbitrum to Ethereum

• bridgeErc20ToArbitrum - Bridge ERC20 tokens from Ethereum to Arbitrum

• bridgeErc20FromArbitrum - Bridge ERC20 tokens from Arbitrum to Ethereum

Utility Tools

• getBridgeStatus - Check transaction status

• estimateBridgeGas - Estimate gas costs

• listAvailableRoutes - List available bridge routes

• processBridgeIntent - Process natural language bridge intents

Testing & Demo

CLI Demo

Comprehensive demonstration of all features.

MCP Inspector

Professional MCP client for detailed tool inspection.

Architecture

EmberAGI Compatible Design

• Standardized Tools: Each tool follows EmberAGI pattern with description, parameters, and execute

• Zod Validation: Strict input/output schemas with comprehensive validation

• TypeScript Support: Full type safety with exported interfaces

• Error Handling: Standardized error classes with clear error codes

Security-First Design

• Parameter Validation: All inputs validated with Zod schemas

• Address Validation: Case-insensitive Ethereum address validation

• Amount Validation: Positive integer validation in wei

• No Signing: Only unsigned transaction artifacts

Multi-Protocol Support

• Arbitrum Bridge: Native Arbitrum bridging

• Extensible: Easy to add new protocols

Supported Networks

• Arbitrum One (Primary): Chain ID 42161

• Ethereum Mainnet: Chain ID 1

• Extensible: Framework supports additional chains

Example Workflows

ETH Bridge

ERC20 Bridge

EmberAGI Integration

This project is fully compatible with EmberAGI's on-chain action plugins:

• Standardized Interface: Each tool follows the exact EmberAGI pattern

• Zod Validation: Parameter schemas provide AI-understandable validation

• Type Safety: Full TypeScript support for development

• Error Handling: Consistent error patterns for AI systems

• Response Format: Standardized responses for AI processing

License

MIT License - See LICENSE file for details.

Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests.

Built for the Arbitrum Ecosystem Powered by AI Intelligence Secured by Oracles