Tools Catalog

ChainStream MCP Server complete tools reference

ChainStream MCP Server supports all interfaces defined in the API Reference. AI can directly call these tools to fetch on-chain data.

MCP tool parameters and return values are identical to the REST API. For detailed field descriptions, refer to API Reference.

---

Tools Overview

Data Query

Tool Category	Functions
Token	Token search, info, price, candles, holders, security check
Wallet	Balance, PnL, stats, balance updates
Trade	Trade records, activities, top traders
DexPool	Pool info, snapshots
Ranking	Hot tokens, new tokens, final stretch, migrated
Blockchain	Chain info, latest block

Trade Execution

Tool Category	Functions
Dex	Quote, route, swap execution
DeFi	Create token on Pumpfun/Moonshot
Transaction	Send transaction, gas estimation
RedPacket	Create/claim red packets

Infrastructure

Tool Category	Functions
Webhook	Endpoint management, event subscription
Blockchain	Supported chains, latest block

Real-time Subscriptions

Subscription Type	Functions
Candles	Real-time price trends
Token Stats	Real-time trading statistics
New Tokens	New token creation notifications
Wallet Balance	Balance change notifications
Trade Activities	Real-time trade stream
Pool	Pool state changes

---

Token Tools

token_search

Search for tokens.

Search for PEPE-related tokens

token_get

Get token details.

View details of token So11111111111111111111111111111111111111112

token_get_metadata

Get token metadata (name, symbol, logo, etc.).

Get this token's logo and social media links

token_get_stats

Get token statistics (volume, buy/sell counts, etc.).

View this token's trading statistics for the past 24 hours

token_get_price

Get current token price.

What's the current price of BONK?

token_get_prices

Get token price history.

View ETH price trend over the past week

token_get_candles

Get token candlestick data.

Get the last 100 hourly candles for SOL

token_get_holders

Get token holder information.

How many holders does this token have?

token_get_top_holders

Get top token holders list.

View the top 10 holders of this token

token_get_pools

Get liquidity pools for a token.

Which DEXes have liquidity pools for this token?

token_get_security

Get token security check results.

Check if this token is safe

token_get_creation

Get token creation information.

When was this token created? Who created it?

token_get_mint_and_burn

Get token mint and burn history.

View mint and burn history for this token

token_list

Get token list (with pagination and filters).

List recently created tokens on Solana

token_get_traders_tag

Get trader tag distribution for a token.

Analyze what types of traders are trading this token

token_get_liquidity_snapshots

Get token liquidity snapshots.

View this token's liquidity changes over the past week

token_dev_get_tokens

Get all tokens created by a developer.

What other tokens has this developer created?

---

Wallet Tools

wallet_get_balance

Get wallet balance.

Query all token balances for address 0x1234...abcd

wallet_get_balance_updates

Get wallet balance change history.

Show recent fund movements for this wallet

wallet_get_pnl

Get wallet profit and loss data.

Calculate total returns and win rate for this address

wallet_calculate_pnl

Calculate wallet PnL for specific conditions.

Calculate this address's returns over the past 30 days

wallet_get_stats

Get wallet statistics.

Analyze this wallet's trading style and activity level

---

Trade Tools

trade_get

Get trade records.

View the last 20 trades for 0x...

trade_get_activities

Get trade activity stream.

Recent trading activities for this token

trade_get_top_traders

Get top traders.

View the most profitable traders for this token

---

DexPool Tools

dexpool_get

Get pool information.

View details of this pool

dexpool_get_snapshots

Get pool snapshot history.

This pool's liquidity changes over the past 24 hours

---

Ranking Tools

ranking_get_hot_tokens

Get hot tokens ranking.

Top 10 hottest tokens today

ranking_get_new_tokens

Get new tokens list.

Tokens created in the last hour

ranking_get_stocks

Get stock tokens (not graduated).

Which tokens are still on bonding curve on Pump.fun

ranking_get_final_stretch

Get tokens about to graduate.

Which tokens are about to graduate from Pump.fun

ranking_get_migrated

Get graduated tokens list.

Recently graduated tokens to Raydium

---

Blockchain Tools

