tvr-mcp-server
True Value Rankings MCP Server
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/mcpTransport: 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_....MCP Registry name:
com.truevaluerankings/tvr-mcpSetup guide for developers and agents: truevaluerankings.com/developers
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"true-value-rankings": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://truevaluerankings.com/mcp"]
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"true-value-rankings": {
"url": "https://truevaluerankings.com/mcp"
}
}
}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.
Related MCP server: mcp-coinmarketcap
Free tools (7)
Tool | What it returns |
| TVR Score, rank, valuation category, TVR Estimated Value and all 8 metric scores for a coin |
| TVR Estimated Value, fair value gap and valuation category |
| Side-by-side comparison of 2 to 5 coins on scores and valuations |
| Top coins by TVR Score, most undervalued or most overvalued |
| The 8 metrics, default weights and the 4 weight presets |
| Every cryptocurrency currently evaluated |
| 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 |
| $0.05 | The full ranking recomputed under your own metric weights (a weight of 0 excludes that metric) |
| $0.08 | Allocation-weighted fundamentals profile of a portfolio, with a portfolio TVR Score |
| 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.
The 8 metrics
Economic Model: supply cap, inflation, distribution, sustainability
Network Security and Reliability: consensus robustness, decentralization, resilience
Adoption and Network Effects: transaction activity, merchant and institutional use, ecosystem
Privacy and Fungibility: default privacy, fungibility
Longevity (Lindy Effect): operating history
Market Liquidity: volume, exchange availability, market depth
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.
Discovery files
x402.json (paid resources and prices, built from the live routes)
deal-policy.json (data licence)
Rate limits
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).
Example
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_tvr_score",
"arguments": { "coin": "BTC" }
}
}Licence and attribution
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.
Where this server is listed
Official MCP Registry:
com.truevaluerankings/tvr-mcp(https://registry.modelcontextprotocol.io/v0/servers?search=truevaluerankings)Glama: https://glama.ai/mcp/servers/TrueValueRankings/tvr-mcp-server
PulseMCP: https://www.pulsemcp.com/servers/truevaluerankings
Links
Website: truevaluerankings.com
Developers and agents: truevaluerankings.com/developers
Contact: info@truevaluerankings.com
Disclaimer
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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Crypto MCP with 21 tools for market data, DeFi, analytics, and sentiment. Post-paid USDC billing.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
Crypto trading intelligence MCP — 34+ endpoints, x402 pay-per-use, AI agent strategy & execution
Memecoin Intelligence MCP — 9 tools: rug check, momentum, whale watch, 80+ chains.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceCrypto intelligence MCP: 104 tools for market data, ML signals, on-chain analytics, derivatives, and Bittensor subnets. Pay-per-call via x402 USDC on Base/Solana/Algorand/Stellar or $9.99/mo API key.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query cryptocurrency data including prices, market cap, rankings, categories, and global metrics from CoinMarketCap via MCP tools.147 npmMIT
- AlicenseAqualityDmaintenanceProvides cryptographically verifiable RWA trust attestations and multi-chain DeFi data (TVL, top protocols, positioning scorecards) via MCP tools for AI assistants.111MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access professional crypto market intelligence via 8 MCP tools, covering market regime, fear/greed, funding rates, DeFi yields, token signals, wallet risk, and contract audits. Backed by real-time data from Binance, DeFiLlama, Etherscan, with both free tools and x402 micropayment options.2-