Tools Reference

Complete reference for all 20 MCP tools. Each tool returns plain text output that the AI agent can interpret and relay to you.

Trading

trench_quote

Get a swap quote with automatic DEX routing. On Solana, routes between PumpFun and Jupiter. On BSC/Base, uses OpenOcean.

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint/contract address
`amountSol`	number	No	Native token amount to spend (SOL/BNB/ETH)
`amountTokens`	number	No	Raw token amount to sell
`slippageBps`	number	No	Slippage in basis points (default: 500)
`chain`	string	No	Chain: `"solana"`, `"bsc"`, `"base"` (default: `"solana"`)

Provide either amountSol (buy quote) or amountTokens (sell quote), not both.

Example output:

Quote: BUY via PumpFun

  Spend: 0.1000 SOL
  Receive: ~4,521,302.15 tokens
  Price Impact: 0.34%
  Slippage: 500 bps (5.0%)

Use trench_buy or trench_sell to execute this trade.

trench_buy

Buy a token with native currency (SOL/BNB/ETH). Enforces the TRENCH_MAX_BUY_SOL safety cap.

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint/contract address to buy
`amountSol`	number	Yes	Amount of native token to spend
`walletAddress`	string	No	Wallet to buy from (default: first vault wallet)
`slippageBps`	number	No	Slippage in basis points
`chain`	string	No	Chain: `"solana"`, `"bsc"`, `"base"` (default: `"solana"`)

Example output:

Buy successful via PumpFun

  Spent: 0.1000 SOL
  Received: ~4,412,876.50 tokens
  Wallet: 7xKp...3nRq
  Tx: 4sGj...kL2m
  Solscan: https://solscan.io/tx/4sGj...kL2m

trench_sell

Sell a token for native currency (SOL/BNB/ETH). Omit amountTokens to sell the entire balance.

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint/contract address to sell
`amountTokens`	number	No	Raw token amount (omit to sell all)
`walletAddress`	string	No	Wallet to sell from (default: first vault wallet)
`slippageBps`	number	No	Slippage in basis points
`chain`	string	No	Chain: `"solana"`, `"bsc"`, `"base"` (default: `"solana"`)

Example output:

Sell successful via Jupiter

  Sold: 4,412,876.50 tokens
  Received: ~0.0987 SOL
  Wallet: 7xKp...3nRq
  Tx: 2mNv...pQ8x
  Solscan: https://solscan.io/tx/2mNv...pQ8x

Wallet Management

trench_wallet_list

List all wallets in the encrypted vault with optional SOL balances.

Parameter	Type	Required	Description
`showBalances`	boolean	No	Fetch and show SOL balances (default: true)

Example output:

Vault: 5 wallet(s)

  #  Address                                        Balance
---  ---------------------------------------------  ------------
  0  7xKp...3nRq                                    1.2340 SOL
  1  9mBc...7kLp                                    0.5000 SOL
  2  3vNx...2wQr                                    0.0500 SOL
  3  8jHt...4mXs                                    0.0500 SOL
  4  5pRc...9nWv                                    0.0500 SOL

trench_wallet_generate

Generate new wallets and add them to the vault. Generates chain-appropriate keys (Ed25519 for Solana, secp256k1 for EVM).

Parameter	Type	Required	Description
`count`	number	Yes	Number of wallets to generate (1-100)
`chain`	string	No	Chain: `"solana"`, `"bsc"`, `"base"` (default: `"solana"`)

Example output:

Generated 3 new wallet(s):

  1. 4kNp8mRqX2vLsW7jT9cYbD3hFgA6xZnE5uKoJ1wMiSy
  2. 8wQr3nXv5pLcT7mKs2jHfG9bYdA4xZuE6kNoJ1iRySt
  3. 2vMs7kLpR9nXwQ4jT8cYbD3hFgA5xZuE6oKnJ1iSyWt

Vault now has 8 wallet(s) total.

trench_wallet_fund

Send SOL from one vault wallet to one or more destinations.

Parameter	Type	Required	Description
`fromAddress`	string	Yes	Source wallet address (must be in vault)
`toAddresses`	string[]	Yes	Destination wallet addresses
`amountSol`	number	Yes	SOL to send to each address

Example output:

Funded 3/3 wallet(s) with 0.0500 SOL each

  9mBc...7kLp: OK (4sGj8nKv2m...)
  3vNx...2wQr: OK (7xPq3mLs9n...)
  8jHt...4mXs: OK (2wRv5kNp8j...)

Total sent: 0.1500 SOL

trench_wallet_sweep

Sweep SOL from vault wallets to a single destination. Leaves a small rent reserve.

Parameter	Type	Required	Description
`toAddress`	string	Yes	Destination wallet address
`walletAddresses`	string[]	No	Specific wallets to sweep (default: all vault wallets)
`keepRentSol`	number	No	SOL to keep for rent (default: 0.002)

Example output:

