Kaskad

Available Tools

The Kaskad MCP server exposes 16 tools — 9 read-only queries and 7 write operations.


getGovernanceParams

Read live DAO-voted governance parameters from on-chain.

Returns all active parameters including the supplier/borrower emission split, eligibility thresholds, and treasury ratios. Values are read from the last finalized epoch.

Always call this before building a yield strategy — the emission split directly affects optimal positioning.

Example output:

  • EMISSION_SUPPLIERS_SHARE_BPS: 4581 bps (45.8% to suppliers, 54.2% to borrowers)
  • BORROWER_MIN_LTV_BPS: 1607 bps (16.1%)
  • TVL_MIN_SUPPLY_UPTIME_BPS: 8851 bps (88.5%)

getMarkets

Live APY, utilization, and liquidity for all active Kaskad markets.

Returns supply APY, borrow APY, total supplied, total borrowed, and utilization rate per asset.


getPosition

A wallet's current lending position.

Returns collateral value (USD), debt value (USD), available borrows (USD), health factor, and per-asset supplied/borrowed balances.

Parameters:

ParameterDescription
addressWallet address (0x…)

getProtocolInfo

Static protocol metadata and full integration guide.

Returns contract addresses, network config, tokenomics summary, emission mechanics, and eligibility rules. Useful for onboarding an agent to the full protocol context before executing strategy.


getHistory

Historical data from the Kaskad subgraph: recent liquidations, current market APY snapshots, and optionally a user's transaction history (supplies, borrows, repays) and active positions over time.

Parameters:

ParameterDescription
address(optional) Wallet address to fetch user-specific history
limit(optional) Number of records to return (default 10, max 50)

getEmissions

KSKD emission state: current epoch, emission vault balance (remaining vs total), epoch timing, supplier/borrower split, and TWAL TVL from the activity tracker.

Use this to understand current emission APY context and vault depletion trajectory.


getUserRewards

Claimable KSKD rewards for a wallet address.

Shows accrued and claimable amounts from emission incentives. Eligibility requires meeting uptime and minimum position thresholds.

Parameters:

ParameterDescription
addressWallet address (0x…)

getStakingInfo

stKSKD vault state for a wallet.

Returns stKSKD balance, KSKD wallet balance, and holding duration.

Parameters:

ParameterDescription
addressWallet address (0x…)

checkHealthFactor

Check a wallet's health factor against a threshold. Returns alert: true if HF is below threshold.

Designed for agent monitoring loops: call on a cron interval and trigger repay() or supply() when alert: true.

Alert levels: safe | warning (below threshold) | danger (HF < 1.2) | critical (HF < 1.05, liquidation imminent).

Parameters:

ParameterDescription
addressWallet address to monitor
threshold(optional) HF threshold to alert below. Default 1.5, range 1.010.0

supply

Supply an asset into the Kaskad lending pool.

Parameters:

ParameterDescription
assetToken symbol (USDC, WETH, WBTC, IGRA, WIKAS, KSKD, IKAS)
amountAmount to supply (in token units, not wei)

Example: Supply 1,000 USDC to earn supply APY + KSKD emissions.


borrow

Borrow an asset against your supplied collateral.

Parameters:

ParameterDescription
assetToken symbol
amountAmount to borrow
interestRateMode(optional) 1 = stable, 2 = variable (default)

Requires sufficient collateral. Health factor must remain above 1.0 after the borrow.


repay

Repay outstanding debt.

Parameters:

ParameterDescription
assetToken symbol
amountAmount to repay (or -1 to repay all)
interestRateMode(optional) 1 = stable, 2 = variable (default)

withdraw

Withdraw supplied assets.

Parameters:

ParameterDescription
assetToken symbol
amountAmount to withdraw (or -1 to withdraw all)

Cannot withdraw collateral that is backing active debt.


stakeKSKD

Stake KSKD tokens into the stKSKD vault (1:1).

Grants governance eligibility (isEligibleSupplier / isEligibleBorrower).

Parameters:

ParameterDescription
amountAmount of KSKD to stake (human units, e.g. 100 = 100 KSKD)

unstakeKSKD

Unstake stKSKD shares back to KSKD (1:1).

Warning: if stKSKD balance drops to 0, governance eligibility resets.

Parameters:

ParameterDescription
sharesNumber of stKSKD shares to redeem (human units)

claimRewards

Claim all accrued KSKD rewards for the MCP wallet from the RewardsController.

Checks claimable balance first — skips the transaction if there's nothing to claim. Rewards are earned by meeting epoch uptime and minimum position thresholds.

No parameters.