Ymax Agent Kit

AI agent toolkit for cross-chain USDC yield management on Morpho vaults.

Quick Start (2 minutes)

npx @henriots89/ymax-agent-kit init --portfolio portfolio145
npx @henriots89/ymax-agent-kit doctor

Open Claude Code and try:

First prompts to try

• "Check portfolio145 — should I rebalance?"
• "Do a dry-run rebalance and show what would be submitted"
• "Which vaults are blocked and why?"
• "Submit the rebalance excluding high-risk vaults"

What the agent can do

| Tool | Description | |------|-------------| | get_portfolio | Fetch portfolio state: positions, balances, target allocations, total value | | get_instruments | List available instruments with APYs, fees, and TVL across chains | | compute_allocation | Run the strategy engine with yield + diversity scoring and constraints | | check_rebalance | Check if rebalance is warranted, with reasons and bps deltas | | sign_and_submit_rebalance | Preview (dryRun=true) or execute a rebalance. Risk-gated. | | query_risk_scores | Per-vault risk scores: composite, tier, and component breakdown | | query_market_risk | Single-instrument risk detail by YDS instrument ID |

Risk API

curl -H "x-api-key: YOUR_KEY" https://sommelier-risk-api.fly.dev/v1/risk/scores

Frontend Dashboard

cd apps/byoa && VITE_PORTFOLIO_ID=portfolio145 npm run dev

Troubleshooting

• Stale output after rebuild? Restart Claude Code to reload the MCP server.
• Config not found? Run init or check ~/.claude/mcp.json and .mcp.json.
• Risk API timeout? Check https://sommelier-risk-api.fly.dev health.