KawaFi MCP Server

KawaFi - Hedera DeFi MCP Server

KawaFi provides unified access to the Hedera DeFi ecosystem through the Model Context Protocol (MCP), enabling AI assistants to interact with multiple DeFi platforms safely and efficiently.

🚀 Overview

A comprehensive Model Context Protocol (MCP) server that provides unified access to major Hedera DeFi platforms including SaucerSwap, Bonzo Finance, Stader, HeliSwap, and Hashport. This server enables AI assistants and applications to interact with Hedera's DeFi ecosystem through 36 standardized tools covering data analytics, transaction preparation, and cross-platform operations.

✨ Features

🔐 **Dual-Mode Security System**

• Prepare Mode (Default): Generate unsigned transactions for external signing
• Execute Mode (Advanced): Optionally sign and execute transactions directly
• Security-First Design: Private keys only loaded when explicitly required

🌐 **Multi-Platform DeFi Integration**

• SaucerSwap: Leading AMM DEX (19 tools)
• Bonzo Finance: Lending and borrowing (3 tools)
• Stader: HBAR liquid staking (3 tools)
• HeliSwap: Trading pair data (1 tool)
• Hashport: Cross-chain bridging (10 tools)

🛠️ **Comprehensive Toolset**

• Data & Analytics: Real-time prices, pool reserves, APYs, lending rates
• Transaction Preparation: Complete unsigned transaction data with proper encoding
• Cross-chain Operations: Asset bridging across multiple networks
• Yield Optimization: Staking, farming, and lending opportunities

📊 Tool Overview

*Bonzo transaction tools planned for future release

🔧 Installation & Setup

Prerequisites

• Node.js 18+
• An MCP-compatible client (Claude Desktop, etc.)

1. Installation

# Install globally from npm
npm install -g kawa-fi-mcp

# Or run with npx (no installation needed)
npx kawa-fi-mcp --help

2. Environment Configuration

Create a .env file with your desired configuration (see .env.example for reference):

# Network Selection
HEDERA_NETWORK=mainnet  # or "testnet"

# Security Mode
EXECUTE_TX=false        # true for execution, false for prepare-only

# Platform API Keys
SAUCERSWAP_API_KEY=your_api_key_here  # Optional but recommended

# Hedera Credentials (choose based on network)
MAINNET_HEDERA_OPERATOR_ID=0.0.your_account
MAINNET_HEDERA_OPERATOR_KEY=your_private_key     # Only if EXECUTE_TX=true
TESTNET_HEDERA_OPERATOR_ID=0.0.your_testnet_account  
TESTNET_HEDERA_OPERATOR_KEY=your_testnet_private_key  # Only if EXECUTE_TX=true

3. MCP Client Configuration

Add to your MCP client:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "hedera-defi": {
      "command": "npx",
      "args": ["kawa-fi-mcp"]
    }
  }
}

4. Verification

# Test the server directly
npx kawa-fi-mcp

# Or if installed globally
kawa-fi-mcp

# Check available tools (should show 13-36 tools based on configuration)

📋 Available Tools

SaucerSwap (19 tools)

**Data & Analytics Tools (10)**

• saucerswap_get_tokens - All available tokens with prices and metadata
• saucerswap_get_stats - Platform statistics (TVL, volume, SAUCE circulation)
• saucerswap_get_sss_stats - Single-Sided Staking statistics and XSAUCE ratio
• saucerswap_get_hbar_prices - Historical HBAR price data (minutely resolution)
• saucerswap_get_platform_data - Historical liquidity/volume data with intervals
• saucerswap_get_farms - Active yield farming opportunities
• saucerswap_get_farms_by_account - LP token amounts in farms by account
• saucerswap_get_pools - All liquidity pools with reserves and token info
• saucerswap_get_default_tokens - Default tokens with price changes
• saucerswap_get_v2_pools - V2 pools with advanced metrics (fees, ticks, liquidity)

**Transaction Tools (9)** 🆕

• saucerswap_quote_exact_input - Get swap quote for exact input amount
• `saucerswap_quote_exact_outp