KAIA-MCP Server
Planned support for Chainlink CCIP (Cross-Chain Interoperability Protocol) for cross-chain operations on the KAIA blockchain.
Provides real-time token price data from CoinMarketCap API for cryptocurrencies and KAIA ecosystem tokens.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KAIA-MCP Server check my wallet balance and show current APY for KLAY on KiloLend"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KAIA-MCP Server
AI × DeFi Infrastructure for the Kaia Ecosystem
The KAIA-MCP Server enables AI agents to interact directly with DeFi protocols on the KAIA blockchain.
Built on the Model Context Protocol (MCP), it connects tools like Claude Desktop or Cursor.ai with live blockchain data and transaction execution.
Features
Multi-Protocol Support
Lending: KiloLend (Compound v2 fork) for supply, borrow, and repay
DEX: DragonSwap V3 for quotes and swaps
Price API: Real-time token prices from CoinMarketCap & CoinGecko API
AI-Managed Vaults: Automated cross-protocol strategies to boost yield (planned)
Market Intelligence: Real-time APYs, utilization, and TVL
Smart Wallet: Unified position and balance tracking
Related MCP server: Saros MCP Server
Using with Claude Desktop
Install Claude Desktop if you haven't already
Open Claude Desktop settings
Add the KAIA MCP client 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
}
}
}Agent Modes
Read-Only Mode (Default)
Purpose: Safe exploration and data analysis without transaction capabilities
Use Case: Perfect for research, market analysis, and monitoring positions
Capabilities: Query market data, check wallet balances, monitor positions, get swap quotes
Security: No private key required - completely safe for data access
Configuration: Set
KAIA_AGENT_MODEto "readonly" or omit the private key
Transaction Mode
Purpose: Full DeFi operations with the ability to execute transactions
Use Case: Active trading, lending, borrowing, and portfolio management
Capabilities: All read-only features plus execute transactions, supply/borrow assets, transfer tokens, execute DEX swaps
Security: Requires
KAIA_PRIVATE_KEY- ensure secure key managementConfiguration: Set
KAIA_AGENT_MODEto "transaction" and provide a valid private key
Architecture
This MCP server follows a clean, modular architecture designed for multi-protocol support:
src/
├── agent/
│ └── wallet.ts # Unified WalletAgent for all operations
├── mcp/ # MCP tool definitions and implementations
│ ├── index.ts # Main MCP server entry point and tool registry
│ ├── kilolend/ # KiloLend protocol tools
│ ├── dragonswap/ # DragonSwap V3 protocol tools
│ ├── price-api/ # Price API tools for token prices
│ └── wallet/ # General wallet operations
├── tools/ # Core utility functions
│ └── price-api/ # Price API core functions
├── contracts/ # Smart contract interfaces and ABIs
│ ├── comptroller.ts # KiloLend Comptroller contract
│ ├── ctoken.ts # KiloLend cToken contracts
│ ├── erc20.ts # Standard ERC-20 interface
│ ├── wkaia.ts # WKAIA contract interface
│ └── dragonswap/ # DragonSwap contract ABIs
├── utils/ # Utility functions and helpers
│ ├── errors.ts # Error handling classes
│ ├── formatting.ts # Token amount formatting utilities
│ └── validation.ts # Input validation functions
├── config.ts # Configuration management and environment setup
├── types.ts # TypeScript type definitions
└── index.ts # Main server entry pointInstallation
npm install
npm run buildConfiguration
Environment Variables
Create a .env file based on .env.example:
# Required
KAIA_RPC_URL="https://public-en.node.kaia.io" # KAIA Mainnet RPC URL
# Optional
KAIA_PRIVATE_KEY="your_private_key_here" # Wallet private key (for transaction mode)
KAIA_AGENT_MODE="readonly" # "readonly" or "transaction" (defaults to readonly)
KAIA_NETWORK="kaia" # Network (only kaia supported currently)Available Tools
Wallet Tools
Read-Only Tools
Tool | Description |
| Get wallet information and token balances |
Transaction Tools
Tool | Description |
| Send native KAIA tokens |
| Send ERC-20 tokens |
| Wrap KAIA to WKAIA |
| Unwrap WKAIA to KAIA |
| Check token allowance for operations |
| Approve tokens for operations |
KiloLend Tools
Read-Only Tools
Tool | Description |
| Check account liquidity and health factor |
| Get all lending markets with rates |
| Get protocol statistics and TVL |
Transaction Tools
Tool | Description |
| Enter markets to enable collateral usage |
| Supply assets to lending market |
| Borrow from lending market |
| Repay borrowed positions |
| Redeem cTokens (withdraw by cToken amount) |
| Redeem underlying tokens (withdraw by underlying amount) |
Price API Tools
Read-Only Tools
Tool | Description |
| Get all available prices from KiloLend price API |
| Get prices for specific tokens (e.g., ['KAIA', 'BTC', 'ETH']) |
| Get KAIA ecosystem token prices only (KAIA, BORA, MBX, SIX, SOMNIA, stKAIA) |
| Get major cryptocurrency prices (BTC, ETH) |
| Quick price overview of KAIA, BTC, and ETH |
DragonSwap Tools
Read-Only Tools
Tool | Description |
| Get DragonSwap pool information |
| Get swap quotes without executing |
| Get best routing path for swaps (supports multi-hop) |
Transaction Tools
Tool | Description |
| Execute token swaps on DragonSwap |
Supported Tokens
KiloLend Supported Tokens
KAIA: Native KAIA token
USDT: Tether USD (
0xd077a400968890eacc75cdc901f0356c943e4fdb)SIX: SIX token (
0xEf82b1C6A550e730D8283E1eDD4977cd01FAF435)BORA: BORA token (
0x02cBE46fB8A1F579254a9B485788f2D86cAD51aa)MBX: MARBLEX token (
0xD068c52d81f4409B9502dA926aCE3301cc41f623)stKAIA: Lair Staked KAIA (
0x42952B873ed6f7f0A7E4992E2a9818E3A9001995)
DragonSwap Supported Tokens
KAIA: Native token
WKAIA: Wrapped KAIA (
0x19aac5f612f524b754ca7e7c41cbfa2e981a4432)USDT: Official USDT(
0xd077a400968890eacc75cdc901f0356c943e4fdb)USDT: Wormhole USDT(
0x5c13e303a62fc5dedf5b52d66873f2e59fedadc2)BORA: BORA Token (
0x02cBE46fB8A1F579254a9B485788f2D86cAD51aa)MBX: MARBLEX Token (
0xD068c52d81f4409B9502dA926aCE3301cc41f623)stKAIA: Lair Staked KAIA (
0x42952B873ed6f7f0A7E4992E2a9818E3A9001995)
Future Protocol Support
We're actively working on adding support for:
Additional Lending Protocols: More lending platforms
Staking Protocols: Liquid staking and Lair Finance integration
Cross-Chain Messaging: Chainlink CCIP for cross-chain operations
Yield Farming: Cross-protocol yield optimization
Contract Addresses
Kaia Mainnet
KiloLend (Compound v2)
Comptroller:
0x0B5f0Ba5F13eA4Cb9C8Ee48FB75aa22B451470C2Markets:
cUSDT:
0x498823F094f6F2121CcB4e09371a57A96d619695cSIX:
0xC468dFD0C96691035B3b1A4CA152Cb64F0dbF64ccBORA:
0x7a937C07d49595282c711FBC613c881a83B9fDFDcMBX:
0xE321e20F0244500A194543B1EBD8604c02b8fA85cKAIA:
0x98Ab86C97Ebf33D28fc43464353014e8c9927aB3cStKAIA:
0x0BC926EF3856542134B06DCf53c86005b08B9625
DragonSwap V3
Router:
0xA324880f884036E3d21a09B90269E1aC57c7EC8aQuoter V2:
0x673d88960D320909af24db6eE7665aF223fec060Factory:
0x7431A23897ecA6913D5c81666345D39F27d946A4
Troubleshooting
If you're using Ubuntu or another Linux environment with NVM, you'll need to manually configure the path. Follow these steps:
Install the KAIA MCP under your current NVM-managed Node.js version.
npm install -g @tamago-labs/kaia-mcpDue to how NVM installs libraries, you may need to use absolute paths in your config. Replace the example values below with your actual username and Node version:
{
"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"
}
}
}
}Restart Claude Desktop and it should work now.
Environment Variable Issues
If you encounter issues with environment variables not being recognized:
Check required variables: Make sure
KAIA_RPC_URLis always setVerify mode settings:
KAIA_AGENT_MODEshould be either "readonly" or "transaction"Private key format:
KAIA_PRIVATE_KEYmust be 64 hex characters (with or without 0x prefix)Debug logging: The server will log all configuration on startup to stderr
Work with Local Files
When working with local files especially when using KAIA CLI tools for smart contract development to create, build, and test a Move package on your machine—you'll need to import an additional MCP server library of filesystem made by Claude team. Use with:
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"${workspaceFolder}"
],
"env":{
},
"disabled": false
}workspaceFolder refers to your working directory. You can provide more than one argument. Subfolders or specific files can then be referenced in your AI prompt.
If you're using Linux and encounter issues during setup, please refer to the troubleshooting section.
License
MIT License - see LICENSE file for details.
Available Tools
13 toolsdragonswap_get_pool_infoB
Get detailed information about a DragonSwap V3 pool
Inputs: token0 (required), token1 (required), fee.
dragonswap_get_quoteA
Get a quote for swapping tokens on DragonSwap V3 DEX. Note: USDT uses 6 decimals, most other tokens use 18 decimals. For stKAIA, you can use either 'stKAIA' or 'STAKED_KAIA'.
Inputs: tokenIn (required), tokenOut (required), amountIn (required), amountInDecimals, +1 more.
dragonswap_get_routeA
Get the best routing path for swapping tokens (supports multi-hop for better prices) on DragonSwap V3 DEX
Inputs: tokenIn (required), tokenOut (required), amountIn (required), amountInDecimals.
get_all_pricesA
Get comprehensive market data including prices, market capitalization, 24h trading volume, and 24h price changes for all available tokens from the KiloLend price API (KAIA ecosystem tokens and major cryptocurrencies)
Inputs: no named parameters.
get_kaia_ecosystem_pricesA
Get comprehensive market data including prices, market capitalization, 24h trading volume, and 24h price changes for KAIA ecosystem tokens only (KAIA, BORA, MBX, SIX, stKAIA)
Inputs: no named parameters.
get_major_crypto_pricesB
Get comprehensive market data including prices, market capitalization, 24h trading volume, and 24h price changes for major cryptocurrencies (BTC, ETH)
Inputs: no named parameters.
get_quick_pricesA
Get quick comprehensive market overview including prices, market capitalization, 24h trading volume, and 24h price changes for KAIA, BTC, and ETH
Inputs: no named parameters.
get_token_pricesB
Get comprehensive market data including prices, market capitalization, 24h trading volume, and 24h price changes for specific token symbols (e.g., 'KAIA', 'BTC', 'ETH', 'BORA')
Inputs: symbols (required).
kaia_get_wallet_infoC
Get comprehensive wallet information including all token balances
Inputs: no named parameters.
kilolend_get_account_liquidityB
Check account liquidity, health factor, and borrowing capacity on KiloLend
Inputs: account_address.
kilolend_get_kilo_pointsB
Get user KILO points balance
Inputs: account_address.
kilolend_get_lending_marketsB
Get all lending markets KiloLend with their current rates and statistics
Inputs: no named parameters.
kilolend_get_lending_statsA
Get overall KiloLend protocol statistics and TVL information
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
The price tools (get_all_prices, get_kaia_ecosystem_prices, get_major_crypto_prices, get_quick_prices, get_token_prices) heavily overlap, making it unclear which one to use. The other groups are distinct, but the redundancy in the price category hurts disambiguation.
Naming uses snake_case with prefixes (dragonswap_, kilolend_, kaia_) and a generic 'get_' for price tools. The pattern is mostly consistent but the price tools lack a domain prefix and vary in specificity, creating some inconsistency.
13 tools is a reasonable number for a server covering three domains. However, the redundant price tools could be consolidated, slightly reducing the count to improve focus.
The server is read-only: DragonSwap lacks swap execution, KiloLend lacks deposit/borrow/repay actions, and wallet info has no transaction capabilities. The price coverage is thorough but operational gaps are significant.
Maintenance
Related MCP Connectors
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
Agentic AI runtime: persistent memory, vault, autonomous agents, deep research, DeFi execution.
Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains
AI Agent Utility Layer for agent safety, web monitoring, crypto research and tool discovery.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to interact with cryptocurrency ecosystems through wallet management, trading operations (swaps, DCA, limit orders), staking, and multi-chain support starting with Solana.37GPL 3.0
- AlicenseBqualityDmaintenanceEnables AI agents to interact with Saros DeFi through natural language, providing tools for liquidity pool management, portfolio analytics, farming positions, and swap quotes on Solana.5MIT
- FlicenseCqualityCmaintenanceEnables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon, Arbitrum, and more.10049 npm44-
- AlicenseAqualityDmaintenanceEnables AI agents to interact with HyperLend protocol and Kittenswap DEX on Hyperliquid EVM network. Supports DeFi operations including lending, borrowing, withdrawing assets, and token swapping with comprehensive portfolio management.8MIT