KAIA

You can run the KAIA MCP Server to let AI agents interact with DeFi protocols on the KAIA blockchain. Built on the Model Context Protocol, it wires AI tools to live blockchain data and on-chain transactions, enabling safe data access or full transaction capabilities depending on your configuration.

How to use

Set up the KAIA MCP client in your AI tool to connect to the KAIA MCP Server. Choose Read-Only mode for research, market monitoring, and data queries, or switch to Transaction mode to execute on-chain operations such as lending, borrowing, or token transfers. When using Read-Only mode, you can safely query prices, balances, and positions without exposing your private key. In Transaction mode, provide your private key to enable full DeFi interactions. You can run the MCP client locally via the provided npm/npx command and configure environment variables to point at the KAIA RPC endpoint and mode.

To enable the KAIA MCP Server with Claude Desktop (or similar tools), start by installing the MCP client and then add the KAIA MCP configuration. This creates a bridge between the AI assistant and the KAIA chain, allowing you to request on-chain actions or fetch live data as part of your prompts.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you have a compatible version of Node.js and npm before proceeding.

Install the KAIA MCP package and build the server, then prepare the configuration and environment to connect to KAIA.

npm install
npm run build

# After building, you will configure the MCP server in your client settings as shown in the config example.

Additional sections

Configuration is driven by environment variables and modular MCP tool definitions. The KAIA MCP Server exposes tools for wallet operations, lending, price lookups, and cross-protocol notes for future features.

Security considerations: Read-Only mode does not require a private key and is safe for data access. Transaction mode requires a private key and should be managed securely.

Environment setup notes: you will set KAIA_RPC_URL, KAIA_AGENT_MODE, KAIA_NETWORK, and optionally KAIA_PRIVATE_KEY depending on mode.

Troubleshooting and tips: if you are on Linux with NVM, you may need absolute paths in your MCP client configuration. If environment variables are not recognized, verify required keys and correct formats for private keys.

Work with local files and filesystem support: you can reference local workspace paths to extend MCP capabilities within Claude Desktop or your AI tooling environment.

Environment variables and configuration notes

The KAIA MCP client expects a specific set of environment variables to operate. These variables control the RPC endpoint, access mode, and optional private key usage for transactions.

Troubleshooting

If you are on a Linux environment using NVM, paths may need to be absolute. Install the MCP server with the global npm install and configure absolute paths in your client settings.

Check environment variables on startup. The server logs configuration details to help diagnose misconfigurations.

If you need to work with local files for development or testing, you can reference your workspace in the MCP setup to access project files directly within prompts.

Notes on future protocol support

Future protocol support includes additional lending protocols, staking integrations, cross-chain messaging, and yield optimization features to broaden the AI’s interaction scope with the KAIA ecosystem.

Available tools

get_wallet_info

Retrieve wallet information and token balances

send_native_token

Send native KAIA tokens to a recipient

send_erc20_token

Send ERC-20 tokens to a recipient

wrap_kaia

Wrap KAIA into WKAIA for tokenized use

unwrap_kaia

Unwrap WKAIA back into KAIA

check_allowance

Check token allowances for operations

approve_token

Approve tokens for protocol operations

get_account_liquidity

Check account liquidity and health factor in KiloLend

get_markets

Get all lending markets with current rates

get_protocol_stats

Get protocol statistics and total value locked (TVL)

enter_market

Enter lending markets to enable collateral use

supply_to_market

Supply assets to a lending market

borrow_from_market

Borrow assets from a lending market

repay_borrow

Repay borrowed amounts to a market

redeem_tokens

Redeem cTokens for underlying tokens

redeem_underlying

Redeem underlying tokens from cTokens

get_all_prices

Get all available prices from the price API

get_token_prices

Get prices for specific tokens

get_kaia_ecosystem_prices

Get KAIA ecosystem token prices only

get_major_crypto_prices

Get major cryptocurrency prices (BTC, ETH)

get_quick_prices

Quick price overview of KAIA, BTC, and ETH

dragonswap_get_pool_info

Get DragonSwap pool information

dragonswap_get_swap_quote

Get swap quotes without executing

dragonswap_get_route

Get best routing path for swaps

dragonswap_execute_swap

Execute token swaps on DragonSwap