x402 crypto market structure
x402-mcp
面向 AI 代理的跨交易所加密货币市场结构。涵盖 20 个交易所、26 种代币、6 种工具——包括快照、订单流、宏观环境、全面分析、地址风险和 API 信息。通过 MCP 免费使用。
x402-mcp 是一个 stdio MCP 服务器,它将 x402.tunedfor.ai(一个实时加密市场结构 API)作为 6 种工具公开,任何兼容 MCP 的客户端(Claude Desktop、Cursor、Cline、Windsurf、Claude Code)均可调用。通过 MCP 免费用于测试和低频查询;对于需要更高吞吐量的生产环境代理,可在相同端点使用付费 REST 服务。
安装
Claude Desktop / Cursor / Windsurf
添加到您的 MCP 配置中(macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json,其他操作系统路径类似):
{
"mcpServers": {
"x402": {
"command": "npx",
"args": ["-y", "@tunedforai/x402-mcp"]
}
}
}Claude Code
claude mcp add x402 -- npx -y @tunedforai/x402-mcpCline / Continue / 其他 MCP 客户端
使用与 stdio 命令相同的 npx -y @tunedforai/x402-mcp 调用方式。
手动安装
npm install -g @tunedforai/x402-mcp
x402-mcp # runs the stdio serverRelated MCP server: hyperd-mcp
工具
所有 6 种工具均为无状态。无需 API 密钥,无需身份验证,无需设置。直接调用即可。
工具 | 返回内容 | REST 等效项 | MCP 免费 / REST 付费 |
| 实时价格、资金费率、持仓量 (OI)、买卖比率、恐慌贪婪指数 |
| 免费 / $0.20 |
| 宏观环境、DXY、VIX、方向性信号 + 置信度 |
| 免费 / $0.25 |
| 跨交易所 CVD、鲸鱼活动、清算压力 |
| 免费 / $0.50 |
| 快照 + 订单流 + LLM 合成分析 |
| 免费 / $0.75 |
| 钱包风险评分(混币器、制裁、交易对手)。EVM + Solana |
| 免费 / $0.25 |
| 定价、快速入门、迁移详情 |
| 免费 |
代币覆盖范围
快照层级涵盖主流 L1 和 L2:BTC、ETH、SOL、XRP、BNB、DOGE、ADA、AVAX、LINK、ATOM、DOT、ARB、SUI、OP、LTC。
扩展订单流层级:除上述代币外,还包括 NEAR、AAVE、BCH、HBAR、SHIB、TON、TRX、UNI、XLM。
从任何 MCP 客户端调用 apiInfo 以获取权威的当前列表。
示例
交易前检查
You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
(mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
Snapshot 12 sec old.跨交易所订单流
You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
Whale activity: 8 large bars across Binance/Coinbase/Bybit.
Liquidations: $890K longs, $230K shorts. Pressure: bearish.免费 MCP 与付费 REST 的区别
MCP 封装版免费且有速率限制——非常适合测试、原型设计、低频代理工作流和个人使用。
对于生产环境代理(24/7 轮询、多代币监控、大规模回测),请使用 x402.tunedfor.ai 上的付费 REST 端点。REST 服务的特点:
通过 x402 协议 在 Base 或 Solana 上以 USDC 按次付费
无 API 密钥——您的代理在本地签署支付;私钥永远不会离开您的机器
速率限制为每个钱包每分钟 60 次调用,每小时 200 次调用——防止滥用;超出限制返回 429
无订阅——无月度最低消费
从任何 MCP 客户端调用 apiInfo 以获取当前的定价表、迁移指南和 SDK 示例。
x402 支付的工作原理(REST 层级)
当您的代理调用付费 REST 端点时:
首次请求返回
HTTP 402 Payment Required以及价格信息代理在本地签署 USDC 支付(私钥永远不会离开代理)
代理携带支付头信息重试请求
服务器验证链上结算并返回数据
无需账户,无需 API 密钥,无需信用卡。只需 USDC 和一个钱包。
数据来源
价格 + 报价: OKX、Coinbase 公共 API
资金费率 / 持仓量 / 清算: Coinalyze(商业许可)
链上指标、交易所流量、鲸鱼比率: 授权的第三方机构数据
跨交易所订单流(CVD、鲸鱼柱、清算聚合): 跨 20 个交易所的 WebSocket 聚合器,存入 InfluxDB,归一化为 1 分钟 K 线
宏观背景(DXY、VIX、国债收益率): FRED + Finviz
恐慌贪婪指数: alternative.me
我们不分发原始交易所数据——我们提供衍生、计算后的聚合数据。所有原始源字段在返回响应前都会转换为我们自己的复合信号。
链接
服务: x402.tunedfor.ai
REST 文档: x402.tunedfor.ai/catalog
npm: @tunedforai/x402-mcp
Smithery: smithery.ai/server/@tunedforai/x402-mcp
x402 协议: x402.org
许可证
MIT © Tuned For AI
Available Tools
9 toolsaddressRiskB
Risk score for an Ethereum wallet address. Flags mixers, sanctions, high-risk counterparties.
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Full 42-character Ethereum address (0x...) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions what the tool flags (mixers, sanctions, high-risk counterparties) but doesn't describe how the risk score is calculated, what format the output takes, whether it's real-time or cached, rate limits, or error handling. For a risk assessment tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise and front-loaded, consisting of a single sentence that efficiently communicates the core functionality. Every word earns its place, with no redundant or vague language, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of risk assessment (involving scoring and flagging multiple risk types) and the absence of both annotations and an output schema, the description is incomplete. It doesn't explain what the output looks like (e.g., score range, flag details), how to interpret results, or behavioral aspects like data freshness or limitations. For a tool with no structured output documentation, this leaves too much undefined.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with the 'address' parameter fully documented in the schema. The description doesn't add any parameter-specific details beyond what the schema provides (e.g., it doesn't clarify address validation rules or examples). With high schema coverage, the baseline score of 3 is appropriate as the description doesn't compensate but also doesn't detract.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verbs ('Risk score', 'Flags') and resources ('Ethereum wallet address'), distinguishing it from sibling tools focused on market data, history, or API info. It precisely communicates what the tool does: assess risk and identify specific risk categories.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. While it implies usage for risk assessment of Ethereum addresses, it doesn't mention prerequisites, exclusions, or compare it to sibling tools like marketAnalyze or history tools that might offer different data. No explicit when/when-not instructions are present.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
apiInfoB
x402 API pricing, quick start guide, and migration details for the pay-per-call REST endpoint.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It describes the tool as informational ('pricing, quick start guide, and migration details'), which suggests a read-only, non-destructive operation. However, it lacks details on authentication requirements, rate limits, response format, or error handling, which are important for behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the key information ('API pricing, quick start guide, and migration details') without unnecessary words. Every part of the sentence contributes to understanding the tool's purpose, making it appropriately concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (simple informational with 0 parameters), no annotations, and no output schema, the description is minimally adequate. It covers the purpose but lacks details on output format, error cases, or behavioral constraints. For a tool with no structured fields to rely on, it should provide more context to be fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters with 100% schema description coverage, so the schema fully documents the absence of inputs. The description doesn't need to add parameter semantics, and it doesn't incorrectly imply any parameters. A baseline of 4 is appropriate for a zero-parameter tool with complete schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides 'API pricing, quick start guide, and migration details' for the 'x402 API' and 'pay-per-call REST endpoint', which is a specific verb (provides) and resource (API documentation). However, it doesn't explicitly differentiate from sibling tools like 'marketAnalyze' or 'marketSnapshot', which appear to be market data tools rather than API documentation tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for API information needs but provides no explicit guidance on when to use this tool versus alternatives. There's no mention of prerequisites, context for use, or comparison with sibling tools, leaving the agent to infer usage based on the purpose alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
history1dA
Daily OHLCV price history with buy/sell flow data. Up to 7 years of daily bars, up to 5,000 bars per call. Good for backtesting and trend analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
| limit | No | Number of daily bars (max 5000) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It adds useful context beyond the schema, such as the 7-year data limit and 5,000-bar cap per call, which are behavioral traits. However, it lacks details on error handling, rate limits, or data freshness, leaving gaps for a mutation-free tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded, with three concise sentences that each add value: the first defines the data, the second sets constraints, and the third suggests use cases. There is no wasted text, making it efficient and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (read-only data retrieval with two parameters), no annotations, and no output schema, the description is mostly complete. It covers purpose, constraints, and use cases, but lacks details on output format or error scenarios, which would be helpful for full completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, so the schema already documents both parameters (token and limit) fully. The description does not add any parameter-specific semantics beyond what the schema provides, such as examples or format details, resulting in the baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verbs and resources: 'Daily OHLCV price history with buy/sell flow data' identifies what data is retrieved, and 'Up to 7 years of daily bars, up to 5,000 bars per call' specifies the scope and constraints. It distinguishes from siblings like history1h and history5m by emphasizing daily frequency.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context for when to use this tool: 'Good for backtesting and trend analysis' suggests appropriate use cases. However, it does not explicitly state when not to use it or name alternatives (e.g., history1h for hourly data), which prevents a score of 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
history1hA
Hourly OHLCV price history with buy/sell flow data. Up to 7 years of 1-hour bars, up to 5,000 bars per call.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
| limit | No | Number of bars to return (max 5000) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It effectively describes key behavioral traits: the tool returns historical data (implied read-only), specifies data granularity (1-hour bars), and mentions constraints (up to 7 years, max 5,000 bars per call). However, it lacks details on error handling, rate limits, authentication needs, or response format, which are important for a tool with data retrieval.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise and front-loaded, consisting of just two sentences that efficiently convey the tool's purpose and key constraints. Every word earns its place, with no redundant or vague language, making it easy for an AI agent to quickly understand the tool's functionality.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (historical data retrieval with two parameters) and lack of annotations and output schema, the description is moderately complete. It covers the data type, granularity, and constraints but omits details on response format, error conditions, and authentication requirements. For a tool without structured output documentation, more context on what the tool returns would be beneficial to achieve a higher score.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with both parameters (token and limit) well-documented in the schema. The description adds no additional parameter semantics beyond what the schema provides, such as explaining token symbol formats or bar count implications. Given the high schema coverage, a baseline score of 3 is appropriate as the description does not compensate but also does not detract.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verbs ('Hourly OHLCV price history with buy/sell flow data') and distinguishes it from siblings by specifying the time granularity ('1-hour bars'). It explicitly mentions the resource (price history data) and scope (up to 7 years, up to 5,000 bars per call), making it easy to differentiate from tools like history1d or history5m.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context for when to use this tool by specifying the data type (hourly OHLCV with buy/sell flow) and limitations (up to 7 years, max 5,000 bars). However, it does not explicitly state when not to use it or name alternatives (e.g., history1d for daily data or history5m for 5-minute data), which would be needed for a score of 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
history5mB
5-minute OHLCV price bars. High-resolution intraday data.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
| limit | No | Number of 5-minute bars |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions 'high-resolution intraday data' which hints at detailed data, but fails to disclose critical behavioral traits such as rate limits, data freshness, authentication needs, or what 'OHLCV' specifically entails (e.g., open, high, low, close, volume). This leaves significant gaps for an agent to understand operational constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two short phrases: '5-minute OHLCV price bars. High-resolution intraday data.' Every word earns its place by specifying timeframe, data type, and resolution without any waste or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of financial data tools and the lack of annotations and output schema, the description is incomplete. It doesn't explain return values (e.g., structure of OHLCV bars), data sources, latency, or error handling. For a tool with no structured output and behavioral gaps, this is inadequate for an agent to use effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with clear descriptions for 'token' and 'limit' parameters. The description adds no additional parameter semantics beyond what the schema provides, such as format details for 'token' or constraints on 'limit'. Baseline 3 is appropriate since the schema adequately documents parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides '5-minute OHLCV price bars' and 'high-resolution intraday data', which specifies the verb (provides/returns) and resource (price bars/data). It distinguishes from siblings like history1d and history1h by specifying the 5-minute timeframe, though it doesn't explicitly name those alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for intraday data analysis by mentioning 'high-resolution intraday data', suggesting it's for short-term timeframes. However, it doesn't provide explicit guidance on when to use this tool versus alternatives like history1h or history1d, nor does it mention any exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
marketAnalyzeC
Full pre-trade macro analysis: regime detection, DXY, VIX, fear/greed, directional signal and confidence score.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. While it mentions the analysis outputs, it doesn't describe execution characteristics like whether it's read-only, requires authentication, has rate limits, or what happens on failure. For a tool with no annotation coverage, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that lists all analysis components. It's appropriately sized and front-loaded with the main purpose, though it could be slightly more structured by separating the analysis components for better readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of market analysis, no annotations, and no output schema, the description is moderately complete. It outlines what the analysis includes but lacks details on return format, error conditions, or behavioral constraints that would be needed for full contextual understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description doesn't mention any parameters, but the input schema has 100% coverage with one parameter (token) fully documented. The baseline is 3 since the schema does the heavy lifting, though the description could have added context about why token selection matters for the analysis.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs 'Full pre-trade macro analysis' with specific components listed (regime detection, DXY, VIX, fear/greed, directional signal and confidence score). It specifies the verb 'analyze' and resource 'market' context, though it doesn't explicitly differentiate from sibling tools like marketFull or marketSnapshot.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like marketFull, marketOrderflow, or marketSnapshot. It mentions 'pre-trade' context but doesn't specify use cases, prerequisites, or exclusions relative to sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
marketFullB
Full market data bundle: snapshot + orderflow combined. Most comprehensive view.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions 'bundle' and 'combined' but doesn't specify whether this is a read-only operation, what data format is returned, whether there are rate limits, authentication requirements, or any side effects. For a data retrieval tool with zero annotation coverage, this leaves significant behavioral questions unanswered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with just two short phrases. It's front-loaded with the core purpose. While efficient, it might be too brief given the lack of annotations and behavioral context needed for a comprehensive data tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a market data tool with no annotations, no output schema, and siblings that provide similar functionality, the description is insufficient. It doesn't explain what 'combined' means operationally, what data format to expect, or how this differs from using marketSnapshot and marketOrderflow separately. For a tool positioned as 'most comprehensive view,' more context is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with the single parameter 'token' well-documented in the schema. The description doesn't add any parameter-specific information beyond what the schema provides. According to guidelines, when schema coverage is high (>80%), the baseline is 3 even with no param info in the description, which applies here.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides 'Full market data bundle: snapshot + orderflow combined' which specifies the verb (provides) and resource (market data bundle). It distinguishes from siblings by mentioning 'snapshot + orderflow combined' which differentiates it from marketSnapshot and marketOrderflow. However, it doesn't explicitly state what 'combined' means operationally.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context with 'Most comprehensive view' suggesting this should be used when needing complete market data. However, it doesn't explicitly state when to use this versus marketSnapshot or marketOrderflow, nor does it provide any exclusion criteria or prerequisites. The guidance is implied rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
marketOrderflowC
Real-time orderflow data: buy/sell pressure, delta, imbalance across exchanges.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol | BTC |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions 'real-time' data but doesn't disclose behavioral traits like rate limits, authentication requirements, data freshness guarantees, or whether this is a read-only operation. For a real-time data tool with zero annotation coverage, this leaves significant gaps in understanding how the tool behaves.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise - a single sentence that efficiently communicates the core functionality. Every word earns its place by specifying the data type, key metrics, and scope. There's no wasted verbiage or unnecessary elaboration.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a real-time data tool with no annotations and no output schema, the description is insufficient. It doesn't explain what format the data returns, how frequently it updates, whether there are subscription requirements, or what 'across exchanges' means operationally. The description leaves too many practical questions unanswered for effective tool invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with the single parameter 'token' clearly documented in the schema. The description doesn't add any parameter-specific information beyond what the schema provides (it doesn't explain token format constraints or default behavior). With high schema coverage, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides 'real-time orderflow data' with specific metrics (buy/sell pressure, delta, imbalance) across exchanges. It uses a specific verb ('provides' implied) and resource (orderflow data), but doesn't explicitly distinguish from sibling tools like marketAnalyze or marketSnapshot, which might offer different market data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, timing considerations, or compare it to sibling tools like marketAnalyze or marketSnapshot that might offer different types of market data. The agent must infer usage from the name and description alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
marketSnapshotB
Live crypto market snapshot: price, funding rate, open interest, buy/sell ratio, fear/greed index. Supports BTC ETH SOL XRP BNB DOGE ADA AVAX LINK ATOM DOT ARB SUI OP LTC.
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Token symbol, e.g. BTC, ETH, SOL | BTC |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions 'Live crypto market snapshot' which suggests real-time data, but does not disclose behavioral traits such as rate limits, data freshness, authentication needs, or error handling. The description is minimal and lacks critical operational details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded, starting with the core purpose and followed by supported tokens. It uses a single sentence efficiently, though it could be slightly more structured for readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It does not explain what the return values look like (e.g., format of the snapshot data), error conditions, or other contextual details needed for effective tool use. The description relies too heavily on implied understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents the 'token' parameter. The description adds value by listing specific token examples (BTC, ETH, SOL, etc.), which helps clarify valid inputs beyond the schema's generic description. However, it does not provide additional syntax or format details.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verbs ('Live crypto market snapshot') and resources (price, funding rate, open interest, etc.), and distinguishes it from siblings by listing the specific tokens it supports. It provides a comprehensive overview of what data the tool retrieves.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage by listing the supported tokens, but does not explicitly state when to use this tool versus alternatives like marketAnalyze or marketFull. It provides some context but lacks explicit guidance on tool selection or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
9 tool updates
- First observed
addressRisk - First observed
apiInfo - First observed
history1d - First observed
history1h - First observed
history5m - First observed
marketAnalyze - First observed
marketFull - First observed
marketOrderflow - First observed
marketSnapshot
TDQS
Scored across 9 tools
Most tools have distinct purposes, such as addressRisk for wallet analysis and apiInfo for API details, but the market-related tools (marketAnalyze, marketFull, marketOrderflow, marketSnapshot) have some overlap in providing market data, which could cause confusion. However, their descriptions help clarify specific focuses like orderflow vs. snapshot.
The naming is mixed: history tools use a consistent pattern (history1d, history1h, history5m), but market tools vary (marketAnalyze, marketFull, marketOrderflow, marketSnapshot), and others like addressRisk and apiInfo use different styles. This lacks a unified verb_noun convention, though names remain readable.
With 9 tools, the count is well-scoped for a crypto market structure server, covering risk assessment, API info, historical data at multiple resolutions, and various market analyses. Each tool earns its place without feeling excessive or insufficient.
The tool set covers key aspects of crypto market analysis, including risk, API access, historical data, and real-time market insights. Minor gaps might exist, such as lack of tools for portfolio management or advanced trading actions, but core workflows for data retrieval and analysis are well-covered.
Maintenance
Related MCP Connectors
Crypto perps data for AI agents: funding rates, open interest, liquidations, order book, CVD.
Cross-asset market data and LLM inference for AI agents. Pay-per-call in USDC via x402.
Verified market data for AI trading agents: quality-flagged candles, funding, OI, order flow. x402.
Pay-per-call crypto market intelligence for AI agents. USDC on Base via x402.
Related MCP Servers
- AlicenseAqualityCmaintenanceReal-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.1551 PyPI1MIT

hyperd-mcpofficial
AlicenseAqualityCmaintenancePre-trade DeFi intelligence for AI agents. 20 paid x402 endpoints, USDC on Base.2323 npm1MIT
Funding-mcpofficial
AlicenseAqualityCmaintenanceReal-time perp market-data for AI trading agents — funding rates, funding-arb signals, open interest, volume, orderbook depth/slippage and oracle families across 25 venues, plus HIP-3 RWA coverage (tokenized stocks, metals, oil) that mainstream aggregators lack. x402-native pay-per-call (USDC on Base): one free funding screener tool + 11 paid tools with auto-pay.1215 npm2MIT- AlicenseNot gradedqualityBmaintenanceRead-only crypto perps microstructure for AI agents: normalized cross-exchange market state (funding + multi-year percentile, OI, volume, CVD, order-book imbalance, liquidations, basis), OHLCV, 15-min state history, and measured conditional outcomes (historical base rates, not predictions) — 6 assets across Binance, Bybit, OKX and Hyperliquid, every metric with self-declared coverage and freshnessMIT