litvm-onboard
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@litvm-onboardProve me a card price against the chain"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LitVM Agent Onboarding
Get an agent onto LitecoinVM — and show it something worth doing there.
https://onboard.the-undesirables.com/mcp
Real values, read from the chain at build time. Rebuild with python tools/build_hero.py.
Why this exists
LitVM documents how a person adds the network to a wallet and claims test tokens. Nothing tells an agent what the chain is, what runs on it, or what to do first.
This fills that gap, and it leads with the answer to why bother: there is a real price oracle deployed on LiteForge, and an agent can prove one of its prices against the chain in a single call, for free, in about a second.
Related MCP server: Trust Vault MCP Server
It cannot touch your wallet
All six tools are reads. This server holds no key, signs nothing, sends nothing, and there is no code path in it that could move an asset. Two tools accept an address so they can look up a public balance — the same thing any block explorer does — and that is the extent of it.
You do not need a wallet at all to use the part that matters.
What you can ask for
You say | The agent calls | What comes back | Wallet? |
"What is LitVM and how do I connect?" |
| Chain 4441, RPC, explorer, live block, gas token, wallet-config JSON | no |
"What's deployed on it?" |
| Nine contracts, each checked live for bytecode | no |
"Prove me a card price against the chain" |
| The proof, both roots side by side, and the contract's own | no |
"I want to build on the oracle" |
| Foundry / Hardhat / Remix config + a contract that reads the root | no |
"Am I set up to transact?" |
| Public balance and transaction count for an address you name | reads one |
"How do I get test tokens?" |
| The faucet link and the click path, for you to follow yourself | reads one |
The last two matter only if you want to write to the chain, which costs gas. Reading prices never does.
What that proof actually says
It proves the price was committed on-chain before you asked, so nobody changed it after the fact. It does not prove the price is right. One oracle publishes it.
The root in the picture above is a snapshot and it is stale by design. A new one is
committed to LiteForge every night, so the value changes daily. The durable claim is not
"the root is 0x44e1…" — it is that the oracle's root and the chain's root always
agree, and the contract will confirm it while you watch. Run litvm_verify_price() for
today's, or open the
live JSON
and compare it to
merkleRoot() on the explorer.
Every card comes back with its art and its own page, so an agent can show a person what it just verified instead of only telling them.
What a session looks like
Six questions, six tools, one connector and no keys. Every line is a live call against
onboard.the-undesirables.com. Regenerate it with vhs demo.tape; the script it records
is demo.py.
Three slash commands
Clients that support MCP prompts surface these as commands:
Command | Does |
| Proves one card's price and explains what the result does and does not mean |
| Walks you onto the chain using a wallet you already control |
| Sets up a project and a contract that reads the oracle root |
Every prompt tells the model not to ask you for a private key, not to offer to hold one, and not to generate a wallet for you.
The six tools
Tool | Does |
| Proof, leaf fields, both roots, and a live |
| Chain 4441 params, RPC and WebSocket, explorer, faucet, gas token, live block and gas price |
| Directory of live LiteForge contracts, each checked for deployed bytecode |
| Foundry / Hardhat / Remix config for chain 4441 plus a ten-line consumer contract |
| Public balance and transaction count, and what to do next |
| Faucet link, steps, and the rate-limit workaround. Cannot claim for you. |
Connect
One click: the VS Code and Cursor buttons above.
Claude Desktop / Perplexity: add a custom remote connector with the URL.
Cursor / Windsurf / VS Code, by hand:
{ "mcpServers": { "litvm-onboard": { "url": "https://onboard.the-undesirables.com/mcp" } } }Anything else that speaks MCP: point it at https://onboard.the-undesirables.com/mcp.
Streamable HTTP, no auth headers.
What it's built on
LiteForge: chain
4441, RPChttps://liteforge.rpc.caldera.xyz/http, explorer liteforge.explorer.caldera.xyz, faucet liteforge.hub.caldera.xyz, gas token zkLTC (docs.litvm.com).The oracle: oracle.the-undesirables.com.
/api/v1/merkle/proofreturns the proof and the five leaf fieldsverifyPrice()takes, with a self-check that they hash to the leaf behind today's on-chain root.MerklePriceOracle on LiteForge:
0x20A812309AD14aa39B59aE2791972dfe8dDDe80E— one of nine contracts this operator runs on the chain, all listed bylitvm_contracts.
Run it yourself
pip install fastmcp web3 eth-abi httpx
PORT=8413 python server.py # then point a client at http://127.0.0.1:8413/mcpOr docker build -t litvm-onboard . && docker run -p 8413:8413 litvm-onboard.
python audit.py <url> runs the full test suite against any instance.
Honest limits
Testnet only. zkLTC has no monetary value and nothing here is a guarantee about a future mainnet.
The faucet is browser-only. No API exists, so
litvm_fundreturns steps for a person to follow. It cannot claim on your behalf.Prices come from one oracle — this one. The proof shows the price was committed on-chain before you asked, not that it is the correct price.
Only actively-priced products are provable. Catalog entries with no market price today are not in the tree, and asking for one returns a clear error rather than a false negative.
Built by sailorpepe / The Undesirables LLC.
Related: litvm-tcg-oracle-mcp — 13 tools, the oracle through the LitVM lens · undesirables-mcp-server — the full 22-tool TCG Oracle.
This server cannot be installed
Maintenance
Related MCP Connectors
MCP tools: collectible price-fairness, recall safety, drop tracking, card grading, settlements.
Free read-only crypto whale-tracking & market-data MCP tools across 14 chains. No auth.
Read-only Bitcoin blockchain, mempool, mining, market, and on-chain analytics; no API key.
Read-only Solana and crypto reserve-recovery scans, pricing, chain facts, and methodology.
Related MCP Servers
- AlicenseAqualityBmaintenanceOn-chain TCG price oracle for the LitecoinVM ecosystem. 6 tools: search 433K+ trading cards, 60-day price history, Merkle proof verification on LiteForge (Chain 4441), Monte Carlo simulation, and AI card grading via Qwen 2.5 VL.7Business Source 1.1
- FlicenseNot gradedqualityBmaintenanceExposes 8 read-only Trust Vault tools over MCP (Streamable HTTP) for querying protocol overview, tokens, market rates, orders, platform stats, fees, and currencies. Enables on-chain reads and static config without wallet or signing.-
- AlicenseAqualityAmaintenanceProvides tools for verifying crypto price events and building permit intelligence, with free and paid tools using the x402 protocol.1135MIT
- FlicenseAqualityCmaintenanceProvides live and historical market data for Bitcoin and any Binance pair via two read-only tools: current price snapshot and historical OHLC candles.2-