Skip to content

feat: add LP executor guide#14

Open
fengtality wants to merge 11 commits intomainfrom
feat/lp-executor-prompt
Open

feat: add LP executor guide#14
fengtality wants to merge 11 commits intomainfrom
feat/lp-executor-prompt

Conversation

@fengtality
Copy link

@fengtality fengtality commented Feb 4, 2026 •
edited
Loading

Summary

Add LP executor support to MCP — guide, tool updates, and compatibility fixes for hummingbot-api PR #120.

Changes

  • LP executor guide (hummingbot_mcp/guides/lp_executor.md) — full reference for LP position lifecycle, parameters, single/double-sided positions, limit range orders, and Meteora strategy types
  • Executor tool — add lp_executor to type listing, handle executor_id response key
  • Executor preferences — add lp_executor defaults template
  • Executor formatter — show custom_info in executor detail output
  • Gateway CLMM tool — include wallet_address in response metadata for add/remove/close/collect
  • Gateway swap tool — include wallet_address in response metadata
  • Gateway config tool — document network GET/UPDATE behavior and add examples
  • Gitignore — add .mcp.json and .vscode/

LP Executor Guide Covers

  • State machine: NOT_ACTIVE → OPENING → IN_RANGE ↔ OUT_OF_RANGE → CLOSING → COMPLETE
  • Required params: connector_name (with /clmm suffix), trading_pair, pool_address, lower_price, upper_price
  • Single-sided (BUY/SELL) vs double-sided (BOTH) positions
  • Limit range orders via auto_close_above/below_range_seconds
  • Meteora strategy types (Spot, Curve, Bid-Ask)
  • Position management best practices (executor vs gateway tool)
  • Error recovery (stuck states, 404 after API restart)

Verified Against

  • LPExecutorConfig in hummingbot core (development branch)
  • ExecutorService + EXECUTOR_REGISTRY in hummingbot-api (feat/lp-executor branch)
  • Gateway routes at /connectors/raydium/clmm and /connectors/meteora/clmm

Related PRs

🤖 Generated with Claude Code

@fengtality fengtality force-pushed the feat/lp-executor-prompt branch from cfa9ff4 to 2f2b5af Compare February 4, 2026 18:47
@fengtality fengtality changed the title feat: add LP executor prompt for CLMM liquidity provision feat: add LP executor guide Feb 4, 2026
@fengtality fengtality force-pushed the feat/lp-executor-prompt branch 2 times, most recently from bbe73f2 to 4d2e25b Compare February 4, 2026 20:07
@fengtality @claude
feat: add LP executor support
9a4d958 
- 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>
@fengtality fengtality force-pushed the feat/lp-executor-prompt branch from 4d2e25b to 9a4d958 Compare February 4, 2026 20:07
fengtality and others added 8 commits February 4, 2026 14:35
@fengtality @claude
chore: add .mcp.json and .vscode to gitignore
3a0cc85 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
docs: document defaultWallet access via network config
4ba4d17 
manage_gateway_config now documents that:
- GET networks returns merged chain + network config including defaultWallet
- UPDATE networks can modify chain-level fields like defaultWallet

This works with the Gateway changes that merge chain config into network config.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
fix: correctly extract executor_id from create response
f282d05 
The API returns 'executor_id' but MCP tool was looking for 'id'.
Now checks both fields for compatibility.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
feat: improve LP executor documentation and display custom_info
a82def6 
- Add custom_info display to executor detail view
- Document correct connector_name format (meteora/clmm)
- Add warning about using manage_executors vs manage_gateway_clmm

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
docs: add single-sided vs double-sided position guidance
5272ccf 
- Base-only = SELL position above price
- Quote-only = BUY position below price
- Both = ask user about centered vs custom range

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
docs: add guidance for verifying position status
c09e991 
- Use get_positions to check on-chain state
- Compare with executor custom_info.position_address
- Manually update DB if out of sync

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
docs: add note about stuck OPENING state
c8c4ad4 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
docs: add exception handling for executor not found (404)
c5b8b09 
When API restarts, executors may not exist in memory but positions
remain on-chain. Use gateway CLMM to close and update DB manually.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Base automatically changed from feat/add_executors to main February 6, 2026 22:38
fengtality and others added 2 commits February 24, 2026 13:15
@fengtality @claude
docs: add auto-close parameters and limit range order guide for LP ex…
cc058d8 
…ecutor

- Add auto_close_above_range_seconds and auto_close_below_range_seconds
  to key parameters section
- Add position_offset_pct parameter documentation
- Add new "Limit Range Orders" section explaining how to use auto-close
  for SELL limit (take profit) and BUY limit (accumulate on dip) strategies
- Add LP executor defaults section to preferences template

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@fengtality @claude
fix: correct raydium connector name and add amount defaults in LP guide
d97f0aa 
- Fix raydiumclmm/clmm → raydium/clmm (matches gateway routes)
- Add default: 0 to base_amount/quote_amount docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@fengtality