Best-price cross-chain swap quotes across 70 chains (EVM + Solana). Holds no keys, never signs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Turn a quoteId from get_quote into the UNSIGNED transaction the user's own wallet must sign: EVM {chainId, to, data, value in wei, optional ERC-20 approval to send first} or Solana {serializedTx base64}. Includes plain-language signing steps. The LayerHop MCP server holds no private keys and never signs or broadcasts transactions. Only use this when the user has their own signer and explicitly wants raw transaction data, after they confirmed the quote; otherwise give them the swap link.
quoteId from get_quote (starts with "q_"). Quotes expire after a short time (see expiresAt).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Turn a quoteId from get_quote into the UNSIGNED transaction the user's own wallet must sign: EVM {chainId, to, data, value in wei, optional ERC-20 approval to send first} or Solana {serializedTx base64}. Includes plain-language signing steps. The LayerHop MCP server holds no private keys and never signs or broadcasts transactions. Only use this when the user has their own signer and explicitly wants raw transaction data, after they confirmed the quote; otherwise give them the swap link.
| Argument | Type | Description |
|---|---|---|
| quoteId* | string | quoteId from get_quote (starts with "q_"). Quotes expire after a short time (see expiresAt). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId"
],
"properties": {
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
}
},
"additionalProperties": false
}Create an address the user sends tokens to; every deposit is swapped/bridged and delivered as toToken on toChain to recipient. No wallet connection or signing needed. Non-custodial: the address belongs to the liquidity provider (Relay), LayerHop never holds funds. Tell the user: send ONLY srcToken on srcChain to the address (other tokens or chains may be lost for good), at least $1 worth; refundTo must be the user's own address on srcChain, never an exchange (CEX) deposit address. Needs a LayerHop API key; test keys (lh_test_) give a fake sandbox address that must never receive real funds. The LayerHop MCP server holds no private keys and never signs or broadcasts transactions.
| Argument | Type | Description |
|---|---|---|
| label | string | Your reference for this address (1-64 chars), filterable in list_deposit_addresses. |
| amount | string | number | HUMAN units of fromToken ("25" = 25 USDC). Required when reusable is false (the exact amount to send); otherwise only sizes the estimate. Minimum worth $1. |
| toChain* | string | number | Destination chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| toToken* | string | Token to deliver (destination) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
| metadata | object | Up to 20 string key-value pairs stored on the address. |
| refundTo* | string | The user's OWN address on fromChain for refunds. NEVER an exchange (CEX) deposit address: refunds never go back to an exchange. |
| reusable | boolean | true (default): reusable for this route with any amount. false: one-time address for exactly `amount`. |
| fromChain* | string | number | Source (deposit) chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| fromToken* | string | The ONLY token the user may send to the address (source) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
Disable a deposit address: LayerHop stops tracking it (no more orders or webhooks for it). The provider may still process funds sent to it later, so the user must stop using it. Cannot be undone. Confirm with the user first. Needs a LayerHop API key.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit address id (starts with "da_"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^da_",
"description": "Deposit address id (starts with \"da_\")."
}
},
"additionalProperties": false
}Get one deposit address with its 20 most recent deposits (orders, quoteId starting with dep_): amount deposited and delivered, status (submitted, pending, filled, refunded, failed) and tx hashes. Tell the user: send ONLY srcToken on srcChain to the address (other tokens or chains may be lost for good), at least $1 worth; refundTo must be the user's own address on srcChain, never an exchange (CEX) deposit address. Needs a LayerHop API key; test keys (lh_test_) give a fake sandbox address that must never receive real funds. Read-only.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit address id (starts with "da_"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^da_",
"description": "Deposit address id (starts with \"da_\")."
}
},
"additionalProperties": false
}Check the status of a swap or bridge after the source transaction was sent: pending, filled (funds delivered), refunded, failed, or unknown (some same-chain providers; check the tx on an explorer). Read-only.
| Argument | Type | Description |
|---|---|---|
| txHash* | string | Source-chain transaction hash (EVM) or signature (Solana). |
| provider* | string | The provider of the quote that was executed (the `provider` field from get_quote / build_transaction). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"provider",
"txHash"
],
"properties": {
"txHash": {
"type": "string",
"minLength": 1,
"description": "Source-chain transaction hash (EVM) or signature (Solana)."
},
"provider": {
"enum": [
"jupiter",
"relay",
"debridge",
"mayan",
"zerox",
"kyberswap",
"odos",
"lifi",
"mock"
],
"type": "string",
"description": "The provider of the quote that was executed (the `provider` field from get_quote / build_transaction)."
}
},
"additionalProperties": false
}Get the best price to swap or bridge tokens, within one chain or across chains (EVM <-> Solana). Asks every liquidity provider and returns the best quote plus alternatives with human-readable amounts, minimum received after slippage, fees (LayerHop fee, partner fee, provider fee, gas) and ETA. Returns a quoteId (valid until expiresAt) and a layerhop.com swapLink a human can open to review and sign. Read-only: The LayerHop MCP server holds no private keys and never signs or broadcasts transactions. Always show the user the fees and output and get confirmation before proceeding.
| Argument | Type | Description |
|---|---|---|
| amount* | string | number | Amount to send in HUMAN units of fromToken as a decimal string, e.g. "100" for 100 USDC or "0.05" for 0.05 ETH. NOT base units/wei/lamports. Must be greater than 0. |
| sender* | string | Wallet address that sends the funds on the source chain (0x... for EVM, base58 for Solana). Only used to build the quote; no access is needed. |
| toChain* | string | number | Destination chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| toToken* | string | Token to receive (destination) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
| fromChain* |
Create a https://layerhop.com/swap link prefilled with the swap, which the user opens to review the live quote and fees and sign in their own wallet. This is the default, safest way to execute a swap. The LayerHop MCP server holds no private keys and never signs or broadcasts transactions. The amount is in human units.
| Argument | Type | Description |
|---|---|---|
| amount | string | number | Amount to send in HUMAN units of fromToken as a decimal string, e.g. "100" for 100 USDC or "0.05" for 0.05 ETH. NOT base units/wei/lamports. Must be greater than 0. |
| toChain* | string | number | Destination chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| toToken* | string | Token to receive (destination) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
| fromChain* | string | number | Source chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| fromToken* | string | Token to send (source) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
List every blockchain LayerHop can swap from or to: slug, numeric chain id, name, VM type (evm or svm = Solana) and native coin. Read-only.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}List the deposit addresses of the API key's account and mode (live or test), newest first: address, route, status, deposit count. Needs a LayerHop API key. Read-only.
| Argument | Type | Description |
|---|---|---|
| label | string | Only addresses with this label. |
| limit | integer | Max addresses to return (default set by the API). |
| cursor | string | nextCursor from a previous call, for the next page. |
| status | string | Only addresses with this status. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"label": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Only addresses with this label."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max addresses to return (default set by the API)."
},
"cursor": {
"type": "string",
"description": "nextCursor from a previous call, for the next page."
},
"status": {
"enum": [
"active",
"disabled"
],
"type": "string",
"description": "Only addresses with this status."
}
},
"additionalProperties": false
}List LayerHop orders (swaps built or submitted through LayerHop) where the address is the sender or recipient, newest first, with status. Public data (addresses only). Read-only.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max orders to return (default set by the API). |
| cursor | string | nextCursor from a previous list_orders call, for the next page. |
| status | string | Only orders with this status. |
| address* | string | Wallet address (EVM 0x... or Solana base58). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max orders to return (default set by the API)."
},
"cursor": {
"type": "string",
"description": "nextCursor from a previous list_orders call, for the next page."
},
"status": {
"enum": [
"built",
"submitted",
"pending",
"filled",
"refunded",
"failed",
"expired"
],
"type": "string",
"description": "Only orders with this status."
},
"address": {
"type": "string",
"minLength": 1,
"description": "Wallet address (EVM 0x... or Solana base58)."
}
},
"additionalProperties": false
}List LayerHop's built-in tokens on one chain (symbol, contract address or mint, decimals). Symbols can be used directly in get_quote; other tokens can be quoted by address. Read-only.
| Argument | Type | Description |
|---|---|---|
| chain* | string | number | The chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain"
],
"properties": {
"chain": {
"type": [
"string",
"number"
],
"description": "The chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
}
},
"additionalProperties": false
}Ask LayerHop to check a deposit address for new deposits right away (instead of waiting for the next scheduled check). Call it when the user says they sent funds, then call get_deposit_address after ~15-30 s. Needs a LayerHop API key.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit address id (starts with "da_"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^da_",
"description": "Deposit address id (starts with \"da_\")."
}
},
"additionalProperties": false
}Tell LayerHop that the user's wallet broadcast the transaction for a quoteId, so the order is tracked (status, webhooks). Call this once after broadcasting, with the EVM tx hash (0x + 64 hex) or Solana signature. Idempotent. Does not sign or send anything.
| Argument | Type | Description |
|---|---|---|
| txHash* | string | Source-chain transaction hash (EVM 0x...) or Solana signature (base58). |
| quoteId* | string | quoteId from get_quote (starts with "q_"). Quotes expire after a short time (see expiresAt). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId",
"txHash"
],
"properties": {
"txHash": {
"type": "string",
"minLength": 1,
"description": "Source-chain transaction hash (EVM 0x...) or Solana signature (base58)."
},
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
}
},
"additionalProperties": false
}TEST MODE ONLY (lh_test_ key and a test deposit address): record a fake deposit so the integration can be tested end to end; it becomes a test order that settles with webhooks. The amount decides the outcome: base units ending in 4001 -> refunded, 4002 -> failed, anything else -> filled. Moves no real funds. Fails with a live key.
| Argument | Type | Description |
|---|---|---|
| id* | string | Deposit address id (starts with "da_"). |
| amount | string | number | Deposit amount in HUMAN units of the address token ("25" = 25 USDC). Give this or amountBaseUnits. |
| amountBaseUnits | string | Deposit amount in base units (e.g. "25004001" to test a refund for a 6-decimal token). Give this or amount. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^da_",
"description": "Deposit address id (starts with \"da_\")."
},
"amount": {
"type": [
"string",
"number"
],
"description": "Deposit amount in HUMAN units of the address token (\"25\" = 25 USDC). Give this or amountBaseUnits."
},
"amountBaseUnits": {
"type": "string",
"pattern": "^\\d+$",
"description": "Deposit amount in base units (e.g. \"25004001\" to test a refund for a 6-decimal token). Give this or amount."
}
},
"additionalProperties": false
}Build the transaction for a quoteId and dry-run it on-chain (EVM eth_call + gas estimate from the sender; Solana simulateTransaction) without sending anything or recording an order. Reports whether it would succeed, gas / compute units, whether an ERC-20 approval is still needed, and the error if it would fail. Read-only: The LayerHop MCP server holds no private keys and never signs or broadcasts transactions.
| Argument | Type | Description |
|---|---|---|
| quoteId* | string | quoteId from get_quote (starts with "q_"). Quotes expire after a short time (see expiresAt). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId"
],
"properties": {
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
}
},
"additionalProperties": false
}| recipient* | string | Address that receives toToken on toChain. |
| fromTokenDecimals | integer | Only needed when fromToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fromChain",
"fromToken",
"toChain",
"toToken",
"recipient",
"refundTo"
],
"properties": {
"label": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Your reference for this address (1-64 chars), filterable in list_deposit_addresses."
},
"amount": {
"type": [
"string",
"number"
],
"description": "HUMAN units of fromToken (\"25\" = 25 USDC). Required when reusable is false (the exact amount to send); otherwise only sizes the estimate. Minimum worth $1."
},
"toChain": {
"type": [
"string",
"number"
],
"description": "Destination chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"toToken": {
"type": "string",
"minLength": 1,
"description": "Token to deliver (destination) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"metadata": {
"type": "object",
"description": "Up to 20 string key-value pairs stored on the address.",
"additionalProperties": {
"type": "string"
}
},
"refundTo": {
"type": "string",
"minLength": 1,
"description": "The user's OWN address on fromChain for refunds. NEVER an exchange (CEX) deposit address: refunds never go back to an exchange."
},
"reusable": {
"type": "boolean",
"description": "true (default): reusable for this route with any amount. false: one-time address for exactly `amount`."
},
"fromChain": {
"type": [
"string",
"number"
],
"description": "Source (deposit) chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"fromToken": {
"type": "string",
"minLength": 1,
"description": "The ONLY token the user may send to the address (source) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"recipient": {
"type": "string",
"minLength": 1,
"description": "Address that receives toToken on toChain."
},
"fromTokenDecimals": {
"type": "integer",
"maximum": 36,
"minimum": 0,
"description": "Only needed when fromToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s)."
}
},
"additionalProperties": false
}| string | number |
| Source chain: slug ("base", "solana", "ethereum", "arbitrum"...) or numeric chain id (Solana is 7565164). See list_chains. |
| fromToken* | string | Token to send (source) token: symbol from list_tokens ("USDC", "ETH", "SOL") or the token contract address / SPL mint. Use "native" for the chain's gas coin. |
| recipient | string | Address that receives funds on the destination chain. Defaults to sender when both chains use the same VM; REQUIRED for EVM <-> Solana. |
| slippageBps | integer | Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%). |
| toTokenDecimals | integer | Only needed when toToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s). |
| fromTokenDecimals | integer | Only needed when fromToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fromChain",
"fromToken",
"amount",
"toChain",
"toToken",
"sender"
],
"properties": {
"amount": {
"type": [
"string",
"number"
],
"description": "Amount to send in HUMAN units of fromToken as a decimal string, e.g. \"100\" for 100 USDC or \"0.05\" for 0.05 ETH. NOT base units/wei/lamports. Must be greater than 0."
},
"sender": {
"type": "string",
"minLength": 1,
"description": "Wallet address that sends the funds on the source chain (0x... for EVM, base58 for Solana). Only used to build the quote; no access is needed."
},
"toChain": {
"type": [
"string",
"number"
],
"description": "Destination chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"toToken": {
"type": "string",
"minLength": 1,
"description": "Token to receive (destination) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"fromChain": {
"type": [
"string",
"number"
],
"description": "Source chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"fromToken": {
"type": "string",
"minLength": 1,
"description": "Token to send (source) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"recipient": {
"type": "string",
"description": "Address that receives funds on the destination chain. Defaults to sender when both chains use the same VM; REQUIRED for EVM <-> Solana."
},
"slippageBps": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%)."
},
"toTokenDecimals": {
"type": "integer",
"maximum": 36,
"minimum": 0,
"description": "Only needed when toToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s)."
},
"fromTokenDecimals": {
"type": "integer",
"maximum": 36,
"minimum": 0,
"description": "Only needed when fromToken is an address that is not in list_tokens: the token's decimals (e.g. 6 for USDC, 18 for most ERC-20s)."
}
},
"additionalProperties": false
}| recipient |
| string |
| Optional destination address to prefill (the user can still edit it). |
| slippageBps | integer | Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fromChain",
"fromToken",
"toChain",
"toToken"
],
"properties": {
"amount": {
"type": [
"string",
"number"
],
"description": "Amount to send in HUMAN units of fromToken as a decimal string, e.g. \"100\" for 100 USDC or \"0.05\" for 0.05 ETH. NOT base units/wei/lamports. Must be greater than 0."
},
"toChain": {
"type": [
"string",
"number"
],
"description": "Destination chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"toToken": {
"type": "string",
"minLength": 1,
"description": "Token to receive (destination) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"fromChain": {
"type": [
"string",
"number"
],
"description": "Source chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
},
"fromToken": {
"type": "string",
"minLength": 1,
"description": "Token to send (source) token: symbol from list_tokens (\"USDC\", \"ETH\", \"SOL\") or the token contract address / SPL mint. Use \"native\" for the chain's gas coin."
},
"recipient": {
"type": "string",
"description": "Optional destination address to prefill (the user can still edit it)."
},
"slippageBps": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%)."
}
},
"additionalProperties": false
}