MCP 服务器

etherlink-mcp-server

Enables interaction with the Etherlink blockchain, including balance checks, transactions, smart contract interactions, and token operations.

README

Etherlink MCP Server

A Model Context Protocol (MCP) server for Etherlink - an EVM-compatible Layer 2 blockchain built on Tezos.

Networks

Network	Chain ID	RPC Endpoint	Explorer
Mainnet	42793	https://node.mainnet.etherlink.com	explorer.etherlink.com
Shadownet Testnet	127823	https://node.shadownet.etherlink.com	shadownet.explorer.etherlink.com

Native Currency: XTZ (18 decimals)

Quick Start

Install & Run

git clone https://github.com/efekucuk/etherlink-mcp-server.git
cd etherlink-mcp-server

bun install
bun run start

Configure with Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "etherlink": {
      "command": "bun",
      "args": ["run", "/path/to/etherlink-mcp-server/src/index.ts"],
      "env": {
        "EVM_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Network Aliases

Mainnet: etherlink, etherlink-mainnet
Testnet: etherlink-shadownet, etherlink-testnet, shadownet

Features

✅ Check balances (native XTZ + ERC20 tokens)
✅ Send transactions
✅ Read/write smart contracts (automatic ABI fetching)
✅ Token operations (ERC20, ERC721, ERC1155)
✅ Transaction history and receipts
✅ Gas estimation
✅ Block data access
✅ Debug tracing

Etherlink-Specific Notes

Key Characteristics

Native Currency: XTZ (Tez)
EIP-1559 Support: Yes - uses max_fee_per_gas. Priority fees (max_priority_fee_per_gas) are ignored since the sequencer uses first-come-first-served ordering.
WebSockets: Supported when running your own node with --ws flag. Public RPC nodes don't expose WebSockets.
Rate Limits: Public RPC limited to 1000 requests/minute