MCP Tools Reference

The ChainStream MCP Server exposes the full data catalog and DeFi primitives as Model Context Protocol tools. This page is the authoritative reference — for how to register the server with Claude, Cursor or other clients see MCP Server Setup.

Endpoint

URL: https://mcp.chainstream.io/mcp
Transport: Streamable HTTP (horizontal scaling + progress reporting)
Auth: Bearer token (X-API-KEY) or x402 micropayment (USDC on Base / Solana)

Two tool surfaces

ChainStream ships the MCP server in two flavours. Pick the one that matches your agent’s workflow.

Surface	Naming	When to use
Outcome-oriented tools	`tokens_search`, `dex_swap` (underscore)	Agents doing user-facing tasks — each tool orchestrates several REST calls and returns a curated result. This is what the Agent Skills reference.
Playground tools	`getToken`, `createEndpoint` (camelCase)	1:1 coverage of the REST API for programmatic use — same inputs/outputs as REST, ideal for testing and low-level automation

The 17 outcome-oriented tools below are what you see in the production MCP catalog. Playground tools are the full REST surface re-exposed as MCP tools — listed at the bottom.

Resources

URI	Content
`chainstream://chains`	Supported chains and status
`chainstream://chains/{chain}/dexes`	DEX protocols for a chain
`chainstream://docs/api_reference`	Full REST API reference (all `/v2/*` endpoints)
`chainstream://docs/query_examples`	Common query patterns for agents

Risk model

Each tool is tagged with a risk level. Clients should surface tools with level ≥ L2 behind explicit confirmation UI.

Level	Meaning
L0	Read-only, stateless — safe to call automatically
L1	Read-only, user-scoped (wallet profile, webhook list) — safe but personal
L2	Read-only but computationally expensive (backtest) — may incur cost
L3	Writes / signs / broadcasts — always requires explicit user confirmation

Outcome-oriented tools (17)

Token intelligence

Tool	Description	Key params	Risk
`tokens_search`	Search tokens by name, symbol or address across every supported chain	`query`, `chain?`	L0
`tokens_analyze`	Comprehensive token analysis: price, volume, holders, security, liquidity	`chain`, `address`	L0
`tokens_price_history`	OHLCV candlestick data for charting and technical analysis	`chain`, `address`, `resolution`, `from?`, `to?`	L0
`tokens_discover`	Find tokens by on-chain metrics (volume, price change, trade count)	`chain`, filters	L0
`tokens_compare`	Side-by-side comparison of up to 5 tokens	`chain`, `addresses[]`	L0

Wallet intelligence

Tool	Description	Key params	Risk
`wallets_profile`	Complete wallet profile — holdings, PnL and net worth in one call	`chain`, `address`	L1
`wallets_activity`	Recent wallet transfers and balance changes	`chain`, `address`, `limit?`	L1

Market discovery

Tool	Description	Key params	Risk
`market_trending`	Trending tokens by category (`hot`, `new`, `migrated`, `graduating`, `stocks`)	`chain`, `category`, `duration`	L0
`trades_recent`	Recent on-chain trades for a token or wallet	`chain`, `token?`, `wallet?`, `limit?`	L0

DEX and trading

Tool	Description	Key params	Risk
`dex_quote`	Swap quote with expected output, price impact and fees (read-only)	`chain`, `from`, `to`, `amount`	L0
`dex_swap`	Execute a token swap on a DEX	`chain`, `from`, `to`, `amount`, `slippage`	L3
`dex_create_token`	Create a token on a launchpad	`chain`, `name`, `symbol`, `dex`, `uri`	L3
`trading_backtest`	Backtest a strategy against historical data	strategy spec	L2
`trading_execute`	Execute a strategy trade	`chain`, `strategy`, `params`	L3
`transaction_send`	Broadcast a signed transaction	`chain`, `signed_tx`	L3

Ops

Tool	Description	Key params	Risk
`webhooks_manage`	Manage webhook endpoints (list, create, delete)	`action`, endpoint spec	L1
`blockchain_info`	Supported chains and DEX protocols	—	L0

