# LeoKit — Full Documentation

> Cross-chain DeFi infrastructure for developers and AI agents. Swap 20,000+ tokens across 30+ blockchains at 0.10% fee — the lowest in the industry.

## About LeoKit

LeoKit is a cross-chain swap and bridge API that aggregates 5+ DEX protocols (THORChain, Maya Protocol, Chainflip, Near Intents, Relay) across 30+ blockchains with 20,000+ supported tokens. It provides both a REST API for developers and an MCP Server for AI agents.

LeoKit is free to integrate — $0 upfront, no subscription, no credit card required. When end users swap, the fee is just 0.10% (10 basis points) — the lowest in the industry. For comparison, Trust Wallet charges 1.7% (17x more).

LeoKit is non-custodial: it only generates unsigned transactions. Private keys never leave the user's wallet.

## MCP Server for AI Agents

The LeoKit MCP Server gives AI assistants access to cross-chain DeFi through the Model Context Protocol (MCP). Instead of writing complex API calls, users can say "Swap 0.5 ETH to USDC on the best route" and their AI handles the rest.

### Compatible AI Clients
- Claude Desktop
- Claude Code
- Cursor
- Windsurf
- Cline
- VS Code
- Any MCP-compatible client

### Install
```
npx -y @leodex/leokit-mcp
```

### MCP Server Setup

#### Option 1: Auto Generate Config (Recommended)
1. Sign up at https://dash.leokit.dev (free, no credit card)
2. Click "Generate Config" and download your personalized JSON
3. Paste into your Claude Desktop config file
4. Restart Claude Desktop and start swapping

#### Option 2: Remote Setup (Manual)
1. Get your free API key from https://dash.leokit.dev
2. Open your Claude Desktop config file:
   - Mac/Linux: ~/.config/claude/claude_desktop_config.json
   - Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Add the following config:

```json
{
  "mcpServers": {
    "leokit": {
      "transport": {
        "type": "http",
        "url": "http://mcp.leokit.dev/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}
```

4. Replace YOUR_API_KEY with your actual key from dash.leokit.dev
5. Restart Claude Desktop
6. Test with: "List available LeoKit tools"

#### Option 3: Local Install
1. Install: npm install -g @leodex/leokit-mcp
2. Add to your Claude Desktop config:

```json
{
  "mcpServers": {
    "leokit": {
      "command": "npx",
      "args": ["-y", "@leodex/leokit-mcp"],
      "env": {
        "LEOKIT_API_KEY": "your-api-key"
      }
    }
  }
}
```

3. Replace your-api-key with your actual key from dash.leokit.dev
4. Restart Claude Desktop

## MCP Tools Reference

### leokit_get_quote
Find the cheapest swap route across 5+ DEX protocols and 30+ blockchains.
- Compares rates across THORChain, Maya, Chainflip, Near Intents, Relay
- Returns expected output, fees, and estimated time
- Supports BTC, ETH, SOL, USDC, USDT, and 20,000+ tokens
- Example prompt: "Get me a quote for swapping 1 ETH to USDC"
- Example prompt: "What's the best rate for swapping 0.5 BTC to ETH?"

### leokit_create_deposit
Generate unsigned swap transactions ready for wallet signing.
- Non-custodial — private keys never leave your wallet
- Returns unsigned transaction data for user review and signing
- Supports all chains and tokens available via get_quote
- Example prompt: "Create a swap transaction for 0.5 BTC to ETH via THORChain"

### leokit_check_status
Track any swap from deposit detection to final delivery in real time.
- Returns current status, confirmations, and estimated completion
- Example prompt: "Check the status of my last swap"
- Example prompt: "What's the status of transaction abc123?"

### leokit_get_assets
Search 20,000+ tokens across every supported chain.
- Filter by chain, name, or symbol
- Returns asset identifiers, chains, and metadata
- Example prompt: "What tokens are available on Arbitrum?"
- Example prompt: "Find the USDC contract on Ethereum"

### leokit_get_balances
Check wallet balances across multiple blockchains in a single call.
- Supports all 30+ blockchains
- Returns token balances with USD values
- Example prompt: "Show my wallet balances across all chains"
- Example prompt: "What's my ETH balance on 0x742d..."

