ChainStream MCP Server 暴露 17 个工具，涵盖代币分析、钱包画像、DEX 交易、市场趋势和区块链操作。无论使用云端端点（https://mcp.chainstream.io/mcp）还是 npm 包（@chainstream-io/mcp），均为同一套 17 个工具。
工具（17）
代币工具（5）
tokens_search
按名称、符号或合约地址在所有支持链上搜索代币。返回排名靠前的匹配项，含名称、符号、链、价格、24 小时涨跌与市值。用户仅提到代币名称时，应优先使用本工具。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
query | string | 是 | — | 搜索词：代币名称、符号或合约地址 |
chain | string | 否 | — | 按链筛选（省略则搜全链） |
limit | number | 否 | 10 | 最大条数（1–50） |
tokens_analyze
综合代币分析：价格、成交量、持仓分布、安全评估与流动性深度。评估任意代币时的首选工具 —— 当用户问「讲讲代币 X」或「这个币安全吗」时使用。价格图表请改用 tokens_price_history。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
address | string | 是 | — | 代币合约地址 |
sections | array | 否 | ["overview","metrics","holders","security"] | 要包含的数据段。取值：overview、metrics、holders、security、liquidity |
此工具将多个 REST API 调用（代币详情、统计、市场数据、Top 持有者、安全审计）聚合为单次响应。
tokens_price_history
获取用于图表与技术分析的 OHLCV K 线数据。最多返回 100 根 K 线（开高低收、成交量）。日内分析可用 1h 或 4h 分辨率，更长周期可用 1d。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
address | string | 是 | — | 代币合约地址 |
resolution | enum | 否 | "1h" | K 线周期：1m、5m、15m、1h、4h、1d |
limit | number | 否 | 50 | K 线数量（1–100） |
tokens_discover
按链上指标发现代币。用于查找满足条件的代币，例如「Solana 上高成交量代币」或「涨幅最大的代币」。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
sort_by | enum | 否 | "volume" | 排序指标：volume、price_change、trades、market_cap |
time_frame | enum | 否 | "24h" | 时间窗口：1h、4h、24h |
min_volume_usd | number | 否 | — | 最低美元成交量 |
limit | number | 否 | 20 | 最大条数（1–50） |
tokens_compare
最多并排对比 5 个代币。返回统一指标：价格、成交量、市值、持币人数、24 小时涨跌。适用于用户问「哪个更好」或需要对比选项时。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
tokens | array | 是 | — | { chain, address } 对象数组（2–5 项） |
钱包工具（2）
wallets_profile
完整钱包画像：当前代币持仓与估值、已实现/未实现盈亏、总净资产。当用户问「这个钱包持有什么」或「这钱包盈利如何」时使用。近期交易请改用 wallets_activity。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
address | string | 是 | — | 钱包地址 |
include | array | 否 | ["holdings","pnl"] | 数据段：holdings（代币余额）、pnl（盈亏）、net_worth（总价值） |
等同于托管端点上的 wallet_get_balance + wallet_get_pnl + wallet_get_net_worth。
wallets_activity
近期钱包活动：代币转账与交易历史。用于排查「这个钱包最近在做什么」或可疑行为。组合与盈亏数据请用 wallets_profile。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
address | string | 是 | — | 钱包地址 |
limit | number | 否 | 20 | 转账条数（1–50） |
市场工具（1）
market_trending
按分类获取热门代币。hot = 成交最活跃，new = 新创建，migrated = 已从 launchpad 迁移到 DEX，graduating = 接近迁移阈值，stocks = 股票相关 meme 币。默认链为 solana。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 否 | "solana" | 查询的链 |
category | enum | 否 | "hot" | 热门分类：hot、new、migrated、graduating、stocks |
limit | number | 否 | 20 | 最大条数（1–50） |
DEX 工具（3）
dex_quote
获取换币报价：预计输出数量、价格冲击与手续费。只读 —— 不会动账。在调用 dex_swap 之前务必先调用本工具，向用户展示将收到的数量并在执行前确认。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
dex | string | 是 | — | DEX 协议（jupiter、raydium、pumpfun 等） |
inputMint | string | 是 | — | 输入代币地址 |
outputMint | string | 是 | — | 输出代币地址 |
amount | string | 是 | — | 输入数量（最小单位） |
slippage | number | 是 | — | 滑点容忍度，百分比（0–100） |
dex_swap
在 DEX 上执行代币兑换。高风险 —— 会产生真实链上交易并转移资金。务必先调用 dex_quote 并向用户展示报价。仅在用户明确确认后再调用本工具。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
dex | string | 是 | — | DEX 协议 |
userAddress | string | 是 | — | 用户钱包地址 |
inputMint | string | 是 | — | 输入代币地址 |
outputMint | string | 是 | — | 输出代币地址 |
amount | string | 是 | — | 输入数量（最小单位） |
slippage | number | 是 | — | 滑点容忍度，百分比（0–100） |
swapMode | enum | 否 | "ExactIn" | 兑换模式：ExactIn、ExactOut |
poolAddress | string | 否 | — | 指定池地址 |
priorityFee | string | 否 | — | Solana 优先费 |
会执行真实链上交易。MCP 客户端应要求用户明确确认。
dex_create_token
在 launchpad 类 DEX（PumpFun、Raydium、Moonshot 等）上创建新代币。高风险 —— 会部署真实代币合约。需要用户确认。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
dex | enum | 是 | — | Launchpad DEX：raydium、pumpfun、moonshot、candy、launchpad |
userAddress | string | 是 | — | 创建者钱包地址 |
name | string | 是 | — | 代币名称（最多 32 字符） |
symbol | string | 是 | — | 代币符号（最多 10 字符） |
uri | string | 否 | — | 代币元数据 URI |
image | string | 否 | — | 代币图片 URL |
priorityFee | string | 否 | — | Solana 优先费 |
交易工具（2）
trading_backtest
用历史数据回测交易策略。返回盈亏曲线、夏普比率、最大回撤与成交明细。当前开发中 —— 有结果时将通过进度通知推送。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
token | string | 是 | — | 代币地址 |
strategy | string | 是 | — | 策略描述或代码 |
startTime | number | 是 | — | 开始时间戳（Unix 秒） |
endTime | number | 是 | — | 结束时间戳（Unix 秒） |
initialCapital | number | 否 | 10000 | 起始资金（美元） |
本工具仍在开发中，当前返回包含所提交参数的占位响应。
trading_execute
根据交易信号在 DEX 上执行交易。高风险 —— 会动用真实资金。需要用户明确确认。若需更细控制兑换参数，可考虑直接使用 dex_swap。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
action | enum | 是 | — | 交易动作：buy、sell |
token | string | 是 | — | 代币地址 |
amount | string | 是 | — | 交易数量 |
maxSlippage | number | 否 | 3.0 | 最大滑点（百分比） |
userAddress | string | 是 | — | 用户钱包地址 |
会执行真实链上交易。MCP 客户端应要求用户明确确认。
成交工具（1）
trades_recent
获取近期链上成交，可按代币或钱包筛选。返回价格、数量、买卖双方与时间戳等明细。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
tokenAddress | string | 否 | — | 仅某代币的成交 |
walletAddress | string | 否 | — | 仅某钱包相关成交 |
limit | number | 否 | 20 | 成交条数（1–50） |
基础设施工具（3）
webhooks_manage
管理用于实时事件通知的 Webhook 端点。用 list 查看已有 Webhook，create 新建订阅，delete 删除端点。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
action | enum | 是 | — | 动作：list、create、delete |
endpoint_id | string | 否 | — | delete 时必填 |
url | string | 否 | — | Webhook URL（create 时必填） |
events | array | 否 | — | 订阅的事件类型（create 时必填） |
blockchain_info
查询支持的区块链与可用 DEX 协议。当智能体需要知道可用链或 DEX 时使用。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 否 | — | 指定链（省略则返回全部链） |
transaction_send
向区块链广播已签名交易。高风险 —— 提交后无法撤销的真实交易。交易须已由用户钱包完成签名。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
chain | string | 是 | — | 区块链标识 |
signedTransaction | string | 是 | — | 已签名交易数据（base64 或 hex） |
REST API 覆盖
17 个 MCP 工具将多个 REST API 端点聚合为更高层级的操作。以下为底层 REST API 的映射参考。
Token（17 个工具）
| 工具 | 说明 |
|---|
token_search | 按名称/符号/地址搜索代币 |
token_get | 代币详细信息 |
token_get_metadata | 代币元数据（名称、符号、Logo） |
token_get_stats | 交易统计 |
token_get_price | 当前价格 |
token_get_prices | 历史价格 |
token_get_candles | K 线数据 |
token_get_holders | 持币人数 |
token_get_top_holders | 大户列表 |
token_get_pools | 流动性池 |
token_get_security | 安全/审计检查 |
token_get_creation | 创建信息（部署者、交易、时间） |
token_get_mint_and_burn | 铸造/销毁历史 |
token_list | 带筛选的分页代币列表 |
token_get_traders_tag | 交易者类型分布 |
token_get_liquidity_snapshots | 历史流动性 |
token_dev_get_tokens | 某开发者发行的全部代币 |
Wallet（5 个工具）
| 工具 | 说明 |
|---|
wallet_get_balance | 代币余额 |
wallet_get_balance_updates | 余额变动历史 |
wallet_get_pnl | 盈亏指标 |
wallet_calculate_pnl | 指定区间盈亏 |
wallet_get_stats | 交易模式与活跃度 |
Trade（3 个工具）
| 工具 | 说明 |
|---|
trade_get | 成交记录 |
trade_get_activities | 交易活动流 |
trade_get_top_traders | 头部交易者 |
DexPool（2 个工具）
| 工具 | 说明 |
|---|
dexpool_get | 池信息 |
dexpool_get_snapshots | 历史池状态 |
Ranking（5 个工具）
| 工具 | 说明 |
|---|
ranking_get_hot_tokens | 热门代币 |
ranking_get_new_tokens | 新创建代币 |
ranking_get_stocks | 联合曲线代币 |
ranking_get_final_stretch | 临近毕业代币 |
ranking_get_migrated | 近期已毕业代币 |
Blockchain（2 个工具）
| 工具 | 说明 |
|---|
blockchain_list | 支持的区块链 |
blockchain_get_latest_block | 当前区块信息 |
DEX（5 个工具）
| 工具 | 说明 |
|---|
dex_list | 支持的 DEX |
dex_get_quote | 兑换报价 |
dex_get_route | 最优路径 |
dex_swap | 执行兑换 |
dex_create | 创建未签名兑换交易 |
DeFi / 代币创建（3 个工具）
| 工具 | 说明 |
|---|
pumpfun_create | 在 Pump.fun 创建代币 |
moonshot_create | 在 Moonshot 创建代币 |
moonshot_submit_create_token | 提交 Moonshot 创建交易 |
Transaction（3 个工具）
| 工具 | 说明 |
|---|
transaction_send | 发送已签名交易 |
transaction_get_gas_price | 当前 Gas 价格 |
transaction_estimate_gas_limit | Gas 估算 |
RedPacket（4 个工具）
| 工具 | 说明 |
|---|
redpacket_create | 创建红包 |
redpacket_claim | 领取奖励 |
redpacket_get | 红包详情 |
redpacket_get_claims | 领取记录 |
KYT 合规（7 个工具）
| 工具 | 说明 |
|---|
kyt_register_transfer | 登记交易以供风险评估 |
kyt_get_transfer_summary | 交易风险摘要 |
kyt_get_transfer_exposures | 交易中的风险实体 |
kyt_get_transfer_alerts | 风险告警 |
kyt_register_withdrawal | 登记提币以供筛查 |
kyt_register_address | 登记地址以供监控 |
kyt_get_address_risk | 地址风险评估 |
Webhook（6 个工具）
| 工具 | 说明 |
|---|
webhook_list_endpoints | 列出端点 |
webhook_create_endpoint | 创建订阅 |
webhook_update_endpoint | 修改配置 |
webhook_delete_endpoint | 删除端点 |
webhook_get_secret | 获取签名密钥 |
webhook_rotate_secret | 轮换密钥 |
连接方式
| 方式 | 端点 | 说明 |
|---|
| 云端 | https://mcp.chainstream.io/mcp | 零安装，同一套 17 个工具 |
| npm stdio | npx @chainstream-io/mcp | 本地进程，适合 IDE 集成 |
| npm HTTP | chainstream-mcp --transport http | 团队服务器、云端部署 |
