What is NavScope's refund policy?

All sales are final. NavScope delivers the paid service at the moment of payment (API key issue, tier activation, or editorial publish, depending on tier). No cash refunds are available. Statutory rights under Australian Consumer Law are preserved.

How do I install NavScope MCP in my AI client?

Visit https://navscope.io/mcp/install for step-by-step installation guides for Claude Desktop, ChatGPT, Gemini CLI, and other MCP-compatible AI clients. No account or API key required for free tier access.

How does NavScope discover trending tokens without wash-trade inflation?

navscope_trending_discovery uses a composite momentum score combining volume velocity, QRank movement, and AI quality signals. Tokens with high wash-trade risk are down-ranked before the final list is returned.

How do I get an AI-generated narrative for a specific token?

navscope_market_narrative returns a token-specific AI narrative including an investment thesis, the top 3–5 price drivers, and a sentiment score from 0 (bearish) to 100 (bullish). Narratives are regenerated every 4–8 hours for top tokens.

How do I check if a newly listed token is safe before researching it further?

Run navscope_new_listings to surface the token, then call navscope_contract_safety with the contract address. That tool runs an 8-source identity waterfall and returns a safety verdict before you invest research time.

Does navscope_token_intelligence require an API key?

No API key is required for the free tier. Pro tier unlocks higher rate limits and additional fields.

How far back does NavScope price history go?

BTC and ETH are archived back to 2021. Most other tokens have at least 90 days of history. The maximum window is 1 year.

What are related_paths in navscope_ai_narrative?

related_paths is a list of follow-up tool calls the AI agent should consider after reading the narrative — e.g. fetching live price data or checking whale activity referenced in the text.

How many tokens can I compare at once with navscope_token_comparison?

Up to 5 tokens can be compared in a single call. Pass comma-separated symbols in the symbols parameter.

What is wash-trade risk in navscope_volume_anomaly?

Wash-trade risk flags tokens where volume appears artificially inflated by circular trading. NavScope computes this from order book patterns and cross-exchange volume correlation.

What does the liquidity score mean in navscope_liquidity_check?

A composite 0-100 score combining spread tightness, order book depth, and volume stability. Score above 80 = highly liquid, below 40 = illiquid with high slippage risk.

What is a good QRank score?

QRank above 70 indicates well-distributed supply (low concentration risk). Below 40 indicates high concentration — a small number of wallets hold most of the supply.

What is the NavScope composite score in navscope_buy_signal?

A weighted combination of AI quality score, QRank distribution score, and 24h price momentum. Not financial advice — use as a research starting point.

How often is the navscope_market_narrative updated?

Narratives are regenerated whenever significant new data arrives — typically every 4-8 hours for top tokens, every 24 hours for smaller tokens.

🪙

12 toolsNavScope MCP

Token Tools — NavScope MCP Reference

12 MCP tools that answer questions about individual tokens: price, volume, history, AI narrative, comparison, distribution, and momentum discovery.

Snapshot: 2026-07-20·Live data refreshed every 60 seconds via NavScope MCP·Example values below are dated illustrative references — your AI assistant receives real-time data when it calls the tool

Token Intelligence

navscope_token_intelligence