KYT / compliance is not wrapped as an outcome tool — call the REST API directly under /v1/kyt/*. See KYT concepts.

Playground tools (REST-parity)

The Playground surface mirrors the REST API 1:1 as MCP tools. Every tool accepts the same JSON parameters as the corresponding REST endpoint and returns a content[0].text JSON string with the raw response. Use these when you want programmatic parity with REST but routed through MCP.

blockchain

getBlockchainList, getBlockchainLatestBlock

token

getToken, getTokens, searchTokens, getTokenMetadata, getTokensMetadata, getTokenLiquidityPools, getTokenStats, getTokensStats, getTokenHolders, getTokenHoldersMulti, getTokenCandles, getTokenTopHolders, getTokenMarketData, getTokensMarketData, getTokenPrices, getTokenPriceByTime, getTokenCreation, getTokenMintBurn, getTokenSecurity, getTokenListFiltered, getDevTokens, getTokenTraders, getTokenLiquiditySnapshots, getTokenTransfers, getTokenTransferTotal, getPairCandles, getPoolCandles

wallet

getTokensBalance, getPnl, getPnlDetails, getPnlByToken, getPnlByWallet, calculatePnl, getNetWorth, getNetWorthDetails, getNetWorthChart, getNetWorthByTokens, getNetWorthSummary, getBalanceUpdates, getWalletTransfers, getWalletTransferTotal, getWalletFirstTx

trade

getTradeList, getTradeTopTraders, getTradeGainersLosers, getTradeActivityList

ranking

getHotTokens, getRankingNewTokens, getRankingStocksTokens, getRankingFinalStretchTokens, getRankingMigratedTokens

dexpool

getDexpoolDetail, getDexpoolSnapshots

dex

getDexList, getQuote, getRoute, swap, createToken

defi

pumpfunCreateToken, moonshotCreateToken

transaction

sendTransaction, getGasPrice, estimateGasLimit

kyt

registerTransfer, getTransferSummary, getTransferAlerts, getTransferDirectExposure, getTransferNetworkIdentifications, registerWithdrawal, getWithdrawalSummary, getWithdrawalAlerts, getWithdrawalDirectExposure, getWithdrawalFraudAssessment, getWithdrawalAddressIdentifications, getWithdrawalNetworkIdentifications, registerAddress, getAddressRisk

webhook

listEndpoints, createEndpoint, getEndpoint, updateEndpoint, deleteEndpoint, getEndpointSecret, rotateEndpointSecret

redpacket

getRedpacketCreate, getRedpacketClaim, getRedpacketGet, getRedpacketGetClaims, getRedpacketGetList, getRedpacketGetClaimsByAddress, getRedpacketGetByAddress, getRedpacketSend

watchlist

watchlistAdd

ipfs

presign

For the canonical input/output schema of each Playground tool, see the matching REST endpoint in the API Reference — the JSON shapes are identical.

Example client config

Cursor / VS Code
Claude Desktop

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": { "X-API-KEY": "<your-api-key>" }
    }
  }
}

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "transport": "streamable-http",
      "headers": { "X-API-KEY": "<your-api-key>" }
    }
  }
}

MCP Server introduction

What MCP is and how ChainStream exposes it.

MCP Server setup

Wiring the server into Cursor, Claude Desktop and others.

x402 Payments

Pay-per-call authentication for autonomous agents.

Agent Skills

Higher-level SKILL.md packages layered on top of MCP and the CLI.

Authentication

REST API

WebSocket

Kafka Topics

CLI Commands

MCP Tools

Endpoint

Two tool surfaces

Resources

Risk model

Outcome-oriented tools (17)

Token intelligence

Wallet intelligence

Market discovery

DEX and trading

Ops

Playground tools (REST-parity)

Example client config

Next

MCP Server introduction

MCP Server setup

x402 Payments

Agent Skills

​Endpoint

​Two tool surfaces

​Resources

​Risk model

​Outcome-oriented tools (17)

​Token intelligence

​Wallet intelligence

​Market discovery

​DEX and trading

​Ops

​Playground tools (REST-parity)

​Example client config

​Next

MCP Server introduction

MCP Server setup

x402 Payments

Agent Skills

Endpoint

Two tool surfaces

Resources

Risk model

Outcome-oriented tools (17)

Token intelligence

Wallet intelligence

Market discovery

DEX and trading

Ops

Playground tools (REST-parity)

Example client config

Next