MCP Setup for Claude Desktop - LeoKit Documentation

Quick Setup

Get LeoKit’s cross-chain swap tools integrated into Claude Desktop in under 2 minutes.

Prerequisites:

Claude Desktop installed
A LeoKit API key from dash.leokit.dev

Setup Options

Remote Server

Use our hosted MCP server - no installation required

Local Installation

Run the MCP server on your machine via npm

Remote Server (Recommended)

Step 1: Get Your API Key

Visit dash.leokit.dev
Sign up or log in
Navigate to API Keys section
Create a new API key

Step 2: Configure Claude Desktop

Add this configuration to your Claude Desktop config file: Config File Location:

macOS/Linux: ~/.config/claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "leokit": {
      "transport": {
        "type": "http",
        "url": "https://mcp.leokit.dev/mcp",
        "headers": {
          "Authorization": "Bearer YOUR-LEOKIT-API-KEY"
        }
      }
    }
  }
}

Replace YOUR-LEOKIT-API-KEY with your actual API key from the dashboard

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

Step 4: Verify Setup

Test the integration by asking Claude:

"List available LeoKit tools"

You should see tools like leokit_get_quote, leokit_create_deposit, etc.

Local Installation

If you prefer to run the MCP server locally:

Step 1: Install via NPM

npm install -g @inleo/leokit-mcp

Step 2: Configure Claude Desktop

Add this configuration:

{
  "mcpServers": {
    "leokit": {
      "command": "npx",
      "args": ["-y", "@inleo/leokit-mcp"],
      "env": {
        "LEOKIT_API_KEY": "YOUR-LEOKIT-API-KEY"
      }
    }
  }
}

Step 3: Restart and Verify

Restart Claude Desktop and verify as described above.

One-Line Setup Scripts

For automated setup, use our installation scripts:

curl -fsSL https://raw.githubusercontent.com/LeoFinance/leodex-backend/main/apps/leokit-mcp/scripts/setup-claude.sh | bash

irm https://raw.githubusercontent.com/LeoFinance/leodex-backend/main/apps/leokit-mcp/scripts/setup-claude.ps1 | iex

Available Tools

Once configured, you can use these tools through Claude:

leokit_get_quote

Get swap quotes from multiple DEX protocols across 30+ blockchains.Example: “Get me a quote for swapping 1 ETH to USDC”

leokit_create_deposit

Generate unsigned transactions for executing swaps.Example: “Create a deposit transaction for quote ID abc123”

leokit_check_status

Check the status of a swap transaction.Example: “Check the status of my swap with transaction hash 0x…”

leokit_get_assets

List all supported tokens and chains.Example: “Show me all available assets on Arbitrum”

leokit_get_balances

Check wallet balances across multiple chains.Example: “Check my ETH balance at 0x…”

Example Usage

Here’s how to use LeoKit tools through Claude:

Get a Quote

"Get me a quote for swapping 1 BTC to ETH.
 My origin address is bc1q...
 and destination is 0x..."

Review Options

Claude will fetch quotes from multiple protocols (THORChain, MAYAChain, Chainflip, etc.) and present the best options.

Create Transaction

"Create a deposit transaction for the THORChain quote"

Execute

Claude will generate the unsigned transaction. You can then sign and broadcast it using your preferred wallet.

Troubleshooting

Tools Not Appearing

Solutions:

Verify your API key is correct
Check the config file path matches your OS
Ensure Claude Desktop was fully restarted
Check for JSON syntax errors in the config file

Authentication Errors

Solutions:

Confirm your API key is active in the dashboard
Verify the API key is correctly placed in the config
Check that there are no extra spaces in the Bearer token

Connection Issues

Solutions:

For remote setup: Check internet connection
For local setup: Verify npm package is installed
Check firewall settings aren’t blocking connections

Advanced Configuration

Custom API Endpoint

To use a self-hosted LeoKit API:

{
  "mcpServers": {
    "leokit": {
      "transport": {
        "type": "http",
        "url": "https://mcp.leokit.dev/mcp",
        "headers": {
          "Authorization": "Bearer YOUR-API-KEY"
        }
      }
    }
  }
}

Then set the environment variable:

export LEOKIT_API_URL="https://your-api.example.com"

Multiple Configurations

You can run both local and remote setups simultaneously with different names:

{
  "mcpServers": {
    "leokit-remote": {
      "transport": {
        "type": "http",
        "url": "https://mcp.leokit.dev/mcp",
        "headers": {
          "Authorization": "Bearer YOUR-API-KEY"
        }
      }
    },
    "leokit-local": {
      "command": "npx",
      "args": ["-y", "@inleo/leokit-mcp"],
      "env": {
        "LEOKIT_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Need Help?

Dashboard: dash.leokit.dev
Documentation: docs.leokit.dev
Support: Join our Discord

Next Steps

MCP Integration Guide

Learn more about using MCP tools

Complete Swap Flow

Understand the full swap process

​Quick Setup

​Setup Options

Remote Server

Local Installation

​Remote Server (Recommended)

​Step 1: Get Your API Key

​Step 2: Configure Claude Desktop

​Step 3: Restart Claude Desktop

​Step 4: Verify Setup

​Local Installation

​Step 1: Install via NPM

​Step 2: Configure Claude Desktop

​Step 3: Restart and Verify

​One-Line Setup Scripts

​Available Tools

​Example Usage

​Troubleshooting

​Advanced Configuration

​Custom API Endpoint

​Multiple Configurations

​Need Help?

​Next Steps

MCP Integration Guide

Complete Swap Flow

Quick Setup

Setup Options

Remote Server (Recommended)

Step 1: Get Your API Key

Step 2: Configure Claude Desktop

Step 3: Restart Claude Desktop

Step 4: Verify Setup

Local Installation

Step 1: Install via NPM

Step 2: Configure Claude Desktop

Step 3: Restart and Verify

One-Line Setup Scripts

Available Tools

Example Usage

Troubleshooting

Advanced Configuration

Custom API Endpoint

Multiple Configurations

Need Help?

Next Steps