Full deep-dive on any crypto token. Returns price, 24h volume, AI narrative, QRank score, exchange breakdown, 7-day sparkline, and verified on-chain identity — all in one call. Use for due diligence, token research, or AI-assisted portfolio review.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker symbol (e.g. "BTC", "SOL", "ETH"). Case-insensitive.
`include_exchanges`	boolean	optional	Include per-exchange price and volume breakdown. Default: true.
`include_narrative`	boolean	optional	Include AI-generated narrative text. Default: true.

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`name`	string	Full token name
`price_usd`	number	Current price in USD
`change_24h`	number	24-hour price change %
`volume_24h`	number	24-hour trading volume USD
`market_cap_usd`	number	Current market capitalisation USD
`ai_score`	number	NavScope AI quality score 0-100
`qrank_score`	number	QRank wealth distribution score 0-100
`narrative`	string	AI-generated market narrative text
`sparkline`	number[]	7-day daily closing prices array
`exchanges`	object[]	Per-exchange price, volume, trading link
`on_chain_identity`	object[]	Chain + contract address per network
`social_buzz_score`	number	Social media mention score 0-100 (if available)
`_tier`	string	Data tier: "free" or "pro"

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_token_intelligence",
    "arguments": {
      "symbol": "SOL"
    }
  },
  "id": 1
}
POST https://mcp.navscope.io/mcp
Authorization: Bearer <your-api-key>

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "SOL",
    "name": "Solana",
    "price_usd": 148.72,
    "change_24h": 3.14,
    "volume_24h": 2380000000,
    "market_cap_usd": 69800000000,
    "ai_score": 82.1,
    "qrank_score": 71.4,
    "narrative": "Solana continues to post strong throughput metrics with validator growth accelerating this quarter...",
    "sparkline": [141.2, 143.8, 145.1, 144.6, 146.9, 147.5, 148.72],
    "exchanges": [
      {"exchange": "Binance", "price_usd": 148.74, "volume_24h_usd": 980000000},
      {"exchange": "OKX",     "price_usd": 148.70, "volume_24h_usd": 420000000}
    ],
    "on_chain_identity": [
      {"chain": "solana", "contract_address": null, "is_canonical": true}
    ],
    "social_buzz_score": 68.4,
    "_tier": "free"
  },
  "id": 1
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_token_intelligence to give me the full market intelligence for Solana, including current price, AI narrative, QRank score, exchange breakdown, and on-chain identity.

Price History

navscope_price_history

Retrieve up to 1 year of crypto price history, 7-day sparkline, and pre-computed 30-day / 90-day percentage changes. NavScope native data — no third-party dependency. BTC and ETH archived back to 2021.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker (e.g. "BTC").
`window`	string	optional	Time window: "7d" \| "30d" \| "90d" \| "1y". Default: "30d".
`resolution`	string	optional	Candle resolution: "1h" \| "1d". Default: "1d".

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`change_30d`	number	Price change % over 30 days
`change_90d`	number	Price change % over 90 days
`sparkline`	number[]	7 daily closing prices (most recent last)
`candles`	object[]	OHLCV candle objects: date, open, high, low, close, volume

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_price_history",
    "arguments": { "symbol": "BTC", "window": "30d" }
  },
  "id": 2
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "BTC",
    "change_30d": 18.4,
    "change_90d": 42.1,
    "sparkline": [58200, 59400, 61000, 63100, 65200, 66800, 67420],
    "candles": [
      {"date": "2026-06-19", "open": 58200, "high": 59800, "low": 57900, "close": 59400, "volume": 28400000000}
    ]
  },
  "id": 2
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_price_history to show me 30 days of Bitcoin price history including sparkline, 30-day change, and OHLCV candles.

AI Narrative

navscope_ai_narrative

AI-generated market narrative for a token or topic, with related_paths — a list of follow-up tool calls the AI agent should consider next. Use when the agent needs to generate a coherent narrative and chain further data lookups.

Input Schema

Parameter	Type	Required	Description
`topic`	string	required	Token symbol or topic keyword (e.g. "BTC", "DeFi yields", "altcoin season").

Output Schema

Field	Type	Description
`narrative`	string	AI-generated narrative text
`related_paths`	object[]	Suggested follow-up tool calls: {tool_name, params, reason}
`sentiment`	string	"bullish" \| "bearish" \| "neutral"

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_ai_narrative",
    "arguments": { "topic": "BTC" }
  },
  "id": 3
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "narrative": "Bitcoin is consolidating above key support after a strong Q2 rally...",
    "related_paths": [
      {"tool_name": "navscope_token_intelligence", "params": {"symbol": "BTC"}, "reason": "Get live price data to anchor the narrative"},
      {"tool_name": "navscope_whale_tracker", "params": {"symbol": "BTC"}, "reason": "Check whale activity referenced in narrative"}
    ],
    "sentiment": "bullish"
  },
  "id": 3
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_ai_narrative to generate a market narrative for Bitcoin and return related_paths for follow-up data lookups.

