LayerHop

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.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": [
        "string",
        "number"
      ],
      "description": "The chain: slug (\"base\", \"solana\", \"ethereum\", \"arbitrum\"...) or numeric chain id (Solana is 7565164). See list_chains."
    }
  },
  "required": [
    "chain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "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."
    },
    "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."
    },
    "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."
    },
    "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",
      "minimum": 1,
      "maximum": 5000,
      "description": "Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%)."
    },
    "fromTokenDecimals": {
      "type": "integer",
      "minimum": 0,
      "maximum": 36,
      "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)."
    },
    "toTokenDecimals": {
      "type": "integer",
      "minimum": 0,
      "maximum": 36,
      "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)."
    }
  },
  "required": [
    "fromChain",
    "fromToken",
    "amount",
    "toChain",
    "toToken",
    "sender"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "quoteId": {
      "type": "string",
      "pattern": "^q_",
      "description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
    }
  },
  "required": [
    "quoteId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "quoteId": {
      "type": "string",
      "pattern": "^q_",
      "description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
    }
  },
  "required": [
    "quoteId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "quoteId": {
      "type": "string",
      "pattern": "^q_",
      "description": "quoteId from get_quote (starts with \"q_\"). Quotes expire after a short time (see expiresAt)."
    },
    "txHash": {
      "type": "string",
      "minLength": 1,
      "description": "Source-chain transaction hash (EVM 0x...) or Solana signature (base58)."
    }
  },
  "required": [
    "quoteId",
    "txHash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "jupiter",
        "relay",
        "debridge",
        "mayan",
        "zerox",
        "kyberswap",
        "odos",
        "lifi",
        "mock"
      ],
      "description": "The provider of the quote that was executed (the `provider` field from get_quote / build_transaction)."
    },
    "txHash": {
      "type": "string",
      "minLength": 1,
      "description": "Source-chain transaction hash (EVM) or signature (Solana)."
    }
  },
  "required": [
    "provider",
    "txHash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "Wallet address (EVM 0x... or Solana base58)."
    },
    "status": {
      "type": "string",
      "enum": [
        "built",
        "submitted",
        "pending",
        "filled",
        "refunded",
        "failed",
        "expired"
      ],
      "description": "Only orders with this status."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "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."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "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."
    },
    "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."
    },
    "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."
    },
    "recipient": {
      "type": "string",
      "description": "Optional destination address to prefill (the user can still edit it)."
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "description": "Max slippage in basis points (1 bp = 0.01%). Default 50 (= 0.5%)."
    }
  },
  "required": [
    "fromChain",
    "fromToken",
    "toChain",
    "toToken"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "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."
    },
    "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."
    },
    "recipient": {
      "type": "string",
      "minLength": 1,
      "description": "Address that receives toToken on toChain."
    },
    "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`."
    },
    "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."
    },
    "fromTokenDecimals": {
      "type": "integer",
      "minimum": 0,
      "maximum": 36,
      "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)."
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Your reference for this address (1-64 chars), filterable in list_deposit_addresses."
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Up to 20 string key-value pairs stored on the address."
    }
  },
  "required": [
    "fromChain",
    "fromToken",
    "toChain",
    "toToken",
    "recipient",
    "refundTo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "active",
        "disabled"
      ],
      "description": "Only addresses with this status."
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Only addresses with this label."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max addresses to return (default set by the API)."
    },
    "cursor": {
      "type": "string",
      "description": "nextCursor from a previous call, for the next page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^da_",
      "description": "Deposit address id (starts with \"da_\")."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^da_",
      "description": "Deposit address id (starts with \"da_\")."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^da_",
      "description": "Deposit address id (starts with \"da_\")."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}