MCP 工具參考

ChainStream MCP Server 把完整的資料目錄和 DeFi 原語封裝成 Model Context Protocol 工具。本頁是權威的參考——關於如何將 MCP Server 接入 Claude、Cursor 等客戶端，參考 MCP Server 安裝。

端點

URL：https://mcp.chainstream.io/mcp
傳輸：Streamable HTTP（水平擴充套件 + 進度回報）
鑑權：Bearer Token（X-API-KEY）或 x402 微支付（Base / Solana 上的 USDC）

兩套工具面

ChainStream 的 MCP Server 提供兩套工具風格。按照 Agent 工作流選擇其一。

風格	命名	何時使用
結果導向工具	`tokens_search`、`dex_swap`（底線）	面向使用者任務的 Agent —— 每個工具編排多次 REST 呼叫並返回整理好的結果。這是 Agent Skills 引用的那套。
Playground 工具	`getToken`、`createEndpoint`（駝峰）	與 REST API 1:1 對應的程式化訪問 —— 輸入 / 輸出與 REST 相同，適合測試與低層自動化

下面的 17 個結果導向工具就是生產環境 MCP 目錄中能看到的。Playground 工具是把整個 REST 介面重新暴露為 MCP 工具，列在最下方。

資源

URI	內容
`chainstream://chains`	支援的鏈及其狀態
`chainstream://chains/{chain}/dexes`	某條鏈上的 DEX 協議
`chainstream://docs/api_reference`	完整 REST API 參考（所有 `/v2/*` 端點）
`chainstream://docs/query_examples`	Agent 常用的查詢模式

風險模型

每個工具都打了一個風險等級標籤。客戶端應該為等級 ≥ L2 的工具加上明確的確認 UI。

等級	含義
L0	只讀、無狀態 —— 可自動呼叫
L1	只讀、使用者範圍（錢包畫像、Webhook 列表）—— 安全但涉及個人資料
L2	只讀但計算量大（回測）—— 可能產生費用
L3	寫入 / 簽名 / 廣播 —— 每次都需要使用者明確確認

結果導向工具（17 個）

代幣情報

工具	描述	關鍵引數	風險
`tokens_search`	跨所有支援鏈按名稱、符號或地址搜尋代幣	`query`、`chain?`	L0
`tokens_analyze`	全面的代幣分析：價格、成交量、持幣人、安全、流動性	`chain`、`address`	L0
`tokens_price_history`	圖表與技術分析用的 OHLCV K 線資料	`chain`、`address`、`resolution`、`from?`、`to?`	L0
`tokens_discover`	按鏈上指標（成交量、漲跌、成交筆數）發現代幣	`chain`、filters	L0
`tokens_compare`	最多 5 個代幣並排對比	`chain`、`addresses[]`	L0

錢包情報

工具	描述	關鍵引數	風險
`wallets_profile`	完整錢包畫像 —— 一次呼叫拿到持倉、PnL 與淨值	`chain`、`address`	L1
`wallets_activity`	最近的錢包轉賬與餘額變化	`chain`、`address`、`limit?`	L1

市場發現

工具	描述	關鍵引數	風險
`market_trending`	按類別（`hot`、`new`、`migrated`、`graduating`、`stocks`）的熱門代幣	`chain`、`category`、`duration`	L0
`trades_recent`	某個代幣或錢包的最近鏈上成交	`chain`、`token?`、`wallet?`、`limit?`	L0

DEX 與交易

工具	描述	關鍵引數	風險
`dex_quote`	帶預期輸出、價格影響與費用的報價（只讀）	`chain`、`from`、`to`、`amount`	L0
`dex_swap`	在 DEX 執行代幣兌換	`chain`、`from`、`to`、`amount`、`slippage`	L3
`dex_create_token`	在 Launchpad 建立代幣	`chain`、`name`、`symbol`、`dex`、`uri`	L3
`trading_backtest`	用歷史資料回測策略	strategy spec	L2
`trading_execute`	執行策略交易	`chain`、`strategy`、`params`	L3
`transaction_send`	廣播已簽名的交易	`chain`、`signed_tx`	L3

運維

工具	描述	關鍵引數	風險
`webhooks_manage`	管理 Webhook 端點（list、create、delete）	`action`、endpoint spec	L1
`blockchain_info`	支援的鏈與 DEX 協議	—	L0

KYT / 合規沒有包成結果導向工具 —— 直接呼叫 REST 的 /v1/kyt/*。見 KYT 概念。

Playground 工具（與 REST 對齊）

Playground 介面把 REST API 1:1 對映成 MCP 工具。每個工具接受與對應 REST 端點完全相同的 JSON 引數，並透過 content[0].text 返回原始 JSON 字串。適合希望程式化使用但走 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

每個 Playground 工具的規範輸入 / 輸出 schema，請參照 API 參考裡對應的 REST 端點 —— JSON 結構完全一致。

客戶端配置示例

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 入門

MCP 是什麼，以及 ChainStream 如何暴露它。

MCP Server 安裝

把 MCP Server 接入 Cursor、Claude Desktop 等客戶端。

x402 支付

面向自治 Agent 的按次付費鑑權。

Agent Skills

疊在 MCP 與 CLI 之上的更高層 SKILL.md 能力包。

鑑權

REST API

WebSocket

Kafka Topics

CLI 命令

MCP 工具

端點

兩套工具面

資源

風險模型

結果導向工具（17 個）

代幣情報

錢包情報

市場發現

DEX 與交易

運維

Playground 工具（與 REST 對齊）

客戶端配置示例

下一步

MCP Server 入門

MCP Server 安裝

x402 支付

Agent Skills

鑑權

REST API

WebSocket

Kafka Topics

CLI 命令

MCP 工具

​端點

​兩套工具面

​資源

​風險模型

​結果導向工具（17 個）

​代幣情報

​錢包情報

​市場發現

​DEX 與交易

​運維

​Playground 工具（與 REST 對齊）

​客戶端配置示例

​下一步

MCP Server 入門

MCP Server 安裝

x402 支付

Agent Skills

端點

兩套工具面

資源

風險模型

結果導向工具（17 個）

代幣情報

錢包情報

市場發現

DEX 與交易

運維

Playground 工具（與 REST 對齊）

客戶端配置示例

下一步