# LayerHop

LayerHop lets an agent compare same-chain and cross-chain swap routes with fee details. It fits workflows that stop before wallet signing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: layerhop
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/layerhop/layerhop-js/tree/HEAD/packages/mcp
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/layerhop

## What it does

LayerHop gives an AI agent access to swap data across EVM networks and Solana. Its tools can enumerate chains and tokens, return route quotes with fee details, create a prepared swap link, build or simulate a transaction, and report order status.

The server does not keep private keys or sign and broadcast transactions. The user’s wallet handles signing. You can connect through Streamable HTTP at `https://mcp.layerhop.com/mcp` or run the package with `npx -y @layerhop/mcp`. `LAYERHOP_API_KEY` is required for deposit-address operations, so those tools need the key before use.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.layerhop.com/mcp`
- Environment variables: `LAYERHOP_API_KEY`, `LAYERHOP_INTEGRATOR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.layerhop.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env LAYERHOP_API_KEY=<LAYERHOP_API_KEY> --env LAYERHOP_INTEGRATOR=<LAYERHOP_INTEGRATOR> --transport stdio mcp -- npx -y @layerhop/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://mcp.layerhop.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp --env LAYERHOP_API_KEY=<LAYERHOP_API_KEY> --env LAYERHOP_INTEGRATOR=<LAYERHOP_INTEGRATOR> -- npx -y @layerhop/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://mcp.layerhop.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@layerhop/mcp"
            ],
            "env": {
                "LAYERHOP_API_KEY": "<LAYERHOP_API_KEY>",
                "LAYERHOP_INTEGRATOR": "<LAYERHOP_INTEGRATOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://mcp.layerhop.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@layerhop/mcp"
            ],
            "env": {
                "LAYERHOP_API_KEY": "<LAYERHOP_API_KEY>",
                "LAYERHOP_INTEGRATOR": "<LAYERHOP_INTEGRATOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://mcp.layerhop.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e LAYERHOP_API_KEY=<LAYERHOP_API_KEY> -e LAYERHOP_INTEGRATOR=<LAYERHOP_INTEGRATOR> mcp npx -y @layerhop/mcp
```
Replace <…> with your own values

## When to use it
- compare swap routes across chains
- inspect every fee before swapping
- find supported chains and tokens
- create a prefilled swap link
- simulate a transaction before signing

## Example prompts
- Compare routes for swapping 100 USDC across the available chains and show every fee.
- Find the best quote for this token swap and return a prepared swap link.
- Simulate the transaction first, then report the order status.

## Similar
- [RAVN](https://affpapa.org/en/nevibecode/mcp/ravn.md) — MCP server
- [THORChain Swap](https://affpapa.org/en/nevibecode/mcp/thorchain-swap.md) — MCP server · ★ 2 repo stars
- [Flashift](https://affpapa.org/en/nevibecode/mcp/flashift.md) — MCP server
- [LI.FI](https://affpapa.org/en/nevibecode/mcp/lifi.md) — MCP server · 3589 installs
- [helius-jupiter](https://affpapa.org/en/nevibecode/skills/helius-jupiter.md) — skill · ★ 33 repo stars
- [zeta-chain-cli](https://affpapa.org/en/nevibecode/mcp/zeta-chain-cli.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
