feat: add LP executor support

- Add lp_executor to list_types output
- Add lp_executor.md guide for LP position management
- Show wallet_address in CLMM and swap responses

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: fengtality

hummingbot_mcp/guides/lp_executor.md

@@ -0,0 +1,49 @@
+### LP Executor
+Manages liquidity provider positions on CLMM DEXs (Meteora, Raydium).
+Opens positions within price bounds, monitors range status, tracks fees.
+
+**Use when:**
+- Providing liquidity on Solana DEXs
+- Want automated position monitoring and fee tracking
+- Earning trading fees from LP positions
+
+**Avoid when:**
+- Trading on CEX (use other executors)
+- Want directional exposure only
+- Not familiar with impermanent loss risks
+
+#### State Machine
+
+```
+NOT_ACTIVE → OPENING → IN_RANGE ↔ OUT_OF_RANGE → CLOSING → COMPLETE
+```
+
+- **NOT_ACTIVE**: Initial state, no position yet
+- **OPENING**: Transaction submitted to open position
+- **IN_RANGE**: Position active, current price within bounds
+- **OUT_OF_RANGE**: Position active but price outside bounds (no fees earned)
+- **CLOSING**: Transaction submitted to close position
+- **COMPLETE**: Position closed, executor finished
+
+#### Key Parameters
+
+**Required:**
+- `connector_name`: CLMM connector (e.g., `meteora`, `raydiumclmm`)
+- `trading_pair`: Token pair (e.g., `SOL-USDC`)
+- `pool_address`: Pool contract address
+- `lower_price` / `upper_price`: Price range bounds
+
+**Liquidity:**
+- `base_amount`: Amount of base token to provide
+- `quote_amount`: Amount of quote token to provide
+- `side`: Position side (0=BOTH, 1=BUY/quote-only, 2=SELL/base-only)
+
+**Position Management:**
+- `keep_position=false` (default): Close LP position when executor stops
+- `keep_position=true`: Leave position open on-chain, stop monitoring only
+
+#### Meteora Strategy Types (extra_params.strategyType)
+
+- `0`: **Spot** — Uniform liquidity across range
+- `1`: **Curve** — Concentrated around current price
+- `2`: **Bid-Ask** — Liquidity at range edges

hummingbot_mcp/tools/executors.py

@@ -76,7 +76,8 @@ async def manage_executors(client: Any, request: ManageExecutorsRequest) -> dict
             "- **position_executor** — Directional trading with entry, stop-loss, and take-profit\n"
             "- **dca_executor** — Dollar-cost averaging for gradual position building\n"
             "- **grid_executor** — Grid trading across multiple price levels in ranging markets\n"
-            "- **order_executor** — Simple BUY/SELL order with execution strategy\n\n"
+            "- **order_executor** — Simple BUY/SELL order with execution strategy\n"
+            "- **lp_executor** — Liquidity provision on CLMM DEXs (Meteora, Raydium)\n\n"
             "Provide `executor_type` to see the configuration schema."
         )
 

hummingbot_mcp/tools/gateway_clmm.py

@@ -250,6 +250,7 @@ async def manage_gateway_clmm_positions(client: Any, request: GatewayCLMMRequest
                 "connector": request.connector,
                 "network": request.network,
                 "pool_address": request.pool_address,
+                "wallet_address": request.wallet_address or "(default)",
                 "price_range": {
                     "lower_price": request.lower_price,
                     "upper_price": request.upper_price
@@ -281,6 +282,7 @@ async def manage_gateway_clmm_positions(client: Any, request: GatewayCLMMRequest
                 "connector": request.connector,
                 "network": request.network,
                 "position_address": request.position_address,
+                "wallet_address": request.wallet_address or "(default)",
                 "result": result
             }
 
@@ -308,6 +310,7 @@ async def manage_gateway_clmm_positions(client: Any, request: GatewayCLMMRequest
                 "connector": request.connector,
                 "network": request.network,
                 "position_address": request.position_address,
+                "wallet_address": request.wallet_address or "(default)",
                 "result": result
             }
 
@@ -335,6 +338,7 @@ async def manage_gateway_clmm_positions(client: Any, request: GatewayCLMMRequest
                 "connector": request.connector,
                 "network": request.network,
                 "pool_address": request.pool_address,
+                "wallet_address": request.wallet_address or "(default)",
                 "result": result
             }
 

hummingbot_mcp/tools/gateway_swap.py

@@ -101,6 +101,7 @@ async def manage_gateway_swaps(client: Any, request: GatewaySwapRequest) -> dict
             "trading_pair": request.trading_pair,
             "side": request.side,
             "amount": request.amount,
+            "wallet_address": request.wallet_address or "(default)",
             "result": result
         }