KAIA-MCP

KAIA-MCP is a Model Context Protocol (MCP) server that enables AI agents to interact directly with DeFi protocols on the KAIA blockchain. Built as a bridge between AI tools and blockchain infrastructure, it provides seamless access to lending protocols, DEX operations, and real-time market data.

Why integrate AI with DeFi?

• Automated Portfolio Management: AI agents can monitor positions, calculate risks, and execute strategies

• Real-time Market Analysis: Access live blockchain data for informed decision-making

• Cross-Protocol Operations: Execute complex DeFi strategies across multiple protocols

• Enhanced Security: Mode-based operations with clear separation between read-only and transaction capabilities

Supported Platforms

• Claude Desktop: Native MCP integration for conversational AI interactions

• Cline: VS Code extension for development workflows

• Cursor.ai: IDE-based AI assistant with MCP support

• Other MCP-compatible tools: Any tool supporting the Model Context Protocol

---

Quick Start

Prerequisites

• Node.js 20+ installed

• KAIA RPC URL (use public endpoint: https://public-en.node.kaia.io)

• Private key (for transaction mode, optional for read-only)

• Supported AI platform (Claude Desktop, Cline, Cursor.ai, etc.)

Basic Configuration

You only need to configure environment variables in your AI client's MCP configuration:

# Required
KAIA_RPC_URL="https://public-en.node.kaia.io"

# Optional (for transaction mode)
KAIA_PRIVATE_KEY="your_private_key_here"
KAIA_AGENT_MODE="transaction"

That's it! Once configured in your AI client, KAIA-MCP will start automatically when you use the AI assistant.

---

Platform-Specific Setup

Claude Desktop

1. Install Claude Desktop from the official website

2. Open Settings and navigate to the MCP configuration

3. Add KAIA-MCP to your configuration:

{
  "mcpServers": {
    "kaia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tamago-labs/kaia-mcp"
      ],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "transaction",
        "KAIA_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      },
      "disabled": false
    }
  }
}

1. Restart Claude Desktop to load the MCP server

Read-Only Mode (Safe for exploration)

{
  "mcpServers": {
    "kaia-mcp": {
      "command": "npx",
      "args": ["-y", "@tamago-labs/kaia-mcp"],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "readonly"
      }
    }
  }
}

Linux/NVM Users

If using NVM, use absolute paths:

{
  "mcpServers": {
    "kaia-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/kaia-mcp"
      ],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "transaction",
        "KAIA_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

Other MCP-Compatible Tools

For any MCP-compatible tool, use the standard configuration format:

{
  "mcpServers": {
    "kaia-mcp": {
      "command": "npx",
      "args": ["-y", "@tamago-labs/kaia-mcp"],
      "env": {
        "KAIA_RPC_URL": "https://public-en.node.kaia.io",
        "KAIA_AGENT_MODE": "transaction",
        "KAIA_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

---

Configuration Guide

Environment Variables

Variable	Required	Description	Example
KAIA_RPC_URL	Yes	KAIA Mainnet RPC URL	https://public-en.node.kaia.io
KAIA_PRIVATE_KEY	Optional	Wallet private key for transactions	0x1234...
KAIA_AGENT_MODE	Optional	Operation mode	readonly or transaction
KAIA_NETWORK	Optional	Network selection	kaia (default)

Agent Modes

Read-Only Mode (Default)

• Purpose: Safe exploration and data analysis

• Capabilities: Query market data, check balances, monitor positions

• Security: No private key required

• Configuration: Set KAIA_AGENT_MODE=readonly or omit private key

Transaction Mode

• Purpose: Full DeFi operations

• Capabilities: All read-only features + execute transactions

• Security: Requires private key management

• Configuration: Set KAIA_AGENT_MODE=transaction and provide KAIA_PRIVATE_KEY

---

Usage Examples

Basic Queries

Check Wallet Information

Get my wallet information

Query Lending Markets

Show me all available lending markets with current APYs

Check Account Health

What is my account liquidity and health factor?

Get DEX Quotes

Get me a swap quote for 100 KAIA to USDT 

Transaction Examples

Supply to Lending Market

Supply 1000 USDT to the KiloLend market

Borrow from Lending Market

Borrow 50 KAIA from KiloLend 

Execute DEX Swap

Help swap 100 KAIA for USDT 

Wrap Native Token

Wrap 50 KAIA to WKAIA

Send Tokens

Send 10 USDT to 0x742d35Cc6634C0532925a3b8D4C9db96C4b4Db45

Advanced Workflows

Yield Farming Strategy

1. Check current USDT lending APY on KiloLend
2. Get KAIA/USDT swap quote on DragonSwap
3. Calculate potential yield from supplying swapped tokens
4. Execute swap and supply if profitable

Portfolio Rebalancing

1. Get my current positions across all protocols
2. Check market conditions and APYs
3. Identify underperforming assets
4. Execute rebalancing transactions

Risk Management

1. Monitor my account health factor
2. Check market volatility indicators
3. Calculate liquidation risks
4. Adjust positions if needed

Supported Protocols

KiloLend (Lending)

• Supply assets to earn interest

• Borrow against collateral

• Manage multiple lending markets

• Real-time APY tracking

DragonSwap V3 (DEX)

• Token swaps with best routing

• Multi-hop transactions

• Liquidity pool information

• Real-time price quotes

Wallet Operations

• Native KAIA transfers

• ERC-20 token transfers

• Token wrapping/unwrapping

• Allowance management

Response Format

All tools return structured responses:

{
  "status": "success|error",
  "message": "Human-readable message",
  "data": { ... },
  "recommendations": ["Actionable advice..."]
}

---

Ready to start your AI × DeFi journey? Configure KAIA-MCP with your preferred AI platform and begin exploring the Kaia ecosystem with intelligent automation!