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/mcp
• Transport: Streamable HTTP (JSON-RPC 2.0 over POST)
• Authentication: none. The free tools need no key or account; the paid tools are bought one call at a time (see below).
• MCP Registry name: com.truevaluerankings/tvr-mcp
• Setup guide for developers and agents: truevaluerankings.com/developers
• Agent skill: skills/true-value-rankings/SKILL.md tells a coding agent which tool answers which question, and how paying works.

Claude (web and desktop app): Customize, then Connectors, then Add, then Add custom connector. Name: True Value Rankings. URL: https://truevaluerankings.com/mcp. Authentication: No sign in.

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"
    }
  }
}

Free tools (7)

Free answers from compare_coins, get_top_ranked and get_full_breakdown carry a paid_option field that names the paid call going further, with its price.

Paid tools (3), one call at a time

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.

Personal agent keys for Premium subscribers are not being issued at the moment; the paid tools are sold one call at a time, and nothing is charged until a payment is presented.

Paid bodies contain TVR model outputs only (scores, ranks, valuations, gaps); raw prices and market caps are never resold.

The 8 metrics

1. Economic Model: supply cap, inflation, distribution, sustainability
2. Network Security and Reliability: consensus robustness, decentralization, resilience
3. Adoption and Network Effects: transaction activity, merchant and institutional use, ecosystem
4. Privacy and Fungibility: default privacy, fungibility
5. Longevity (Lindy Effect): operating history
6. Market Liquidity: volume, exchange availability, market depth
7. Legal Clarity and Institutional Adoption: regulatory status, global stance
8. 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

• mcp.json
• agent-card.json
• openapi.json
• x402.json (paid resources and prices, built from the live routes)
• deal-policy.json (data licence)
• llms.txt and llms-full.txt

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.

The Developer plan (a commercial licence) is described at https://truevaluerankings.com/developers.html#developer-plan.

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)
• Smithery: https://smithery.ai/servers/info-rpjo/tvr-mcp
• 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.