Skip to content

Commit bcef4bc

Browse files
committed
docs: update README with Merkl skill and consolidated MCP tools
1 parent c54da36 commit bcef4bc

1 file changed

Lines changed: 34 additions & 15 deletions

File tree

README.md

Lines changed: 34 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ A collection of protocol-specific skills that teach AI agents (Claude, etc.) how
1717
|----------|--------|-------|
1818
| **Aave V3** | Available | `skills/aave-agentic-wallet/SKILL.md` |
1919
| **SparkLend** | Available | `skills/spark-agentic-wallet/SKILL.md` |
20+
| **Merkl** | Available | `skills/merkl-agentic-wallet/SKILL.md` |
2021
| **Lido** | Coming soon ||
2122
| **Morpho** | Coming soon ||
2223

@@ -44,6 +45,21 @@ node dist/skills/spark-agentic-wallet/spark.js opportunities --network ethereum
4445
node dist/skills/spark-agentic-wallet/spark.js position --wallet 0x... --network ethereum
4546
```
4647

48+
### Merkl
49+
50+
Browse incentivized DeFi opportunities, check unclaimed rewards, and claim Merkl rewards across 50+ chains. Merkl is a reward distribution layer — it incentivizes positions on other protocols like Aave, SparkLend, Morpho, and more.
51+
52+
```bash
53+
# Browse top opportunities by APR
54+
node dist/skills/merkl-agentic-wallet/merkl.js opportunities --chain-id 1
55+
56+
# Check unclaimed rewards
57+
node dist/skills/merkl-agentic-wallet/merkl.js check-rewards --wallet 0x...
58+
59+
# Encode a claim transaction
60+
node dist/skills/merkl-agentic-wallet/merkl.js claim-rewards --wallet 0x... --chain-id 1
61+
```
62+
4763
## MCP Server
4864

4965
This project is also available as a standalone MCP server, exposing all DeFi skills as MCP tools consumable by any MCP-compatible agent (Claude, Cursor, Windsurf, custom agents).
@@ -76,37 +92,36 @@ npx @bootnodedev/defi-mcp-server
7692
npx @bootnodedev/defi-mcp-server --http --port 3000
7793
```
7894

79-
### Available tools (14)
95+
### Available tools (10)
8096

8197
| Tool | Description |
8298
|------|-------------|
83-
| `aave_get_opportunities` | Get Aave V3 supply/borrow APY rates across networks |
84-
| `aave_check_position` | Check wallet health factor, collateral, and debt |
85-
| `aave_get_permissions` | Get permission params for Aave V3 operations |
86-
| `aave_encode_supply` | Encode approve + supply calldata |
87-
| `aave_encode_borrow` | Encode borrow calldata |
88-
| `aave_encode_repay` | Encode approve + repay calldata |
89-
| `aave_encode_withdraw` | Encode withdraw calldata |
90-
| `spark_get_opportunities` | Get SparkLend supply/borrow APY rates |
91-
| `spark_check_position` | Check wallet health factor, collateral, and debt |
92-
| `spark_get_permissions` | Get permission params for SparkLend operations |
93-
| `spark_encode_supply` | Encode approve + supply calldata |
94-
| `spark_encode_borrow` | Encode borrow calldata |
95-
| `spark_encode_repay` | Encode approve + repay calldata |
96-
| `spark_encode_withdraw` | Encode withdraw calldata |
99+
| `defi_guide` | Overview of all tools, workflows, and key rules — call before your first DeFi operation |
100+
| `aave_get_opportunities` | Aave V3 supply/borrow APY rates, top reserves ranked by supply APY |
101+
| `aave_check_position` | Wallet health factor, collateral, and debt on Aave V3 |
102+
| `aave_get_permissions` | Permission params for Aave V3 — pass result to agentic-wallet grant_permissions |
103+
| `aave_encode` | Encode Aave V3 calldata (supply, borrow, repay, withdraw) |
104+
| `spark_get_opportunities` | SparkLend supply/borrow APY rates |
105+
| `spark_check_position` | Wallet health factor, collateral, and debt on SparkLend |
106+
| `spark_get_permissions` | Permission params for SparkLend |
107+
| `spark_encode` | Encode SparkLend calldata (supply, borrow, repay, withdraw) |
108+
| `merkl` | Merkl reward management — browse opportunities, check rewards, claim rewards |
97109

98110
The `*_get_opportunities` tools return the top 10 reserves per network by default, with slim fields to minimize token usage. Optional parameters:
99111

100112
- `token` — filter by token symbol (e.g. `USDC`) or contract address (case-insensitive)
101113
- `limit` — max reserves per network (default: 10)
102114
- `detailed` — include all fields like `availableLiquidity`, `liquidationThreshold`, `canBeCollateral` (default: false)
103115

116+
The `merkl` tool uses subcommands: `get_opportunities`, `check_rewards`, `claim_rewards`.
117+
104118
## Claude Code Plugin
105119

106120
This project is packaged as a [Claude Code plugin](https://code.claude.com/docs/en/plugins). Install it to get:
107121

108122
- **`/agentic-defi:aave` slash command** — Run Aave operations directly (supply, borrow, repay, withdraw, position, opportunities, permissions)
109123
- **`/agentic-defi:spark` slash command** — Run SparkLend operations directly (supply, borrow, repay, withdraw, position, opportunities, permissions)
124+
- **`/agentic-defi:merkl` slash command** — Browse Merkl opportunities, check and claim rewards
110125
- **SessionStart hook** — Automatically checks that the agentic-wallet MCP server is configured when a session starts
111126

112127
### Install as plugin
@@ -131,6 +146,10 @@ claude --plugin-dir /path/to/agentic-defi
131146

132147
/agentic-defi:spark supply --network ethereum --asset DAI --amount 1000 --wallet 0x...
133148
/agentic-defi:spark opportunities --network ethereum
149+
150+
/agentic-defi:merkl opportunities --chain-id 1
151+
/agentic-defi:merkl check-rewards --wallet 0x...
152+
/agentic-defi:merkl claim-rewards --wallet 0x... --chain-id 1
134153
```
135154

136155
## Setup

0 commit comments

Comments
 (0)