| name | etherlink |
| description | Etherlink blockchain interaction - EVM-compatible L2 on Tezos. Supports mainnet and shadownet testnet via MCP server. Use for balance checks, transactions, smart contracts, and token operations on Etherlink. |
| tags | ["blockchain","evm","tezos","l2","web3","etherlink","mcp"] |
| version | 1.0.0 |
Etherlink Skill
Interact with Etherlink, an EVM-compatible L2 built on Tezos.
Quick Start
1. Configure MCP Server
Add to your Claude/MCP config:
{
"mcpServers": {
"etherlink": {
"command": "bun",
"args": ["run", "/path/to/etherlink-mcp-server/src/index.ts"],
"env": {
"EVM_PRIVATE_KEY": "your-private-key-here"
}
}
}
}
2. Select Network
Use network name or chain ID:
- Mainnet:
etherlink or 42793
- Testnet:
etherlink-shadownet or 127823
Networks
Native Currency: XTZ (18 decimals)
Common Operations
Check Balance
Get balance for 0x... on etherlink
Send Transaction
Send 0.1 XTZ to 0x... on etherlink
Read Contract
Call balanceOf on contract 0x... for address 0x... on etherlink
Get Block Info
Get latest block on etherlink
Etherlink-Specific Notes
Key Differences
- Native Currency: XTZ (Tez), not ETH
- No EIP-1559: Fee market not yet implemented - use legacy gas pricing
- Block Hashes: Computed differently (can't verify from header alone)
- Rate Limits: Public RPC limited to 1000 req/min
Supported Endpoints
- ✅ eth_blockNumber, eth_chainId, eth_getBalance
- ✅ eth_call, eth_estimateGas, eth_gasPrice
- ✅ eth_sendRawTransaction, eth_getLogs
- ✅ debug_traceTransaction
- ❌ eth_subscribe (experimental only)
- ❌ Filter endpoints (eth_newFilter, etc.)
Tezos L1 Bridge
Etherlink bridges to Tezos L1 for deposits/withdrawals. Bridge operations require Tezos tooling. See Etherlink Docs for details.
Testnet Faucet
Get testnet XTZ: https://shadownet.faucet.etherlink.com
Troubleshooting
"Unsupported network": Use correct network name (etherlink, etherlink-shadownet) or chain ID.
Rate limited: Public RPC has 1000 req/min limit. For production, run your own node.
Transaction failing: No EIP-1559 - don't set maxFeePerGas/maxPriorityFeePerGas.
Resources