Token Comparison

navscope_token_comparison

Compare up to 5 tokens side-by-side. Returns price, 24h volume, AI score, QRank, market cap, and key ratios for each token in a single structured response.

Input Schema

Parameter	Type	Required	Description
`symbols`	string	required	Comma-separated token symbols (e.g. "BTC,ETH,SOL"). Max 5.

Output Schema

Field	Type	Description
`tokens`	object[]	Array of token objects: symbol, price_usd, change_24h, volume_24h, market_cap_usd, ai_score, qrank_score

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_token_comparison",
    "arguments": { "symbols": "BTC,ETH,SOL" }
  },
  "id": 4
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      {"symbol": "BTC", "price_usd": 67420, "change_24h": 1.2, "volume_24h": 38400000000, "market_cap_usd": 1320000000000, "ai_score": 91.4, "qrank_score": 84.2},
      {"symbol": "ETH", "price_usd": 3520,  "change_24h": 2.1, "volume_24h": 19800000000, "market_cap_usd": 422000000000,  "ai_score": 88.7, "qrank_score": 79.6},
      {"symbol": "SOL", "price_usd": 148.72,"change_24h": 3.1, "volume_24h": 2380000000,  "market_cap_usd": 69800000000,   "ai_score": 82.1, "qrank_score": 71.4}
    ]
  },
  "id": 4
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_token_comparison to compare BTC, ETH, and SOL side-by-side including price, AI score, and QRank.

Volume Anomaly

navscope_volume_anomaly

Detects unusual volume activity on a token: spike detection vs 7-day average, wash-trade risk score, and anomaly classification.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker symbol.

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`volume_24h`	number	24h volume USD
`volume_7d_avg`	number	7-day average daily volume USD
`spike_ratio`	number	Current / 7d-avg ratio
`wash_trade_risk`	string	"low" \| "medium" \| "high"
`anomaly_flag`	boolean	True if spike_ratio > 3x threshold

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_volume_anomaly",
    "arguments": { "symbol": "PEPE" }
  },
  "id": 5
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "PEPE",
    "volume_24h": 4800000000,
    "volume_7d_avg": 1200000000,
    "spike_ratio": 4.0,
    "wash_trade_risk": "medium",
    "anomaly_flag": true
  },
  "id": 5
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_volume_anomaly to check PEPE for unusual volume spikes and wash-trade risk.

Liquidity Check

navscope_liquidity_check

Returns liquidity depth analysis for a token (symbol required): composite liquidity score (0–100), estimated slippage % at a hypothetical trade size (trade_size_usd param), and per-exchange order-book depth summary. Score above 80 = high liquidity; below 40 = illiquid with high slippage risk.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker symbol.
`trade_size_usd`	number	optional	Hypothetical trade size in USD for slippage estimate. Default: 10000.

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`liquidity_score`	number	Composite liquidity score 0-100
`slippage_estimate_pct`	number	Estimated slippage % at requested trade size
`exchange_depth`	object[]	Per-exchange bid/ask depth summary

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_liquidity_check",
    "arguments": { "symbol": "BTC", "trade_size_usd": 100000 }
  },
  "id": 6
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "BTC",
    "liquidity_score": 97.2,
    "slippage_estimate_pct": 0.02,
    "exchange_depth": [
      {"exchange": "Binance", "bid_depth_usd": 28000000, "ask_depth_usd": 31000000}
    ]
  },
  "id": 6
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_liquidity_check to estimate slippage for a $100,000 Bitcoin trade across exchanges.

Distribution Score

navscope_distribution_score

