ADI Chain MCP Server

MCP server for ADI Chain: canonical bridge, CCIP, and network tools for AI agents.

Agents can answer — and execute — "how do I get USDC from Ethereum onto ADI Chain?" instead of pointing a human at a bridge UI. The server encodes ADI's domain knowledge: which bridges exist, which tokens each supports, and the constraints (USDC.e is CCIP-only and stuck on ADI Mainnet; no DEX liquidity exists on ADI Mainnet).

Install

Clone, audit, install globally. Reading the source is the point.

git clone <repo-url>
cd adi-mcp-server
bun i -g .          # installs globally from the audited clone
adi-mcp-server      # binary on PATH via package.json "bin"

Machines without bun: npm i -g . from the same clone. Update: git pull && bun i -g ..

Related MCP server: Arbitrum Bridge MCP Server

Configure

Add to your MCP client (Claude Desktop, Cursor, .mcp.json, …):

{
  "mcpServers": {
    "adi": {
      "command": "adi-mcp-server",
      "env": { "ADI_MCP_PRIVATE_KEY": "0x..." }
    }
  }
}

ADI_MCP_PRIVATE_KEY is optional. Without it the server runs read-only: bridge_deposit, bridge_withdraw, and ccip_transfer are disabled. The server never stores keys.

Tools

Read / query

Advisory

Write (require ADI_MCP_PRIVATE_KEY)

Known constraints (encoded in the domain model)

• ADI mainnet/testnet run nativeTokenBridgingOnly — only ADI is registered in the canonical bridge's Native Token Vault. ERC-20 deposits via the Two Bridges pattern are protocol-supported but not configured; the server rejects them with a clear error pointing to CCIP.

• USDC.e is a CCIP burn/mint token — it can only move via CCIP lanes, never the canonical bridge.

• No on-chain DEX with liquidity exists on ADI Mainnet — USDC.e cannot be swapped to native ADI on-chain. The multi-hop path (CCIP back to Ethereum → Uniswap → canonical bridge) is the workaround.

• CCIP on ADI testnet supports only CCIP-BnM — USDC is not on ADI testnet CCIP.

Development

bun i
bun run typecheck   # tsc --noEmit
bun test            # unit tests (routing, token resolution)
bun run test/smoke.ts   # live smoke test against mainnet RPC
bun run test/write.ts   # write-tool registration + deposit tx construction (needs ADI_MCP_PRIVATE_KEY)

Architecture

src/
  cli.ts        MCP server entry (stdio)
  tools.ts      tool definitions + registration
  domain.ts     networks, tokens, bridges, constraints (source of truth)
  routing.ts    funding-path planning
  providers.ts  viem clients + Blockscout v1 API + zks_* RPC
  bridge.ts     canonical bridge deposit/withdraw/claim construction
  ccip.ts       CCIP ccipSend construction
  erc8004.ts    ERC-8004 registry reads (identity, reputation, validation)
  abis/         vendored ABIs (verified against live contracts)

All contract addresses and ABIs were verified against live RPC, the Chainlink CCIP directory, and the bridge UI bundle.

License

MIT