Swept 3/3 wallet(s) to 7xKp...3nRq

  9mBc...7kLp: 0.0478 SOL (4sGj8nKv2m...)
  3vNx...2wQr: 0.0478 SOL (7xPq3mLs9n...)
  8jHt...4mXs: 0.0478 SOL (2wRv5kNp8j...)

Total swept: 0.1434 SOL
Rent reserve kept: 0.0020 SOL per wallet

Intelligence

trench_token_info

Get comprehensive token data from DexScreener: price, market cap, volume, price changes, and transaction counts.

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint address

Example output:

Token: CoolCat (COOL)
Mint: 7xKp8mRqX2vLsW7jT9cYbD3hFgA6xZnE5uKoJ1wMiSy
DEX routing: PumpFun (bonding curve)
Trading on: raydium

--- Price ---
  USD: $0.00004523
  SOL: 0.000000234 SOL

--- Market ---
  Market Cap: $45.23K
  FDV: $45.23K
  Liquidity: $12.50K

--- Volume ---
  5m: $1.23K
  1h: $8.45K
  6h: $34.20K
  24h: $89.50K

--- Price Change ---
  5m: +2.34%
  1h: -5.67%
  6h: +12.45%
  24h: +45.23%

--- Transactions (24h) ---
  Buys: 1,234
  Sells: 567

DexScreener: https://dexscreener.com/solana/7xKp8mRq...

trench_balances

Get SOL balance and all SPL token balances for a wallet.

Parameter	Type	Required	Description
`walletAddress`	string	No	Wallet to check (default: first vault wallet)

Example output:

Wallet: 7xKp...3nRq

SOL Balance: 1.2340 SOL

SPL Tokens:
  Token                                        Amount
  -------------------------------------------- -------------------
  EPjF...wkAq                                  4,521,302.15
  So11...1112                                  0.00

trench_positions

Show current token holdings across vault wallets with live prices from DexScreener.

Parameter	Type	Required	Description
`walletAddress`	string	No	Specific wallet (default: all vault wallets)
`tokenMint`	string	No	Filter to specific token

Example output:

Token Positions

  Token          Wallet       Amount              Value (SOL)     Value (USD)
  -------------- ------------ ------------------- --------------- ---------------
  COOL           7xKp...3nRq       4,521,302.15      1.0580 SOL          $23.45
  DOGE           9mBc...7kLp       1,200,000.00      0.2340 SOL           $5.19

  Total: 1.2920 SOL (~$28.64)
  Positions: 2 across 5 wallet(s)

trench_shield_scan

Analyze a token's safety: mint authority, freeze authority, liquidity depth, honeypot indicators, and transfer patterns. Returns a risk score from 0 (dangerous) to 100 (safe).

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint address to analyze

Example output:

Shield Scan: CoolCat (COOL)
Score: 72/100 (Medium Risk)

Checks:
  Mint Authority:     REVOKED (safe)
  Freeze Authority:   REVOKED (safe)
  Top 10 Holders:     42.3% (moderate concentration)
  Liquidity:          $12,500 (low)
  LP Burned:          Yes (good)
  Honeypot Risk:      Low

Flags:
  - Low liquidity: large trades may have high slippage
  - Top holder owns 15.2% of supply

Recommendation: Proceed with caution. Use small position sizes.

Automation

All automation tools use a start/status/stop pattern. Start a session, check on it anytime, and stop it when you're done. Sessions run inside the MCP server process — no extra infrastructure needed.

trench_volume_start

Start volume boosting on a token. Random buy/sell trades across your vault wallets to generate organic-looking volume.

Parameter	Type	Required	Description
`tokenMint`	string	Yes	Token mint address
`maxWallets`	number	No	Number of wallets to use (1-25, default: 3)
`minSwapSol`	number	No	Minimum SOL per swap (default: 0.005)
`maxSwapSol`	number	No	Maximum SOL per swap (default: 0.05)
`minIntervalMs`	number	No	Minimum delay between trades in ms (default: 30000)
`maxIntervalMs`	number	No	Maximum delay between trades in ms (default: 120000)

Example output:

Volume boosting started

  Token: 7xKp...3nRq
  Wallets: 3
  Swap range: 0.0050 - 0.0500 SOL
  Interval: 30s - 120s
  Session: volume-0

Use trench_volume_status to check progress.
Use trench_volume_stop to stop.

trench_volume_status

Get running volume session stats.

No parameters.

Example output:

Volume Session: volume-0

  Status: Running
  Token: 7xKp...3nRq
  Uptime: 12m 34s
  Trades: 18 executed (16 success, 2 failed)
  Success rate: 88.9%
  Volume: 0.4230 SOL
  Wallets: 3

trench_volume_stop

Stop the running volume session and return final stats.

No parameters.

Example output:

Volume boosting stopped

  Uptime: 45m 12s
  Total trades: 52 (48 success, 4 failed)
  Total volume: 1.2340 SOL

trench_bot_start

Create a bot group: generate fresh wallets, fund them from treasury, and start parallel trade loops.

