x402 crypto market structure
This server provides real-time and historical crypto market data, orderflow analysis, macro regime detection, and wallet risk scoring — accessible as free MCP tools for AI agents.
Live Market Snapshot (
marketSnapshot): Get real-time price, funding rate, open interest, buy/sell ratio, and Fear & Greed index for major tokens (BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC).Macro Market Analysis (
marketAnalyze): Pre-trade analysis including regime detection, DXY, VIX, directional signal, and confidence score.Cross-Exchange Orderflow (
marketOrderflow): Real-time buy/sell pressure, cumulative volume delta (CVD), whale activity, and liquidation pressure aggregated across 20+ exchanges.Full Market Bundle (
marketFull): Combined snapshot + orderflow data with LLM-synthesized analysis in a single call.Historical Price Data: Up to 5,000 bars (up to 7 years) of OHLCV data with buy/sell flow at three granularities:
Hourly (
history1h)Daily (
history1d) — ideal for backtesting5-minute (
history5m) — high-resolution intraday
Wallet Risk Scoring (
addressRisk): Analyze Ethereum or Solana addresses for mixer usage, sanctions exposure, and high-risk counterparty connections.API Info (
apiInfo): Retrieve current pricing schedules, quick-start guides, token coverage, and migration details for the paid REST tier.
All MCP tools are stateless and require no API key. A paid REST tier is available for higher throughput, with pay-per-call access via USDC on Base or Solana.
Provides market data and analysis for the AMP cryptocurrency token, including live price, funding, open interest, buy/sell ratios, and historical OHLCV data.
Integrates with Binance exchange data as part of cross-exchange market structure analysis, providing orderflow, CVD, whale activity, and liquidation pressure metrics.
Integrates with Coinbase exchange data as part of cross-exchange market structure analysis, providing price data, orderflow metrics, and market aggregates.
Uses InfluxDB to store and serve normalized 1-minute bars of cross-exchange orderflow data aggregated from 20 cryptocurrency exchanges.
Provides market data and analysis for the NEAR cryptocurrency token, including live price, funding, open interest, buy/sell ratios, and historical OHLCV data.
Integrates with OKX exchange data as part of cross-exchange market structure analysis, providing price data and market aggregates.
Provides wallet risk analysis for Solana addresses, including risk scoring for mixers, sanctions, and counterparties, and supports Solana-based USDC payments for REST API access.
Provides market data and analysis for the SUI cryptocurrency token, including live price, funding, open interest, buy/sell ratios, and historical OHLCV data.
Provides market data and analysis for the TON cryptocurrency token, including live price, funding, open interest, buy/sell ratios, and historical OHLCV data.
Provides market data and analysis for the XRP cryptocurrency token, including live price, funding, open interest, buy/sell ratios, and historical OHLCV data.
x402-mcp
Cross-exchange crypto market structure for AI agents. 20 exchanges, 26 fixed Pillar tokens plus any-token light coverage, 7 tools - light coverage, snapshot, orderflow, macro regime, full analysis, address risk, and API info. Free via MCP.
x402-mcp is a stdio MCP server that exposes x402.tunedfor.ai - a real-time crypto market structure API - as 7 tools any MCP-compatible client (Claude Desktop, Cursor, Cline, Windsurf, Claude Code) can call. Free via MCP for testing and low-frequency queries; paid REST at the same endpoints for production agents that need higher throughput.
Install
Claude Desktop / Cursor / Windsurf
Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, equivalent on other OS):
{
"mcpServers": {
"x402": {
"command": "npx",
"args": ["-y", "@tunedforai/x402-mcp"]
}
}
}Claude Code
claude mcp add x402 -- npx -y @tunedforai/x402-mcpCline / Continue / other MCP clients
Use the same npx -y @tunedforai/x402-mcp invocation as the stdio command.
Manual
npm install -g @tunedforai/x402-mcp
x402-mcp # runs the stdio serverRelated MCP server: hyperd-mcp
Tools
All 7 tools are stateless. No API key, no auth, no setup. Just call them.
Tool | What it returns | REST equivalent | Free via MCP / Paid REST |
| Any-token CoinGecko-backed market coverage: price, momentum, rank, liquidity/exchange context, and risk flags. Defaults to |
| Free / $0.05 |
| Free 16-field MCP subset: live price, funding, OI, buy/sell ratio, fear/greed |
| Free / $0.20 |
| Macro regime, DXY, VIX, directional signal + confidence |
| Free / $0.25 |
| Cross-exchange CVD, whale activity, liquidation pressure |
| Free / $0.50 |
| Snapshot + orderflow + LLM-synthesized analysis |
| Free / $0.75 |
| Wallet risk score (mixers, sanctions, counterparties). EVM + Solana |
| Free / $0.25 |
| Pricing, quick-start, migration details |
| Free |
Token coverage
Major L1s and L2s on the snapshot tier: BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC.
Extended orderflow tier: the above plus NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM.
marketLight supports listed CoinGecko symbols beyond the fixed Pillar token list. Use it for lightweight coverage of tokens such as WCT when the fixed snapshot/orderflow tools reject a symbol. It defaults to brief=off for lower latency; request brief=full when you specifically need the Kimi-generated prose brief.
Call apiInfo from any MCP client for the authoritative current list.
MCP subset contract
marketSnapshot returns a free 16-field MCP subset for agent context and routing. It is not the paid REST /data schema.
Expected top-level MCP keys:
as_of_utctokensnapshotdata_freshnesspresentation_hintnext_steps
The snapshot object carries the 16 market data fields plus metadata. token and fetched_at are metadata keys, so a raw JSON key count may show 17 keys under snapshot even though the product contract is the 16-field market-data subset.
Do not require schema_version or coverage from MCP. Those belong to the paid REST contract unless the MCP product contract is intentionally expanded.
Every marketSnapshot response must keep the REST CTA:
This is a 16-field MCP subset. Paid REST /data at x402.tunedfor.ai ($0.20 USDC) returns the full 70-field snapshot including on-chain metrics, sentiment, and historical percentiles. No API key, pay-per-call from any wallet.Examples
Pre-trade check
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.Cross-exchange orderflow
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.Free MCP vs Paid REST
The MCP wrapper is free with rate limits — perfect for testing, prototyping, low-frequency agent workflows, and personal use.
For production agents (24/7 polling, multi-token monitoring, backtesting at scale), use the paid REST endpoints at x402.tunedfor.ai. REST is:
Pay-per-call in USDC on Base or Solana via the x402 protocol
No API keys — your agent signs payment locally; the private key never leaves your machine
Rate-limited to 60 calls/minute and 200 calls/hour per wallet — prevents stripmining; 429 on breach
No subscriptions — no monthly minimums
Call apiInfo from any MCP client to get the current pricing schedule, migration guide, and SDK examples.
How x402 payment works (REST tier)
When your agent calls a paid REST endpoint:
First request returns
HTTP 402 Payment Requiredwith the priceAgent signs a USDC payment locally (private key never leaves the agent)
Agent retries with the payment header attached
Server verifies on-chain settlement and returns the data
No accounts, no API keys, no credit cards. Just USDC and a wallet.
Data sources
Price + ticker: OKX, Coinbase public APIs
Funding / OI / liquidations: Coinalyze (commercial license)
On-chain metrics, exchange flows, whale ratios: licensed third-party institutional data
Cross-exchange orderflow (CVD, whale bars, liq aggregations): WebSocket aggregator across 20 exchanges into InfluxDB, normalized into 1-minute bars
Macro context (DXY, VIX, Treasury yields): FRED + Finviz
Fear & Greed Index: alternative.me
We don't redistribute raw exchange data — we serve derived, computed aggregates. All raw source fields are transformed into our own composite signals before responses are returned.
Links
Service: x402.tunedfor.ai
REST docs: x402.tunedfor.ai/catalog
Quick-start: x402.tunedfor.ai/llms.txt
npm: @tunedforai/x402-mcp
Smithery: smithery.ai/server/@tunedforai/x402-mcp
Issues / requests: github.com/tunedforai/x402-mcp/issues
x402 protocol: x402.org
License
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.
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.
Pay-per-call x402 data API for AI trading agents: Polymarket arbitrage, kimchi premium & more.
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.151MIT

hyperd-mcpofficial
AlicenseAqualityCmaintenancePre-trade DeFi intelligence for AI agents. 20 paid x402 endpoints, USDC on Base.2321 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 gradedqualityAmaintenanceRead-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