MCP Server
True Value Rankings
com.truevaluerankings/tvr-mcp
What this MCP does
Provides cryptocurrency fundamental scores, rankings, valuation estimates, historical scores, portfolio analysis, and configurable ranking models.
Capabilities
Tools
10
tools
compare_coins
Compare Coins
Free. Compares 2 to 5 cryptocurrencies on TVR Score, rank, valuation, TVR Estimated Value, fair value gap, and all 8 metric scores side by side. Identifies the largest scoring difference. Accepts tickers or names. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coins'], 'properties': {'coins': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'minItems': 2, 'description': 'Array of 2-5 cryptocurrency tickers or names to compare (e.g., ["BTC", "Ethereum", "SOL"])'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'comparison': {'description': 'Per-coin scores, ranks and valuations'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'data_sources': {'description': 'Where the numbers come from'}, 'coins_compared': {'type': 'number'}, 'key_difference': {'description': 'The largest gap between the compared coins'}, 'metric_comparison': {'description': 'Metric-by-metric table'}, 'total_coins_evaluated': {'type': 'number'}}, 'additionalProperties': True}
get_custom_ranking
Get Custom Ranking
Paid. Reranks every coin TVR covers with your own weights for the 8 fundamental metrics, applying TVR's non-public score transformation. Returns rank, TVR Score, valuation category, fair value gap and TVR Estimated Value per coin. $0.05 per call, paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo), or included with a Premium agent key (HTTP header Authorization: Bearer tvr_k_... on this connection); an unpaid call returns the offer (isError with the x402 PaymentRequired in structuredContent) and charges nothing. Invalid input is refused before any payment. Free alternative: get_top_ranked and the four presets. Data from True Value Rankings (truevaluerankings.com).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coins': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50, 'minItems': 1, 'description': 'Optional tickers or names (1-50). Omit for all covered coins.'}, 'weights': {'anyOf': [{'type': 'array', 'items': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'maxItems': 8}, {'type': 'object', 'additionalProperties': {'type': 'number', 'maximum': 100, 'minimum': 0}}], 'description': 'Up to 8 weights (0-100) in this order: economic_model, network_security, adoption, privacy, longevity, liquidity, legal_clarity, technical_dev, or an object keyed by those names. Missing entries take TVR defaults.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'number'}, 'error': {}, 'legal': {}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'context': {}, 'payment': {}, 'product': {'type': 'string'}, 'success': {'type': 'boolean'}, 'rankings': {'type': 'array', 'description': 'Ranked coins under the requested weights'}, 'disclaimer': {}, 'how_to_pay': {}, 'learn_more': {}, 'redelivery': {}, 'weights_used': {}, 'defaults_applied_for': {}}, 'additionalProperties': True}
get_full_breakdown
Get Full Breakdown
Free. Returns the complete fundamental analysis for a cryptocurrency: all 8 metric scores with weights, the scoring factors that shaped them, the valuation note, and ranking context. Accepts a ticker or a name. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coin': {'type': 'string', 'description': 'Coin name'}, 'rank': {'type': 'number', 'description': 'Rank among evaluated coins, 1 is best'}, 'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'symbol': {'type': 'string', 'description': 'Ticker'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'category': {'type': 'string', 'description': 'TVR coin category'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'tvr_score': {'type': 'number', 'description': 'TVR Score, 0 to 100'}, 'valuation': {'type': 'string', 'description': 'Undervalued, Fair Value or Overvalued'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'rank_out_of': {'type': 'number', 'description': 'Number of coins evaluated'}, 'data_sources': {'description': 'Where the numbers come from'}, 'metric_scores': {}, 'fair_value_gap': {'type': 'string', 'description': 'Gap between TVR Estimated Value and market price, formatted as a percentage'}, 'valuation_note': {'type': 'string'}, 'ranking_context': {}, 'scoring_factors': {'description': 'The reasoning behind each metric score'}, 'tvr_estimated_value': {'type': 'string', 'description': 'TVR Estimated Value, formatted in USD'}, 'scoring_methodology_note': {'type': 'string'}}, 'additionalProperties': True}
get_historical_scores
Get Historical Scores
Free slice, paid full record. Score history of one coin: every recorded change to its 8 metric scores as a dated record with the TVR Score, the method version, a source label (baseline for the opening record, auto_captured for rows written from the change itself), the public reason where recorded and a SHA-256 hash per record; forward-only from the day the record began. Without scope (or scope "free"): the last 90 days or the last 3 records, free, no payment, no key. scope "full": the whole record, included with a Premium agent key (Authorization: Bearer on this connection), or $0.05 per pull paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo) once the record extends beyond the free slice; until then the free record is returned and nothing is charged. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Ticker or name of a coin covered by TVR (BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)'}, 'scope': {'enum': ['free', 'full'], 'type': 'string', 'description': 'free (default): the last 90 days or the last 3 records, no payment. full: the whole record; included with a Premium agent key, or paid per pull once the record extends beyond the free slice.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'note': {}, 'error': {}, 'legal': {}, 'scope': {'type': 'string'}, 'access': {}, 'period': {}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'symbol': {'type': 'string'}, 'context': {}, 'payment': {}, 'product': {'type': 'string'}, 'records': {'type': 'array', 'description': 'Dated score states, newest first: as_of, revision, source, scores, tvr_score, method_version, changed_metrics, reason_public, published_at, record_hash'}, 'success': {'type': 'boolean'}, 'coverage': {}, 'hash_note': {'type': 'string'}, 'disclaimer': {}, 'how_to_pay': {}, 'learn_more': {}, 'redelivery': {}, 'full_record': {}, 'hash_format': {'type': 'string'}, 'method_versions': {}}, 'additionalProperties': True}
get_methodology
Get Scoring Methodology
Free. Explains how True Value Rankings scores cryptocurrencies: the 8 metrics, their current default weights, the 4 built-in weight presets, and the general scoring approach. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'methodology': {'description': 'The 8 metrics, their default weights and how the TVR Score is built'}, 'data_sources': {'description': 'Where the numbers come from'}}, 'additionalProperties': True}
get_portfolio_analysis
Get Portfolio Analysis
Paid. Fundamentals profile of a portfolio: allocation-weighted scores for the 8 metrics, each holding's TVR Score and valuation category, and the portfolio TVR Score from TVR's scoring engine (scores only, no prices). $0.08 per call, paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo), or included with a Premium agent key (HTTP header Authorization: Bearer tvr_k_... on this connection); an unpaid call returns the offer (isError with the x402 PaymentRequired in structuredContent) and charges nothing. Invalid input is refused before any payment. Free alternative: compare_coins. Data from True Value Rankings (truevaluerankings.com).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['portfolio'], 'properties': {'portfolio': {'type': 'array', 'items': {'type': 'object', 'required': ['coin', 'allocation'], 'properties': {'coin': {'type': 'string', 'description': 'Ticker or name of a coin covered by TVR'}, 'allocation': {'type': 'number', 'description': 'Allocation above 0 (percent or any weight; normalised to 100%)'}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1, 'description': 'The holdings to analyse'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {}, 'legal': {}, 'access': {}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'context': {}, 'payment': {}, 'product': {'type': 'string'}, 'profile': {}, 'success': {'type': 'boolean'}, 'holdings': {'type': 'array'}, 'disclaimer': {}, 'how_to_pay': {}, 'learn_more': {}, 'redelivery': {}, 'weights_used': {'type': 'string'}, 'blended_metrics': {}, 'portfolio_tvr_score': {'type': 'number'}}, 'additionalProperties': True}
get_top_ranked
Get Top Ranked Coins
Free. Returns the top N cryptocurrencies by a chosen ranking method: tvr_score (fundamental strength), most_undervalued (largest positive fair value gap), or most_overvalued (largest negative fair value gap). Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'integer', 'default': 5, 'maximum': 50, 'minimum': 1, 'description': 'Number of coins to return (default 5)'}, 'rank_by': {'enum': ['tvr_score', 'most_undervalued', 'most_overvalued'], 'type': 'string', 'default': 'tvr_score', 'description': 'Ranking method: tvr_score, most_undervalued, or most_overvalued'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'rank_by': {'type': 'string', 'description': 'The ranking basis used'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'rankings': {'type': 'array', 'description': 'Ordered list of coins'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'data_sources': {'description': 'Where the numbers come from'}, 'rank_by_description': {'type': 'string'}, 'total_coins_evaluated': {'type': 'number'}}, 'additionalProperties': True}
get_tvr_estimated_value
Get TVR Estimated Value
Free. Returns TVR's fair value estimate (TVR Estimated Value) for a cryptocurrency, including the fair value gap and valuation category. The TVR Estimated Value compares fundamental quality to current market price. Accepts a ticker or a name. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coin': {'type': 'string', 'description': 'Coin name'}, 'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'symbol': {'type': 'string', 'description': 'Ticker'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'valuation': {'type': 'string', 'description': 'Undervalued, Fair Value or Overvalued'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'data_sources': {'description': 'Where the numbers come from'}, 'fair_value_gap': {'type': 'string', 'description': 'Gap between TVR Estimated Value and market price, formatted as a percentage'}, 'tvr_estimated_value': {'type': 'string', 'description': 'TVR Estimated Value, formatted in USD'}}, 'additionalProperties': True}
get_tvr_score
Get TVR Score
Free. Returns the TVR Score, rank, valuation category, TVR Estimated Value, fair value gap, and all 8 metric scores for a cryptocurrency. Accepts a ticker (BTC) or a name (Bitcoin). TVR evaluates fundamental strength using Sound Value principles. Data from True Value Rankings (truevaluerankings.com). Rate limit: 100 requests per 15 minutes per IP.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'description': 'Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coin': {'type': 'string', 'description': 'Coin name'}, 'rank': {'type': 'number', 'description': 'Rank among evaluated coins, 1 is best'}, 'error': {'description': 'false on a normal answer, or an error message'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'symbol': {'type': 'string', 'description': 'Ticker'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'category': {'type': 'string', 'description': 'TVR coin category'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'tvr_score': {'type': 'number', 'description': 'TVR Score, 0 to 100'}, 'valuation': {'type': 'string', 'description': 'Undervalued, Fair Value or Overvalued'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'rank_out_of': {'type': 'number', 'description': 'Number of coins evaluated'}, 'data_sources': {'description': 'Where the numbers come from'}, 'metric_scores': {'description': 'All 8 metric scores with their weights'}, 'fair_value_gap': {'type': 'string', 'description': 'Gap between TVR Estimated Value and market price, formatted as a percentage'}, 'weakest_metric': {}, 'strongest_metric': {}, 'tvr_estimated_value': {'type': 'string', 'description': 'TVR Estimated Value, formatted in USD'}}, 'additionalProperties': True}
list_coins
List Evaluated Coins
Free. Lists all cryptocurrencies currently evaluated by True Value Rankings with their symbol, name, and category. New coins are added regularly. Data from True Value Rankings (truevaluerankings.com).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coins': {'type': 'array', 'description': 'Covered coins with ticker and name'}, 'error': {'description': 'false on a normal answer, or an error message'}, 'total': {'type': 'number'}, 'status': {'type': 'string', 'description': 'Present when the request could not be answered as asked, for example not_available'}, 'context': {'description': 'Standing context about TVR and how to read its outputs'}, 'summary': {'type': 'string', 'description': 'Plain-language summary of the answer'}, 'requested': {'type': 'string', 'description': 'What was asked for, when it could not be resolved'}, 'disclaimer': {'type': 'string', 'description': 'Model-derived assessment, not investment advice'}, 'learn_more': {'description': 'Links for more detail'}, 'attribution': {'type': 'string', 'description': 'Required attribution text'}, 'data_sources': {'description': 'Where the numbers come from'}}, 'additionalProperties': True}
History
Recent tool changes
Added
get_historical_scores
Sept. 19, 2026, 2:52 a.m.
Changed
get_portfolio_analysis
Sept. 19, 2026, 2:52 a.m.
Changed
get_custom_ranking
Sept. 19, 2026, 2:52 a.m.
Changed
get_portfolio_analysis
Sept. 17, 2026, 1:01 p.m.
Changed
get_custom_ranking
Sept. 17, 2026, 1:01 p.m.
Added
get_portfolio_analysis
Sept. 17, 2026, 12:38 p.m.
Added
get_custom_ranking
Sept. 17, 2026, 12:38 p.m.
Added
get_full_breakdown
Sept. 17, 2026, 12:38 p.m.
Added
list_coins
Sept. 17, 2026, 12:38 p.m.
Added
get_methodology
Sept. 17, 2026, 12:38 p.m.
Added
get_top_ranked
Sept. 17, 2026, 12:38 p.m.
Added
compare_coins
Sept. 17, 2026, 12:38 p.m.
Added
get_tvr_estimated_value
Sept. 17, 2026, 12:38 p.m.
Added
get_tvr_score
Sept. 17, 2026, 12:38 p.m.
Discover
Similar MCP servers
DeltaSignal ATLAS-7
io.github.aitrailblazer/deltasignal-atlas-7
Analyzes SEC and XBRL data for crypto-related public companies, including fundamentals, issuer signals, peer comparisons, stress …
intel
io.chainhelix/intel
Provides multi-chain market intelligence, blockchain activity metrics, trading and portfolio planning, sanctions clearance, agent…
Market Intelligence API
com.marketintelligenceapi.api/market-intelligence
Analyzes crypto and tokenized-asset markets using DEX flows, perpetual positioning, smart-money activity, token risk, market news…
Gate MCP
io.github.gateio-dev/gate-mcp
Provides public Gate exchange market data for spot, futures, delivery, margin, options, Alpha, Earn products, order books, candle…
AgentFeed
io.github.seekdaseek/agentfeed
Provides crypto market data on liquidations, funding, open interest, order books, spreads, liquidation forecasts, and tokenized-a…
whale-insights
com.cryptowhaleinsights/whale-insights
Provides read-only crypto market and on-chain intelligence, including whale activity, analyst signals, prices, funding rates, gas…
Okx
io.github.pipeworx-io/okx
Provides public OKX market data for crypto instruments, including candles, prices, order books, funding rates, open interest, pos…
mcp
com.bykaranteli/mcp
Provides crypto derivatives and market-structure data including funding, open interest, liquidations, options, ETF flows, leverag…