Skip to main content
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

Tool CategoryFunctions
TokenToken search, info, price, candles, holders, security check
WalletBalance, PnL, stats, balance updates
TradeTrade records, activities, top traders
DexPoolPool info, snapshots
RankingHot tokens, new tokens, final stretch, migrated
BlockchainChain info, latest block

Token Tools

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?

KYT Tools

kyt_register_transfer

Register deposit transaction for risk assessment.
Check the risk of this deposit transaction

kyt_get_transfer_summary

Get transaction risk summary.
View the risk assessment result for this transaction

kyt_get_transfer_exposures

Get transaction direct risk exposures.
What risk entities are involved in this transaction?

kyt_get_transfer_alerts

Get transaction risk alerts.
Any alerts for this transaction?

kyt_register_withdrawal

Register withdrawal for risk assessment.
Check the risk of this withdrawal's destination address

kyt_register_address

Register address for risk assessment.
Assess the risk level of this address

kyt_get_address_risk

Get address risk assessment result.
What's the risk level of this address?

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

TypeDescriptionExample Prompt
CandlesReal-time price candles”Subscribe to 1-minute candles for this token”
Token StatsReal-time trading stats”Monitor trading data for this token in real-time”
New TokensNew token notifications”Notify me of new tokens on Solana”
Token MetadataNew token metadata”Get detailed info for new tokens”
Wallet BalanceBalance changes”Monitor balance changes for this wallet”
Wallet TradesTrade notifications”Notify me when this wallet makes a trade”
Trade ActivitiesReal-time trade stream”Show real-time trades for this token”
PoolPool state”Monitor liquidity changes for this pool”
RankingsHot tokens updates”Real-time hot token rankings update”
For detailed WebSocket subscription parameters and response formats, refer to WebSocket API docs.

Supported Blockchains

ChainIdentifierType
EthereumethereumEVM
BNB ChainbscEVM
PolygonpolygonEVM
ArbitrumarbitrumEVM
OptimismoptimismEVM
BasebaseEVM
AvalancheavalancheEVM
SolanasolNon-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