Parameter	Type	Required	Description
`name`	string	Yes	Bot group name (unique)
`tokenMint`	string	Yes	Token mint address
`walletCount`	number	No	Number of bot wallets (1-25, default: 5)
`solPerWallet`	number	No	SOL to fund each wallet (default: 0.05)
`intensity`	string	No	Trading intensity: `low`, `medium`, `high` (default: `medium`)

Example output:

Bot group "alpha" started

  Token: 7xKp...3nRq
  Wallets: 5 generated and funded
  Intensity: medium (0.01-0.05 SOL, 30-120s intervals)
  SOL funded: 0.2500 SOL from treasury

Use trench_bot_status to check progress.
Use trench_bot_stop to stop, sell holdings, and sweep SOL back.

trench_bot_status

Get bot group status and per-wallet stats.

Parameter	Type	Required	Description
`name`	string	No	Bot group name (omit for all groups)

Example output:

Bot Group: alpha

  Status: Running
  Token: 7xKp...3nRq
  Wallets: 5
  Uptime: 1h 23m
  Trades: 87 (82 success, 5 failed)
  Volume: 2.3450 SOL

trench_bot_stop

Stop a bot group: sells all held tokens, sweeps SOL back to treasury, removes bot wallets from vault.

Parameter	Type	Required	Description
`name`	string	Yes	Bot group name to stop

Example output:

Bot group "alpha" stopped

  Uptime: 2h 15m
  Total trades: 134 (126 success, 8 failed)
  Total volume: 4.5670 SOL

  Cleanup:
    Sold tokens from 5/5 wallets
    Swept 0.2340 SOL back to treasury
    Removed 5 bot wallets from vault

trench_activity_start

Generate organic wallet activity (random swaps + transfers) to build transaction history.

Parameter	Type	Required	Description
`durationHours`	number	No	How long to run (0.5-48, default: 1)
`walletAddresses`	string[]	No	Specific wallets (default: all vault wallets)
`intensity`	string	No	Activity level: `low`, `medium`, `high` (default: `medium`)

Example output:

Activity generation started

  Wallets: 5
  Duration: 2.0 hours (ends at 14:30 UTC)
  Intensity: medium
  Session: activity-0

Generates random SOL transfers and swaps with popular tokens (USDC, BONK, JUP).
Auto-stops when duration expires and sells any held tokens.

trench_activity_status

Get activity session progress and time remaining.

No parameters.

Example output:

Activity Session: activity-0

  Status: Running
  Wallets: 5
  Uptime: 45m 12s
  Remaining: 1h 14m
  Transactions: 23 (21 success, 2 failed)
  Volume: 0.3450 SOL

trench_activity_stop

Stop activity generation early. Sells any tokens acquired during the session.

No parameters.

Example output:

Activity generation stopped

  Uptime: 45m 12s
  Total transactions: 23 (21 success, 2 failed)
  Total volume: 0.3450 SOL

  Cleanup: sold holdings in USDC, BONK back to SOL

Stealth

trench_stealth_fund

Fund wallets through ChangeNow to break on-chain clustering. Routes through the appropriate currency pair for each chain (USDC→SOL, USDC→BNB, USDC→ETH).

Parameter	Type	Required	Description
`walletAddresses`	string[]	Yes	Wallets to fund (1-25)
`amountSol`	number	Yes	Native token amount to send to each wallet
`chain`	string	No	Chain: `"solana"`, `"bsc"`, `"base"` (default: `"solana"`)

WARNING

This is a blocking operation. It takes 3-10 minutes per wallet as it waits for ChangeNow exchanges to complete.

Example output:

Stealth funding complete

  Results:
    4kNp...iSy: 0.0980 SOL received (ChangeNow ID: abc123)
    8wQr...ySt: 0.0975 SOL received (ChangeNow ID: def456)
    2vMs...yWt: 0.0982 SOL received (ChangeNow ID: ghi789)

  Total funded: 0.2937 SOL across 3 wallets
  Exchange fees: ~0.0063 SOL

Tools Reference ​

Trading ​

trench_quote ​

trench_buy ​

trench_sell ​

Wallet Management ​

trench_wallet_list ​

trench_wallet_generate ​

trench_wallet_fund ​

trench_wallet_sweep ​

Intelligence ​

trench_token_info ​

trench_balances ​

trench_positions ​

trench_shield_scan ​

Automation ​

trench_volume_start ​

trench_volume_status ​

trench_volume_stop ​

trench_bot_start ​

trench_bot_status ​

trench_bot_stop ​

trench_activity_start ​

trench_activity_status ​

trench_activity_stop ​

Stealth ​

trench_stealth_fund ​

Tools Reference

Trading

trench_quote

trench_buy

trench_sell

Wallet Management

trench_wallet_list

trench_wallet_generate

trench_wallet_fund

trench_wallet_sweep

Intelligence

trench_token_info

trench_balances

trench_positions

trench_shield_scan

Automation

trench_volume_start

trench_volume_status

trench_volume_stop

trench_bot_start

trench_bot_status

trench_bot_stop

trench_activity_start

trench_activity_status

trench_activity_stop

Stealth

trench_stealth_fund