Available Tools

SharkBlock MCP exposes 44 tools organized by domain. Each tool has typed parameters and a clear description optimized for AI agents.

Strategy Tools

Manage automated strategies. Scope: trade:execute

Tool	Description	Annotations
`create_strategy`	Create a new strategy on a wallet — entry conditions, TP/SL targets and presets	—
`list_strategies`	List all strategies for the authenticated user	Read-only
`get_strategy`	Get strategy details: configuration, targets, presets	Read-only
`update_strategy`	Update strategy configuration	Idempotent
`start_strategy`	Start or resume a paused strategy (requires delegation)	—
`pause_strategy`	Pause an active strategy (open positions remain)	—
`get_strategy_stats`	Performance: PnL, win rate, average gain/loss, trade count	Read-only
`list_strategy_filters`	Catalog of all available filter fields for entry strategies	Read-only

Manage open and closed positions. Scope: trade:execute

Tool	Description	Annotations
`list_positions`	List open or closed positions for a strategy (paginated)	Read-only
`get_position`	Full position details: targets, transactions, PnL	Read-only
`get_swap_quote`	Get a swap quote (e.g. before closing a position)	Read-only
`close_position`	Close a position by executing a sell swap	Destructive
`abandon_position`	Mark a position closed without selling (tokens stay in wallet)	Destructive
`add_position_target`	Add a take-profit or stop-loss target to an open position	—
`update_position_target`	Update a pending/failed target	Idempotent
`delete_position_target`	Delete a pending/failed target	Destructive

Manage Solana wallets. Scope: trade:execute (some operations require wallet:delegate)

Tool	Description	Annotations
`create_wallet`	Create a new wallet — shadow (paper) or delegated (live)	—
`list_wallets`	List wallets, optionally filtered by network/shadow mode	Read-only
`get_wallet`	Wallet details including balance and delegation status	Read-only
`update_wallet`	Update wallet settings (name, configuration)	Idempotent
`delete_wallet`	Permanently delete a wallet (close positions first)	Destructive
`get_wallet_balances`	Current token balances of a wallet	Read-only
`get_wallet_pnl`	Realized and unrealized PnL, win rate	Read-only
`get_wallet_transactions`	Labelled transaction history (buys, sells, fees)	Read-only
`fund_shadow_wallet`	Add simulated SOL to a shadow wallet	—
`reset_shadow_wallet`	Wipe a shadow wallet’s positions and history	Destructive

Blockchain data and analytics. Scope: blockchain-data:read

These are composite tools — each combines multiple data sources into a single response.

Tool	Description	Data Combined
`get_token_info`	Comprehensive token research — price, details, security, markets	Price + Details + Security + Markets
`get_token_chart`	OHLCV candle data for technical analysis	Token OHLCV history
`get_token_trades`	Recent trade activity, sizes, trader addresses	Token trades
`get_token_holders`	Holder distribution, trader positions, first buyers	Holders + Traders + First Buyers
`get_market_info`	Trading-pair details with liquidity and sparkline	Market Details + Sparkline
`get_market_chart`	OHLCV data for a specific market/pool	Market OHLCV history

Find trading opportunities. Scope: blockchain-data:read

Tool	Description
`search_tokens`	Fast search by token name, symbol, or address
`discover_trending`	Trending tokens with price, volume and momentum data
`get_asset_metadata`	Asset metadata: description, website, social links, categories
`analyze_wallet`	Full wallet analysis — portfolio, positions, trades, metrics

Profile, notifications, settings, affiliations. Scope: profile:read (most)

Tool	Description	Annotations
`get_profile`	User profile (username, tier, settings)	Read-only
`list_notifications`	List notifications with cursor pagination	Read-only
`mark_notifications_seen`	Mark one or all notifications as seen	Idempotent
`get_notification_preferences`	Get enabled/disabled notification types	Read-only
`update_notification_preferences`	Update which notification types are disabled	Idempotent
`get_affiliation_earnings`	Referral earnings summary by level	Read-only
`redeem_code`	Redeem an activation or promotional code	—
`list_networks`	List supported blockchain networks (currently: Solana only)	Read-only

Tools include annotations to help AI agents make safe decisions:

Annotation	Meaning
Read-only	No side effects — safe to call anytime
Idempotent	Can be called multiple times with the same result
Destructive	Irreversible action — agents should confirm with the user first

In addition to tools, SharkBlock exposes resources that agents can read by URI:

Resource URI	Description
`sharkblock://positions/{network}/{strategyAddress}`	Live open positions for a strategy
`sharkblock://wallet/{network}/{address}/balances`	Current wallet token balances
`sharkblock://notifications`	Recent user notifications

Resources are snapshots — useful when an agent needs current state rather than calling a tool.