## Coverage

- **30+ Blockchains**: Bitcoin, Ethereum, BNB Chain, Solana, Cosmos, Arbitrum, Avalanche, Optimism, Polygon, Base, THORChain, Maya, Chainflip, Near, Litecoin, Bitcoin Cash, Dogecoin, and more
- **5+ DEX Protocols**: THORChain, Maya Protocol, Chainflip, Near Intents, Relay
- **107+ DEXes**: Aggregated for optimal swap routes
- **20,000+ Tokens**: Including BTC, ETH, SOL, USDC, USDT, AVAX, XRP, BNB, LTC, BCH, DOGE, XMR, ZEC, WBTC, and more
- **0.10% Fee**: The lowest swap fee in the industry

## Security — Non-Custodial by Design

1. **AI Quotes**: Your AI finds the cheapest route across 5+ protocols and 30+ chains
2. **You Review**: See exact amounts, fees, and routes before any transaction is created
3. **You Sign**: Private keys never leave your wallet. You approve every transaction

LeoKit generates unsigned transactions only. Your private keys are never exposed to LeoKit or the AI assistant. All swaps execute through decentralized protocols.

## Pricing

- Free to integrate — $0 upfront
- No subscription, no credit card required
- 0.10% per swap (10 basis points) when end users swap
- This is the lowest fee in the industry
- No hidden fees, no setup costs

## REST API

LeoKit also provides a simple REST API for developers:

- GET https://api.leokit.dev/quote — Get swap quotes
- POST https://api.leokit.dev/swap — Execute swaps
- Full documentation: https://docs.leokit.dev
- Dashboard and API keys: https://dash.leokit.dev

## Frequently Asked Questions

**Is the LeoKit MCP Server free?**
LeoKit is free to integrate — $0 upfront, no subscription, no credit card. When end users swap, the fee is just 0.10% (10 basis points) — the lowest in the industry.

**Does my AI agent have access to my private keys?**
Never. LeoKit only generates unsigned transactions. Your private keys never leave your wallet. The AI handles quoting and routing — you review and sign every transaction yourself.

**Which AI assistants work with the MCP Server?**
Any MCP-compatible AI assistant works, including Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and other MCP clients. The server uses standard HTTP transport.

**What blockchains and tokens are supported?**
LeoKit aggregates 5+ DEX protocols covering 30+ blockchains and 20,000+ tokens — Bitcoin, Ethereum, Solana, Cosmos, Arbitrum, Avalanche, and many more.

**How do I set up the LeoKit MCP Server with Claude Desktop?**
Use our Config Generator at dash.leokit.dev. Sign up, click "Generate Config", paste the JSON into your Claude Desktop config file, and restart. Takes about 30 seconds.

**Can I run the MCP Server locally?**
Yes. Install via npm (npm install -g @leodex/leokit-mcp) or use npx for zero-install setup.

**How much does LeoKit cost?**
LeoKit is free to integrate. When end users swap, the fee is just 0.10% (10 basis points). No hidden fees, no subscriptions, no setup costs.

## Blog Posts

### Give Your AI Agent DeFi Superpowers: Introducing the LeoKit MCP Server
URL: https://leokit.dev/blog/leokit-mcp-server-cross-chain-defi-swaps
LeoKit's MCP server gives AI agents like Claude the ability to execute cross-chain DeFi swaps across 30+ blockchains. One npm command, five tools, 0.10% fees, non-custodial. Here's how it works and how to get started in 60 seconds.


## Links

- Website: https://leokit.dev
- MCP Server Setup: https://leokit.dev/mcp
- Blog: https://leokit.dev/blog
- API Documentation: https://docs.leokit.dev
- Dashboard / Get API Key: https://dash.leokit.dev
- npm Package: https://www.npmjs.com/package/@leodex/leokit-mcp
- Leodex Swap App: https://leodex.io

## Contact

- Twitter: https://twitter.com/leodexio
- Discord: https://discord.gg/kg9QrKHkpr
- GitHub: https://github.com/LeoFinance