Enables AI agents to fetch cross-chain swap quotes, list tokens, and generate prefilled swap links across 70 EVM and Solana chains.
Also known as layerhop/layerhop-js, mcp, @layerhop/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 1,547
- Latest version
- 0.5.0
- Last commit
- Nov 4, 2026
- License
- MIT
What is LayerHop MCP?
LayerHop enables AI agents to fetch cross-chain swap quotes, list tokens, and generate prefilled swap links across 70 EVM and Solana chains.
Summary generated from the project's README
About LayerHop MCP server
LayerHop provides an interface for AI agents to interact with cross-chain liquidity across 70 EVM and Solana networks. Developers can connect this server to clients like Claude Desktop, Claude Code, or Cursor using stdio or host it via HTTP. The server functions as a read-only and quote-generation tool that never holds private keys or signs transactions, ensuring that users maintain control through their own wallets.
Agents use specific tools to list available chains and tokens, fetch swap quotes with detailed fee breakdowns, and generate prefilled swap links for users. The toolset includes advanced capabilities such as simulating transactions, checking token risk, and managing Solana limit orders. While basic functions work with default settings, an API key is required to access deposit address management features. Users can configure the connection using the LAYERHOP_API_URL, LAYERHOP_API_KEY, and LAYERHOP_INTEGRATOR environment variables.
What you can do with it
- 1Compare cross-chain swap pricesAn AI agent can fetch the best-price quotes for moving assets between different blockchain networks.
- 2Verify token safetyA developer can instruct an agent to check the risk profile of a specific token before performing a swap.
- 3Prepare ready-to-use swap linksThe agent can provide a direct link to a swap interface that is already filled with the necessary transaction details.
Written from the project's README. Every use case is checked against a quote from it.
How to install LayerHop MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall LayerHop MCP in Claude Code
$ claude mcp add --env 'LAYERHOP_API_KEY=<YOUR_LAYERHOP_API_KEY>' mcp -- npx -y @layerhop/mcpInstall LayerHop MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@layerhop/mcp"
],
"env": {
"LAYERHOP_API_KEY": "<YOUR_LAYERHOP_API_KEY>"
}
}
}
}Install LayerHop MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@layerhop/mcp"
],
"env": {
"LAYERHOP_API_KEY": "<YOUR_LAYERHOP_API_KEY>"
}
}
}
}Install LayerHop MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@layerhop/mcp"],"env":{"LAYERHOP_API_KEY":"<YOUR_LAYERHOP_API_KEY>"}}'Install LayerHop MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@layerhop/mcp"
],
"env": {
"LAYERHOP_API_KEY": "<YOUR_LAYERHOP_API_KEY>"
}
}
}
}Install LayerHop MCP in Codex
$ codex mcp add mcp --env 'LAYERHOP_API_KEY=<YOUR_LAYERHOP_API_KEY>' -- npx -y @layerhop/mcpInstall LayerHop MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@layerhop/mcp"] [mcp_servers.mcp.env] LAYERHOP_API_KEY = "<YOUR_LAYERHOP_API_KEY>"
Install LayerHop MCP in Gemini CLI
$ gemini mcp add -s user -e 'LAYERHOP_API_KEY=<YOUR_LAYERHOP_API_KEY>' mcp npx -- -y @layerhop/mcpInstall LayerHop MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@layerhop/mcp"
],
"env": {
"LAYERHOP_API_KEY": "<YOUR_LAYERHOP_API_KEY>"
}
}
}
}Configuration
LAYERHOP_API_KEYSecretOptional LayerHop API key from dashboard.layerhop.com, for higher rate limits
LAYERHOP_INTEGRATOROptional partner ID, so swaps made through your agent earn your partner fee
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablelayerhop/layerhop-js is public and reachablegithub.com/layerhop/layerhop-js ↗Pass
- Package names this repository as its source@layerhop/mcp names layerhop/layerhop-js as sourcenpmjs.com/package/@layerhop/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-04github.com/layerhop/layerhop-js ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @layerhop/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 688 msPass
README
View on GitHub@layerhop/mcp
Model Context Protocol server for LayerHop: AI agents (Claude, ChatGPT, Cursor, …) can list chains and tokens, get best-price cross-chain / same-chain swap quotes with every fee spelled out, and hand the user a prefilled swap link.
The server holds no private keys and never signs or broadcasts. The user's own wallet signs.
Listed in the official MCP Registry as com.layerhop/mcp.
# stdio (Claude Desktop, Claude Code, Cursor, …)
npx -y @layerhop/mcp
claude mcp add layerhop -- npx -y @layerhop/mcp
# hosted, Streamable HTTP
claude mcp add --transport http layerhop https://mcp.layerhop.com/mcp
# self-host over HTTP: POST /mcp, GET /healthz
npx -y @layerhop/mcp --http --port 8090 --host 0.0.0.0
Env: LAYERHOP_API_URL (default https://api.layerhop.com), LAYERHOP_API_KEY (optional; required for deposit addresses), LAYERHOP_INTEGRATOR (optional partner id), LAYERHOP_APP_URL (default https://layerhop.com).
Tools: list_chains, list_tokens, get_quote, get_swap_link, build_transaction, simulate_transaction, report_submitted, get_order_status, list_orders, lookup_token, get_token_risk, Solana limit orders (create_limit_order, submit_limit_order, list_limit_orders, get_limit_order, cancel_limit_order; unsigned transactions only), plus deposit addresses (API key required): create_deposit_address, list_deposit_addresses, get_deposit_address, refresh_deposit_address, disable_deposit_address, simulate_deposit (test keys only). Amounts in tool inputs are human decimals ("100" = 100 USDC).
Full guide: https://docs.layerhop.com/guides/ai-agents
MIT licensed.
LayerHop MCP questions
How do I add LayerHop MCP to Claude Code?
Run claude mcp add --env 'LAYERHOP_API_KEY=<YOUR_LAYERHOP_API_KEY>' mcp -- npx -y @layerhop/mcp in your terminal. Add --scope user to make it available in every project.
How do I add LayerHop MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server handle my private keys?
No, the server is non-custodial and does not hold keys or sign transactions.