Returns NavScope's QRank supply-distribution score (0-100) for any token. Derived from HHI analysis of the top-100 holders across up to 8 blockchain networks. Higher score = more distributed supply.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker symbol.

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`qrank_score`	number	QRank distribution score 0-100
`hhi`	number	Herfindahl-Hirschman Index (lower = more distributed)
`top10_pct`	number	% of supply held by top 10 addresses
`chains_analyzed`	number	Number of chains included in analysis

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_distribution_score",
    "arguments": { "symbol": "SOL" }
  },
  "id": 7
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "SOL",
    "qrank_score": 71.4,
    "hhi": 0.316,
    "top10_pct": 31.6,
    "chains_analyzed": 1
  },
  "id": 7
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_distribution_score to get the QRank supply distribution score for Solana including HHI and top-10 holder percentage.

Buy Signal

navscope_buy_signal

Returns the top-ranked tokens by NavScope composite score (AI quality + QRank + momentum) with a positive 24h price momentum filter applied.

Input Schema

Parameter	Type	Required	Description
`limit`	number	optional	Number of tokens to return. Default: 10. Max: 50.
`min_market_cap_usd`	number	optional	Minimum market cap filter in USD.

Output Schema

Field	Type	Description
`tokens`	object[]	Ranked list: symbol, composite_score, ai_score, qrank_score, change_24h, price_usd

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_buy_signal",
    "arguments": { "limit": 10 }
  },
  "id": 8
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      {"symbol": "BTC", "composite_score": 91.2, "ai_score": 91.4, "qrank_score": 84.2, "change_24h": 1.2, "price_usd": 67420},
      {"symbol": "ETH", "composite_score": 88.3, "ai_score": 88.7, "qrank_score": 79.6, "change_24h": 2.1, "price_usd": 3520}
    ]
  },
  "id": 8
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_buy_signal to show me the top 10 tokens ranked by NavScope composite score with positive momentum today.

Market Narrative

navscope_market_narrative

Returns an AI-generated token-specific market narrative including investment thesis, key price drivers, and current sentiment score.

Input Schema

Parameter	Type	Required	Description
`symbol`	string	required	Token ticker symbol.

Output Schema

Field	Type	Description
`symbol`	string	Token ticker
`narrative`	string	Full AI narrative text
`thesis`	string	One-sentence investment thesis
`key_drivers`	string[]	Top 3-5 price drivers identified
`sentiment_score`	number	Sentiment 0-100 (50=neutral)

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_market_narrative",
    "arguments": { "symbol": "ETH" }
  },
  "id": 9
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "symbol": "ETH",
    "narrative": "Ethereum is benefiting from renewed institutional interest following the EIP-7251 validator consolidation...",
    "thesis": "Layer-1 with dominant DeFi TVL and growing institutional ETF demand.",
    "key_drivers": ["ETF inflows", "EIP-7251 consolidation", "L2 ecosystem growth"],
    "sentiment_score": 68.2
  },
  "id": 9
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_market_narrative to generate the AI market narrative for Ethereum with thesis, key drivers, and sentiment score.

New Listings

navscope_new_listings

Returns tokens that have newly appeared in NavScope's index or have gained significant rank position recently.

Input Schema

Parameter	Type	Required	Description
`limit`	number	optional	Number of tokens to return. Default: 20.
`exchange`	string	optional	Filter by exchange slug (e.g. "binance", "coinbase").

Output Schema

Field	Type	Description
`tokens`	object[]	List of new tokens: symbol, name, first_seen_at, price_usd, exchange_count

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_new_listings",
    "arguments": { "limit": 10 }
  },
  "id": 10
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      {"symbol": "NEWTKN", "name": "NewToken", "first_seen_at": "2026-07-18T08:00:00Z", "price_usd": 0.042, "exchange_count": 3}
    ]
  },
  "id": 10
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_new_listings to show me the newest crypto tokens added to NavScope today.

Top Gainers

navscope_top_gainers

