KawaFi - Hedera DeFi

Provides unified access to Hedera DeFi platforms via MCP, exposing data, analytics, and transaction tools across SaucerSwap, Bonzo Finance, Stader, HeliSwap, and Hashport.
  • typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "gabrielantonyxaviour-kawa-fi": {
      "command": "npx",
      "args": [
        "kawa-fi-mcp"
      ],
      "env": {
        "EXECUTE_TX": "false",
        "HEDERA_NETWORK": "mainnet",
        "SAUCERSWAP_API_KEY": "your_api_key_here",
        "MAINNET_HEDERA_OPERATOR_ID": "0.0.your_account",
        "TESTNET_HEDERA_OPERATOR_ID": "0.0.your_testnet_account",
        "MAINNET_HEDERA_OPERATOR_KEY": "your_private_key",
        "TESTNET_HEDERA_OPERATOR_KEY": "your_testnet_private_key"
      }
    }
  }
}

You can access Hedera DeFi through a unified MCP server that exposes 36 standardized tools for data, analytics, transaction preparation, and cross-chain operations. This server lets your AI assistants and applications interact safely with multiple Hedera DeFi platforms, while giving you flexible security modes and streamlined setup.

How to use

Connect your MCP-compatible client to the Hedera DeFi MCP Server using the provided runtime configuration. You can run the server locally and drive it from your client to retrieve real‑time data, prepare unsigned transactions, or execute transactions in specialized environments. Use Prepare Mode to generate unsigned transactions that you sign externally, or Execute Mode to sign and submit transactions directly when you operate in a trusted environment. This setup gives you data access, cross‑platform operations, and yield optimization opportunities across SaucerSwap, Bonzo Finance, Stader, HeliSwap, and Hashport.

How to install

Prerequisites: Node.js 18+ and an MCP-compatible client such as Claude Desktop.

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

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

Security & operation modes

Two security modes let you balance safety and convenience. Prepare Mode is the default and generates unsigned transactions for external signing. Execute Mode can optionally sign and execute transactions directly. Private keys are only loaded when you deliberately enable Execute Mode.

Prepare Mode (recommended): EXECUTE_TX=false or omit entirely. Private keys never load, enabling flexible signing in secure environments.

Execute Mode (advanced): EXECUTE_TX=true. Private keys are loaded in memory for automatic signing and submission, suitable for automated workflows in trusted environments.

Available tools

saucerswap_get_tokens

Retrieve all available SaucerSwap tokens with prices and metadata

saucerswap_get_stats

Platform statistics such as TVL, volume, and SAUCE circulation

saucerswap_get_sss_stats

Single-Sided Staking statistics and xSAUCE ratio

saucerswap_get_hbar_prices

Historical HBAR price data with minutely resolution

saucerswap_get_platform_data

Historical liquidity/volume data with time intervals

saucerswap_get_farms

Active yield farming opportunities on SaucerSwap

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 like fees and liquidity

saucerswap_quote_exact_input

Quote for exact input amount in swap operations

saucerswap_quote_exact_output

Quote for exact output amount in swap operations

saucerswap_swap_hbar_for_tokens

Prepare HBAR → tokens swap with refunds

saucerswap_swap_tokens_for_hbar

Prepare tokens → HBAR swap with unwrapping

saucerswap_swap_tokens_for_tokens

Prepare token → token swaps

saucerswap_stake_sauce

Prepare SAUCE staking for xSAUCE

saucerswap_unstake_xsauce

Prepare xSAUCE unstaking for SAUCE

saucerswap_deposit_to_farm

Prepare LP token farm deposits

saucerswap_withdraw_from_farm

Prepare LP token farm withdrawals

bonzo_get_reserves

All lending/borrowing reserves in Bonzo Finance

bonzo_get_account

Account positions and balances in Bonzo Finance

bonzo_get_liquidations

Accounts eligible for liquidation in Bonzo Finance

stader_get_exchange_rate

Current HBAR to HBARX exchange rate

stader_stake_hbar

Stake HBAR for HBARX (transaction)

stader_unstake_hbarx

Unstake HBARX for HBAR (transaction)

heliswap_get_pair_info

Trading pair information from HeliSwap

hashport_get_supported_assets

Bridge-supported assets on Hashport

hashport_get_supported_networks

All networks supported by Hashport

hashport_get_bridge_steps

Step-by-step bridging instructions for Hashport

hashport_validate_bridge

Validate bridge parameters for a transfer

hashport_get_assets_amounts

Asset reserve amounts on Hashport pools

hashport_get_transfers

Paginated transfer history on Hashport bridges

hashport_get_network_assets

Assets on a specific network for Hashport

hashport_get_network_asset_amounts

Asset amounts per network on Hashport

hashport_get_network_asset_details

Detailed asset information on a network for Hashport

hashport_convert_hedera_tx_id

Convert Hedera transaction IDs to Hashport format

Built by
VeilStrat
AI signals for GTM teams
© 2026 VeilStrat. All rights reserved.All systems operational