True Value Rankings
Cryptocurrency fundamentals for agents: TVR Scores, rankings and model-derived valuation estimates.
Should I use this
Quality & Safety
Findings (4)
- LOWTool 'get_tvr_estimated_value' description lacks action verbin get_tvr_estimated_value
- LOWTool 'compare_coins' description lacks action verbin compare_coins
- LOWTool 'get_top_ranked' description lacks action verbin get_top_ranked
- LOWTool 'get_full_breakdown' description lacks action verbin get_full_breakdown
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"tvr-mcp": {
"url": "https://truevaluerankings.com/mcp"
}
}
}Remote endpoints
https://truevaluerankings.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (10)
🟢get_tvr_score(coin)
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.
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
}
},
"required": [
"coin"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Coin name"
},
"symbol": {
"type": "string",
"description": "Ticker"
},
"category": {
"type": "string",
"description": "TVR coin category"
},
"tvr_score": {
"type": "number",
"description": "TVR Score, 0 to 100"
},
"rank": {
"type": "number",
"description": "Rank among evaluated coins, 1 is best"
},
"rank_out_of": {
"type": "number",
"description": "Number of coins evaluated"
},
"valuation": {
"type": "string",
"description": "Undervalued, Fair Value or Overvalued"
},
"tvr_estimated_value": {
"type": "string",
"description": "TVR Estimated Value, formatted in USD"
},
"fair_value_gap": {
"type": "string",
"description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
},
"metric_scores": {
"description": "All 8 metric scores with their weights"
},
"strongest_metric": {},
"weakest_metric": {},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_tvr_estimated_value(coin)
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).
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
}
},
"required": [
"coin"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Coin name"
},
"symbol": {
"type": "string",
"description": "Ticker"
},
"tvr_estimated_value": {
"type": "string",
"description": "TVR Estimated Value, formatted in USD"
},
"fair_value_gap": {
"type": "string",
"description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
},
"valuation": {
"type": "string",
"description": "Undervalued, Fair Value or Overvalued"
},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_coins(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).
Input Schema
{
"type": "object",
"properties": {
"coins": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 5,
"description": "Array of 2-5 cryptocurrency tickers or names to compare (e.g., [\"BTC\", \"Ethereum\", \"SOL\"])"
}
},
"required": [
"coins"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"comparison": {
"description": "Per-coin scores, ranks and valuations"
},
"coins_compared": {
"type": "number"
},
"total_coins_evaluated": {
"type": "number"
},
"key_difference": {
"description": "The largest gap between the compared coins"
},
"metric_comparison": {
"description": "Metric-by-metric table"
},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_top_ranked(count, rank_by)
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).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 5,
"description": "Number of coins to return (default 5)"
},
"rank_by": {
"type": "string",
"enum": [
"tvr_score",
"most_undervalued",
"most_overvalued"
],
"default": "tvr_score",
"description": "Ranking method: tvr_score, most_undervalued, or most_overvalued"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"rank_by": {
"type": "string",
"description": "The ranking basis used"
},
"rank_by_description": {
"type": "string"
},
"rankings": {
"type": "array",
"description": "Ordered list of coins"
},
"total_coins_evaluated": {
"type": "number"
},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"methodology": {
"description": "The 8 metrics, their default weights and how the TVR Score is built"
},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"coins": {
"type": "array",
"description": "Covered coins with ticker and name"
},
"total": {
"type": "number"
},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_full_breakdown(coin)
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).
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
}
},
"required": [
"coin"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "Coin name"
},
"symbol": {
"type": "string",
"description": "Ticker"
},
"category": {
"type": "string",
"description": "TVR coin category"
},
"tvr_score": {
"type": "number",
"description": "TVR Score, 0 to 100"
},
"rank": {
"type": "number",
"description": "Rank among evaluated coins, 1 is best"
},
"rank_out_of": {
"type": "number",
"description": "Number of coins evaluated"
},
"valuation": {
"type": "string",
"description": "Undervalued, Fair Value or Overvalued"
},
"tvr_estimated_value": {
"type": "string",
"description": "TVR Estimated Value, formatted in USD"
},
"fair_value_gap": {
"type": "string",
"description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
},
"metric_scores": {},
"scoring_factors": {
"description": "The reasoning behind each metric score"
},
"scoring_methodology_note": {
"type": "string"
},
"valuation_note": {
"type": "string"
},
"ranking_context": {},
"context": {
"description": "Standing context about TVR and how to read its outputs"
},
"summary": {
"type": "string",
"description": "Plain-language summary of the answer"
},
"data_sources": {
"description": "Where the numbers come from"
},
"attribution": {
"type": "string",
"description": "Required attribution text"
},
"disclaimer": {
"type": "string",
"description": "Model-derived assessment, not investment advice"
},
"learn_more": {
"description": "Links for more detail"
},
"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"
},
"requested": {
"type": "string",
"description": "What was asked for, when it could not be resolved"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_custom_ranking(weights, coins)
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).
Input Schema
{
"type": "object",
"properties": {
"weights": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"maxItems": 8
},
{
"type": "object",
"additionalProperties": {
"type": "number",
"minimum": 0,
"maximum": 100
}
}
],
"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."
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 50,
"description": "Optional tickers or names (1-50). Omit for all covered coins."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"product": {
"type": "string"
},
"rankings": {
"type": "array",
"description": "Ranked coins under the requested weights"
},
"weights_used": {},
"defaults_applied_for": {},
"count": {
"type": "number"
},
"payment": {},
"redelivery": {},
"legal": {},
"error": {},
"status": {
"type": "string"
},
"reason": {
"type": "string"
},
"how_to_pay": {},
"context": {},
"disclaimer": {},
"learn_more": {}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_portfolio_analysis(portfolio)
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).
Input Schema
{
"type": "object",
"properties": {
"portfolio": {
"type": "array",
"items": {
"type": "object",
"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%)"
}
},
"required": [
"coin",
"allocation"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 50,
"description": "The holdings to analyse"
}
},
"required": [
"portfolio"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"product": {
"type": "string"
},
"holdings": {
"type": "array"
},
"portfolio_tvr_score": {
"type": "number"
},
"blended_metrics": {},
"profile": {},
"weights_used": {
"type": "string"
},
"payment": {},
"redelivery": {},
"legal": {},
"access": {},
"error": {},
"status": {
"type": "string"
},
"reason": {
"type": "string"
},
"how_to_pay": {},
"context": {},
"disclaimer": {},
"learn_more": {}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_historical_scores(coin, scope)
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).
Input Schema
{
"type": "object",
"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": {
"type": "string",
"enum": [
"free",
"full"
],
"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."
}
},
"required": [
"coin"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"product": {
"type": "string"
},
"symbol": {
"type": "string"
},
"name": {
"type": "string"
},
"scope": {
"type": "string"
},
"period": {},
"coverage": {},
"method_versions": {},
"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"
},
"full_record": {},
"hash_format": {
"type": "string"
},
"hash_note": {
"type": "string"
},
"payment": {},
"redelivery": {},
"legal": {},
"access": {},
"note": {},
"error": {},
"status": {
"type": "string"
},
"reason": {
"type": "string"
},
"how_to_pay": {},
"context": {},
"disclaimer": {},
"learn_more": {}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence