loading…
Browse all
Etherlink Server
FreeNot checkedEnables interaction with the Etherlink blockchain, including balance checks, transactions, smart contract interactions, and token operations.
About
Enables interaction with the Etherlink blockchain, including balance checks, transactions, smart contract interactions, and token operations.
README
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
--wsflag. Public RPC nodes don't expose WebSockets. - Rate Limits: Public RPC limited to 1000 requests/minute
Fee Structure
Etherlink fees include:
- Execution fee - varies based on network throughput (minimum 1 gwei)
- Inclusion fee - covers data availability on Tezos L1
See Fee structure for details.
Testing
bun test test/etherlink.test.ts
Testnet Faucet
Get testnet XTZ: https://shadownet.faucet.etherlink.com
Resources
License
MIT
How to install
Run in your terminal:
claude mcp add etherlink-mcp-server -- npx 
