MCP 工具参考

ChainStream MCP Server 将整个数据目录和 DeFi 原语以 Model Context Protocol 工具的形式暴露出来。本页是权威参考——要把该服务器接入 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 工作流选用即可。

接口	命名方式	适用场景
Outcome-oriented 工具	`tokens_search`、`dex_swap`（下划线）	做用户侧任务的 Agent——每个工具会编排多次 REST 调用并返回精心整理的结果。Agent Skills 引用的就是这一套。
Playground 工具	`getToken`、`createEndpoint`（camelCase）	REST API 的 1:1 映射，供程序化使用——输入输出与 REST 完全一致，适合测试与底层自动化

下面列出的 17 个 outcome-oriented 工具就是生产 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 的工具应当要求用户显式确认。

等级	含义
L0	只读、无状态——可以自动调用
L1	只读但涉及个人数据（钱包档案、webhook 列表）——安全但私密
L2	只读但计算开销大（回测）——可能产生费用
L3	写入 / 签名 / 广播——始终需要用户显式确认

Outcome-oriented 工具（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`、过滤条件	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`	基于历史数据回测策略	策略配置	L2
`trading_execute`	执行一笔策略交易	`chain`、`strategy`、`params`	L3
`transaction_send`	广播已签名的交易	`chain`、`signed_tx`	L3

运维

工具	说明	关键参数	风险
`webhooks_manage`	管理 webhook 端点（列表、创建、删除）	`action`、端点配置	L1
`blockchain_info`	支持的链与 DEX 协议	—	L0

KYT / 合规没有封装成 outcome 工具——直接调用 /v1/kyt/* 下的 REST API 即可。参见 KYT 概念。

Playground 工具（REST 对等）

Playground 接口把 REST API 1:1 映射为 MCP 工具。每个工具接收的 JSON 参数与对应 REST 端点完全相同，返回 content[0].text 包裹的原始 JSON 响应。想要走 MCP 但又要 REST 级别的程序化控制时用它。

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 Reference 中对应的 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 配置

把服务器接入 Cursor、Claude Desktop 等客户端。

x402 支付

给自主 Agent 的按次付费认证。

Agent Skills

叠加在 MCP 与 CLI 之上的更高层 SKILL.md 包。

鉴权

REST API

WebSocket

Kafka Topics

CLI 命令

MCP 工具

端点

两套工具接口

资源

风险模型

Outcome-oriented 工具（17 个）

代币情报

钱包情报

市场发现

DEX 与交易

运维

Playground 工具（REST 对等）

客户端配置示例

下一步

MCP Server 介绍

MCP Server 配置

x402 支付

Agent Skills

​端点

​两套工具接口

​资源

​风险模型

​Outcome-oriented 工具（17 个）

​代币情报

​钱包情报

​市场发现

​DEX 与交易

​运维

​Playground 工具（REST 对等）

​客户端配置示例

​下一步

MCP Server 介绍

MCP Server 配置

x402 支付

Agent Skills

端点

两套工具接口

资源

风险模型

Outcome-oriented 工具（17 个）

代币情报

钱包情报

市场发现

DEX 与交易

运维

Playground 工具（REST 对等）

客户端配置示例

下一步