feat: add token filter to get_opportunities MCP tools

Allow filtering reserves by token symbol or address in
aave_get_opportunities and spark_get_opportunities.

Author: lmcorbalan

README.md

@@ -97,6 +97,7 @@ npx @bootnodedev/defi-mcp-server --http --port 3000
 
 The `*_get_opportunities` tools return the top 10 reserves per network by default, with slim fields to minimize token usage. Optional parameters:
 
+- `token` — filter by token symbol (e.g. `USDC`) or contract address (case-insensitive)
 - `limit` — max reserves per network (default: 10)
 - `detailed` — include all fields like `availableLiquidity`, `liquidationThreshold`, `canBeCollateral` (default: false)
 

commands/aave.md

@@ -15,7 +15,7 @@ Parse the following arguments: $ARGUMENTS
 | `repay` | `--network --asset --amount --wallet` (amount can be "max") |
 | `withdraw` | `--network --asset --amount --wallet` (amount can be "max") |
 | `position` | `--network --wallet` |
-| `opportunities` | `--network` (can be "all") |
+| `opportunities` | `--network` (can be "all"), optional `--token` to filter by symbol or address |
 | `grant-permissions` | `--network --wallet --token --limit` |
 
 ## Instructions

commands/spark.md

@@ -15,7 +15,7 @@ Parse the following arguments: $ARGUMENTS
 | `repay` | `--network --asset --amount --wallet` (amount can be "max") |
 | `withdraw` | `--network --asset --amount --wallet` (amount can be "max") |
 | `position` | `--network --wallet` |
-| `opportunities` | `--network` (can be "all") |
+| `opportunities` | `--network` (can be "all"), optional `--token` to filter by symbol or address |
 | `grant-permissions` | `--network --wallet --token --limit` |
 
 ## Instructions

mcp-server/tools/aave.ts

@@ -23,18 +23,21 @@ export function registerAaveTools(server: McpServer) {
       description: "Aave V3 supply/borrow APY rates. Top reserves ranked by supply APY. Use detailed=true for all fields.",
       inputSchema: z.object({
         network: networkAll,
+        token: z.string().optional().describe("Filter by token symbol (e.g. 'USDC') or address (0x...). Case-insensitive."),
         limit: z.number().optional().describe("Max reserves per network (default: 10)"),
         detailed: z.boolean().optional().describe("Include all reserve fields"),
       }),
     },
-    async ({ network: net, limit, detailed }) => {
+    async ({ network: net, token, limit, detailed }) => {
       const results = await getOpportunities(net as NetworkName | "all");
       const maxReserves = limit ?? DEFAULT_LIMIT;
+      const tokenFilter = token?.toLowerCase();
 
       const slimmed = results.map(({ network: n, reserves }) => ({
         network: n,
         reserves: reserves
           .filter((r) => r.supplyAPY >= MIN_APY || r.borrowAPY >= MIN_APY)
+          .filter((r) => !tokenFilter || r.symbol.toLowerCase() === tokenFilter || r.asset.toLowerCase() === tokenFilter)
           .slice(0, maxReserves)
           .map((r) =>
             detailed

mcp-server/tools/spark.ts

@@ -23,18 +23,21 @@ export function registerSparkTools(server: McpServer) {
       description: "SparkLend supply/borrow APY rates. Top reserves ranked by supply APY. Use detailed=true for all fields.",
       inputSchema: z.object({
         network: networkAll,
+        token: z.string().optional().describe("Filter by token symbol (e.g. 'DAI') or address (0x...). Case-insensitive."),
         limit: z.number().optional().describe("Max reserves per network (default: 10)"),
         detailed: z.boolean().optional().describe("Include all reserve fields"),
       }),
     },
-    async ({ network: net, limit, detailed }) => {
+    async ({ network: net, token, limit, detailed }) => {
       const results = await getOpportunities(net as NetworkName | "all");
       const maxReserves = limit ?? DEFAULT_LIMIT;
+      const tokenFilter = token?.toLowerCase();
 
       const slimmed = results.map(({ network: n, reserves }) => ({
         network: n,
         reserves: reserves
           .filter((r) => r.supplyAPY >= MIN_APY || r.borrowAPY >= MIN_APY)
+          .filter((r) => !tokenFilter || r.symbol.toLowerCase() === tokenFilter || r.asset.toLowerCase() === tokenFilter)
           .slice(0, maxReserves)
           .map((r) =>
             detailed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bootnodedev/defi-mcp-server",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "description": "DeFi for Agents",
   "license": "ISC",
   "author": "BootNode",