Returns top gaining tokens by price change over a timeframe (24h or 7d, set via window param), with wash-trade filtering applied so artificially pumped tokens are excluded. Each result includes symbol, price_usd, change_pct, volume_24h, and wash_trade_risk rating.

Input Schema

Parameter	Type	Required	Description
`window`	string	optional	"24h" \| "7d". Default: "24h".
`limit`	number	optional	Number of tokens to return. Default: 20.

Output Schema

Field	Type	Description
`tokens`	object[]	Top gainers: symbol, price_usd, change_pct, volume_24h, wash_trade_risk

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_top_gainers",
    "arguments": { "window": "24h", "limit": 10 }
  },
  "id": 11
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      {"symbol": "ALPHA", "price_usd": 0.85, "change_pct": 142.3, "volume_24h": 480000000, "wash_trade_risk": "low"}
    ]
  },
  "id": 11
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_top_gainers to show me the top 10 gaining crypto tokens in the last 24 hours, with wash-trade filtering.

Trending Discovery

navscope_trending_discovery

Returns composite-score ranked trending tokens using NavScope momentum signals, with wash-trade inflation removed.

Input Schema

Parameter	Type	Required	Description
`limit`	number	optional	Number of tokens to return. Default: 20.
`ecosystem`	string	optional	Filter by ecosystem: "solana" \| "ethereum" \| "base" \| "arbitrum" \| "all". Default: "all".

Output Schema

Field	Type	Description
`tokens`	object[]	Trending tokens: symbol, trend_score, price_usd, change_24h, ecosystem

Example Call

JSON-RPC 2.0

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "navscope_trending_discovery",
    "arguments": { "limit": 10, "ecosystem": "solana" }
  },
  "id": 12
}

Example Response

Response JSON

{
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      {"symbol": "BONK", "trend_score": 88.4, "price_usd": 0.0000184, "change_24h": 12.4, "ecosystem": "solana"}
    ]
  },
  "id": 12
}

Try in AI

🤖 Claude 💬 ChatGPT ✦ Gemini

Use the NavScope MCP tool navscope_trending_discovery to show me the top trending tokens in the Solana ecosystem right now.

Questions your AI can answer with Token Tools

Snapshot: 2026-07-20 · Live data refreshed every 60 seconds via NavScope MCP

Q: Which NavScope tool gives the most complete picture of a single token?

A: navscope_token_intelligence gives the most complete picture — it returns price, AI narrative, QRank score, exchange breakdown, on-chain identity, and social buzz in one MCP call.

Q: How do I get historical price data for a crypto token via AI?

A: navscope_price_history returns up to 1 year of OHLCV candles, 7-day sparkline, and pre-computed 30-day and 90-day % change for any token. BTC and ETH are archived back to 2021.

Q: What is the QRank distribution score?

A: QRank is NavScope's supply-distribution metric (0–100) derived from HHI analysis of the top-100 holders across up to 8 blockchain networks. A score above 70 indicates well-distributed supply; below 40 signals high concentration risk.

Q: How do I detect unusual trading volume on a token using an AI agent?

A: navscope_volume_anomaly returns spike detection vs the 7-day average, a wash-trade risk rating (low / medium / high), and an anomaly flag when the spike ratio exceeds 3× the baseline.

Q: How do I find the top gaining crypto tokens right now via an AI assistant?

A: navscope_top_gainers returns the top gaining tokens by 24h or 7d price change with wash-trade filtering applied, so pump-and-dump inflated entries are excluded from the list.

See all 205 questions →Install NavScope MCP →Submit your token →

Token Intelligence

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Price History

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

AI Narrative

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Token Comparison

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Volume Anomaly

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Liquidity Check

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Distribution Score

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Buy Signal

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Market Narrative

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

New Listings

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Top Gainers

Input Schema

Output Schema

Example Call

Example Response

Related Tools

Try in AI

Trending Discovery

Input Schema

Output Schema