blockchain_list

Get supported blockchain list.

Which blockchains does ChainStream support?

blockchain_get_latest_block

Get latest block information.

What's the latest block number on Ethereum?

---

Dex Tools

dex_list

Get supported DEX list.

Which DEXes are supported on Solana?

dex_get_quote

Get trade quote.

How much USDC can I get for 1 SOL?

dex_get_route

Get optimal trade route.

Find the best route from ETH to ARB

dex_swap

Execute token swap.

Swap 0.5 SOL to BONK for me

dex_create

Create transaction (requires signing).

Create a transaction from USDC to ETH

---

DeFi Tools

pumpfun_create

Create token on Pump.fun.

Create a new token on Pump.fun

moonshot_create

Create token on Moonshot.

Create a token on Moonshot

moonshot_submit_create_token

Submit Moonshot token creation transaction.

Submit Moonshot token creation transaction

---

Transaction Tools

transaction_send

Send signed transaction.

Send this transaction

transaction_get_gas_price

Get current gas price.

What's the gas price on Ethereum right now?

transaction_estimate_gas_limit

Estimate transaction gas limit.

Estimate how much gas this transaction needs

---

RedPacket Tools

redpacket_create

Create red packet.

Create a red packet with 10 SOL, split into 100 shares

redpacket_claim

Claim red packet.

Claim this red packet

redpacket_get

Get red packet information.

View details of this red packet

redpacket_get_claims

Get red packet claim records.

Who claimed this red packet?

---

Webhook Tools

webhook_list_endpoints

Get configured webhook endpoints list.

View all my configured webhooks

webhook_create_endpoint

Create new webhook endpoint.

Create a new webhook to receive token creation events

webhook_update_endpoint

Update webhook endpoint configuration.

Update this webhook's callback URL

webhook_delete_endpoint

Delete webhook endpoint.

Delete this webhook

webhook_get_secret

Get webhook signing secret.

Get the signing secret for this webhook

webhook_rotate_secret

Rotate webhook signing secret.

Regenerate this webhook's secret

---

WebSocket Subscriptions

MCP service also supports WebSocket real-time subscriptions for the following data:

Subscription Types

Type	Description	Example Prompt
Candles	Real-time price candles	”Subscribe to 1-minute candles for this token”
Token Stats	Real-time trading stats	”Monitor trading data for this token in real-time”
New Tokens	New token notifications	”Notify me of new tokens on Solana”
Token Metadata	New token metadata	”Get detailed info for new tokens”
Wallet Balance	Balance changes	”Monitor balance changes for this wallet”
Wallet Trades	Trade notifications	”Notify me when this wallet makes a trade”
Trade Activities	Real-time trade stream	”Show real-time trades for this token”
Pool	Pool state	”Monitor liquidity changes for this pool”
Rankings	Hot tokens updates	”Real-time hot token rankings update”

For detailed WebSocket subscription parameters and response formats, refer to WebSocket API docs.

---

Supported Blockchains

Chain	Identifier	Type
Solana	sol	L1
Ethereum	eth	L1 (EVM)
BSC	bsc	L1 (EVM)

---

Prompt Best Practices

Specify the Chain

✅ Good: Query balance of 0x... on Ethereum
❌ Bad: Query balance of 0x...

Provide Full Address

✅ Good: Analyze 0x1234567890abcdef1234567890abcdef12345678
❌ Bad: Analyze 0x1234...5678

Specify Time Range

✅ Good: View trade records from the past 7 days
❌ Bad: View recent trades

Break Down Complex Tasks

Split complex tasks into simpler questions:

✅ Good:
1. First query this address's holdings
2. Then analyze its trade history
3. Finally determine its investment style

❌ Bad:
Tell me everything about this address

Use Context for Follow-ups

User: Query holdings of 0x...
AI: [Returns holdings list]
User: Which of these tokens has the highest gain?
User: Analyze reasons for holding PEPE

---

Related Documentation

MCP Introduction

Learn about MCP protocol and capabilities

Setup Guide

Configure MCP Server

API Reference

Complete REST API documentation

WebSocket API

Real-time data subscriptions