Agglayer MCP Server

🚀 Agglayer MCP Server

This is a Model Context Protocol (MCP) server designed to interact with the Agglayer cross - chain settlement layer. Agglayer is a cross - chain settlement layer that connects the liquidity and users of any blockchain to achieve fast, low - cost interoperability and platform growth.

🚀 Quick Start

The Agglayer MCP Server is a powerful tool for interacting with the Agglayer cross - chain settlement layer. It enables seamless operations across different blockchains.

✨ Features

This MCP server offers the following features:

• Retrieve information about supported blockchain networks.
• Check the token balance of an address across different chains.
• Execute cross - chain token transfers.
• Obtain liquidity information.

📦 Installation

# Clone the repository
git clone <repository-url>
cd agglayer-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

📚 Documentation

Configuration

The server can be configured via environment variables:

• AGGLAYER_API_KEY: Your Agglayer API key (default is 'demo_key' for development).

Usage

Start the Server

npm start

MCP Integration

To use this server with Claude or other MCP - compatible systems, add it to your MCP settings configuration file:

{
  "mcpServers": {
    "agglayer": {
      "command": "node",
      "args": ["/path/to/agglayer-mcp-server/build/index.js"],
      "env": {
        "AGGLAYER_API_KEY": "your-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

get_chain_info

Retrieve information about supported blockchain networks.

{
  "chain": "ethereum" // Optional. Specify a particular chain to get its information; otherwise, get information for all chains.
}

get_token_balance

Get the token balance of an address on a specified chain.

{
  "chain": "ethereum",
  "address": "0x...",
  "token": "USDC" // Optional. Specify a particular token to get its balance; otherwise, get balances for all tokens.
}

cross_chain_transfer

Execute a cross - chain token transfer.

{
  "sourceChain": "ethereum", // Source chain
  "destinationChain": "polygon", // Destination chain
  "token": "USDC", // Token to transfer
  "amount": "100.0", // Transfer amount
  "fromAddress": "0x...", // Source address
  "toAddress": "0x..." // Destination address
}

get_liquidity_info

Obtain cross - chain liquidity information.

{
  "chain": "ethereum", // Optional. Specify a particular chain to get its liquidity information; otherwise, get information for all chains.
  "token": "USDC" // Optional. Specify a particular token to get its liquidity information; otherwise, get information for all tokens.
}

Available Resources

• agglayer://chains: List of all supported blockchain networks.
• agglayer://tokens: List of all supported tokens.
• agglayer://chains/{chainId}: Information about a specific blockchain network.
• agglayer://tokens/{tokenSymbol}: Information about a specific token.

Development

# Run in development mode with auto - reload
npm run dev

📄 License

ISC