AramidBridgeMCP

Protocol MCP server for the Aramid Bridge — cross-chain bridging between Voi and Algorand.

Architecture

AramidBridgeMCP is a protocol-level MCP that sits above the infrastructure MCP layer:

UluCoreMCP / UluWalletMCP / UluBroadcastMCP
                    ↓
             AramidBridgeMCP
                    ↓
              On-chain (writes)

AramidBridgeMCP handles:

• Asset discovery with bridge routes between Voi and Algorand

• Transaction preparation for bridging native tokens and ASAs

• Automatic 0.1% fee calculation

AramidBridgeMCP does NOT:

• Sign transactions (use UluWalletMCP)

• Broadcast transactions (use UluBroadcastMCP)

• Manage wallets

Related MCP server: Algorand MCP Server

Tools

Asset Discovery

Transaction Preparation

Agent Workflow

Agent calls AramidBridgeMCP:  bridge_txn(chain, symbol, amount, sender, destinationAddress)
       → returns { transactions: [base64, ...] }

Agent calls UluWalletMCP: wallet_sign_transactions(signerId, transactions)
       → returns signed transactions

Agent calls UluBroadcastMCP: broadcast_transactions(network, txns)
       → returns transaction IDs

Chain Support

All tools accept a chain parameter:

• "voi" — Voi mainnet (chain ID 416101)

• "algorand" — Algorand mainnet (chain ID 416001)

Supported Assets

Plus BALLSACK, BLAPU, GEMS, GPEPE, JIMMY, PANDA, TURTLE

Bridge Details

• Bridge Address: ARAMIDFJYV2TOFB5MRNZJIXBSAVZCVAUDAPFGKR5PNX4MTILGAZABBTXQQ

• Fee: 0.1% fixed fee deducted from bridged amount

• Delivery: Automatic on AVM destinations (no claim step required)

• Protocol: Aramid transfer note format (aramid-transfer/v1:j{...})

Project Structure

index.js              MCP server entry point (2 tools)
lib/
  client.js           Algod client factory
  assets.js           Asset lookup and route resolution
  bridge.js           Bridge transaction builder
data/
  config.json         Chain configs, bridge address, and supported asset pairs

Setup

npm install

Run

node index.js

Or configure as an MCP server in your agent:

{
  "mcpServers": {
    "aramid-bridge": {
      "command": "node",
      "args": ["/path/to/AramidBridgeMCP/index.js"]
    }
  }
}

Documentation

• Aramid Finance Docs

• Supported Networks and Assets

• Fee Structure

• Using the Bridge