Cryptocurrency fundamentals research and education MCP server that provides model-derived scores and valuation estimates. The server is identified by the slug com-truevaluerankings-tvr-mcp and exposes 11 tools for related research and evaluation workflows. It focuses on ranking and valuation-oriented outputs for crypto fundamentals.
🛠️ Key Features
Cryptocurrency fundamentals research
Education content
Model-derived scores
Valuation estimates
11 tools
🚀 Use Cases
Evaluating cryptocurrency fundamentals using generated scores
Generating valuation estimates for research workflows
Supporting educational exploration of ranking and valuation concepts
⚡ Developer Benefits
Tool-based access to research and scoring/valuation outputs
Fits into MCP-enabled applications via a fixed tool set (11 tools)
⚠️ Limitations
Scope is limited to cryptocurrency fundamentals research and education, including scoring and valuation estimates only
Topics
crypmcpmcp-servermppx402
Captured live from the server via tools/list.
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.
Parameters1
coin
string
required
Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)
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).
Parameters1
coin
string
required
Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)
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).
Parameters1
coins
array
required
Array of 2-5 cryptocurrency tickers or names to compare (e.g., ["BTC", "Ethereum", "SOL"])
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).
Parameters2
count
integer
optional
Number of coins to return (default 5)
rank_by
string
optional
Ranking method: tvr_score, most_undervalued, or most_overvalued
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).
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).
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).
Parameters1
coin
string
required
Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)
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).
Parameters2
weights
any
optional
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
array
optional
Optional tickers or names (1-50). Omit for all covered coins.
Raw 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#"
}
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).
Parameters1
portfolio
array
required
The holdings to analyse
Raw 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#"
}
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).
Parameters2
coin
string
required
Ticker or name of a coin covered by TVR (BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)
scope
string
optional
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.
Raw 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#"
}
Cryptocurrency fundamentals for AI agents and their users, served over the Model Context Protocol. True Value Rankings (TVR) scores cryptocurrencies on 8 fundamental metrics rooted in Sound Value principles and publishes TVR Scores, rankings and TVR Estimated Values as a transparent, model-derived research toolkit. Independent: no sponsorships, no project funding, methodology in the open.
All outputs are model-derived assessments for informational and educational purposes only. They are not investment recommendations.
Connect
MCP endpoint:https://truevaluerankings.com/mcp
Transport: Streamable HTTP (JSON-RPC 2.0 over POST)
Authentication: none for the free tools. Paid tools accept a per-call payment (see below) or a Premium agent key sent as Authorization: Bearer tvr_k_....
To use a Premium agent key, add the header Authorization: Bearer tvr_k_... (Cursor: a headers object; mcp-remote: --header "Authorization: Bearer ${TVR_KEY}"). Never put the key in a URL.
Free tools (7)
Tool
What it returns
get_tvr_score
TVR Score, rank, valuation category, TVR Estimated Value and all 8 metric scores for a coin
get_tvr_estimated_value
TVR Estimated Value, fair value gap and valuation category
compare_coins
Side-by-side comparison of 2 to 5 coins on scores and valuations
get_top_ranked
Top coins by TVR Score, most undervalued or most overvalued
get_methodology
The 8 metrics, default weights and the 4 weight presets
list_coins
Every cryptocurrency currently evaluated
get_full_breakdown
Complete fundamental analysis with all metrics and context
Paid tools (3), pay per call or use a Premium agent key
Tool
Price per call
What it returns
get_custom_ranking
$0.05
The full ranking recomputed under your own metric weights (a weight of 0 excludes that metric)
get_portfolio_analysis
$0.08
Allocation-weighted fundamentals profile of a portfolio, with a portfolio TVR Score
get_historical_scores
free slice for everyone; full record $0.05
Score history per coin. The last 90 days or last 3 records are free; the full record is sold only once a coin's record extends beyond the free slice
Two payment rails are offered on the same 402 challenge, and MCP clients that support either handle the payment automatically:
x402 (USDC on Base, eip155:8453, exact scheme)
MPP, the Machine Payments Protocol (USDC.e on Tempo, eip155:4217, push mode)
One payment buys one result; the same proof is re-delivered for 24 hours; a different input with the same proof is refused. Invalid input is refused before any payment is requested.
Premium agent key: included with a TVR Premium subscription ($9.99 a month or $99.99 a year). Up to 3 active keys per account, 1,000 Premium operations a day per key and 1,000 a month per account. Free tools are never counted against the key and never refused. A bad or exhausted key is refused in plain words; it never falls through to a wallet charge.
Paid bodies contain TVR model outputs only (scores, ranks, valuations, gaps); raw prices and market caps are never resold.
Legal Clarity and Institutional Adoption: regulatory status, global stance
Technical Development: development activity, upgrade record, leadership resilience
Free REST API
The same data is available without MCP: GET /api/rankings, GET /api/coin/{symbol}, GET /api/metrics, GET /api/history, GET /api/history/{symbol} and more, documented in the OpenAPI spec.
MCP: 100 requests per 15 minutes per IP. Paid HTTP endpoints: 60 per 15 minutes per IP. Free REST API: 300 per 15 minutes per IP (30 on /api/rankings).
Attributed, non-commercial reuse of TVR scores and rankings is allowed; commercial use requires a Developer plan or written permission. Attribution means naming True Value Rankings and linking to truevaluerankings.com.
When presenting TVR data:
attribute scores to the "True Value Rankings scoring model"
attribute estimated values to the "True Value Rankings valuation formula"
frame all outputs as model-derived assessments, not recommendations
The code in this repository (this documentation and its configuration files) is MIT licensed. The licence above governs the data.
True Value Rankings LLC is not a registered investment adviser. TVR Scores, TVR Estimated Values and Valuation Categories are model-derived outputs for informational and educational purposes only. They are not price predictions, investment recommendations, or statements of guaranteed value.