> ## Documentation Index > Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt > Use this file to discover all available pages before exploring further. # 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](/en/api-reference/authentication/authenticate). *** ## Tools Overview | 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 | | Tool Category | Functions | | ------------- | -------------------------------- | | Dex | Quote, route, swap execution | | DeFi | Create token on Pumpfun/Moonshot | | Transaction | Send transaction, gas estimation | | RedPacket | Create/claim red packets | | Tool Category | Functions | | ------------- | --------------------------------------- | | Webhook | Endpoint management, event subscription | | Blockchain | Supported chains, latest block | | 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](/en/api-reference/endpoint/websocket/api). *** ## 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 Learn about MCP protocol and capabilities Configure MCP Server Complete REST API documentation Real-time data subscriptions