Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LITVM_ORACLE_URLNoOverride the API base URLhttps://oracle.the-undesirables.com

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_cardsA

Search 433K+ trading card products by name using full-text search.

The catalog contains 433K products total — 276K are actively priced with current market data. ~157K are catalog-only entries (tokens, promos, bundles) with no price history. Disney Lorcana, Flesh & Blood, Dragon Ball Super, Digimon, Star Wars, Union Arena, MetaZoo, Cardfight Vanguard, and My Hero Academia.

Returns product IDs (needed for get_price and get_merkle_proof), card names, games, and current market prices.

get_priceA

Get the latest market price and historical price data for a trading card.

Provide either a card name (fuzzy search) or a TCGPlayer product ID. Returns current market price, low (buy-it-now) price, and daily price history for the requested time window.

The price history is what powers the Monte Carlo simulation — it's the same data used to calibrate drift and volatility parameters.

get_merkle_proofA

Get a Merkle proof for on-chain price verification on LitecoinVM.

WHY THIS MATTERS FOR AI AGENTS: Regular API prices require trusting the server. Merkle proofs let you VERIFY the price on-chain without trusting anyone. The proof is a cryptographic guarantee that this exact price was committed to the LitecoinVM blockchain by the oracle operator.

The TCG Price Oracle commits 276K actively-priced products to a single Merkle root on LiteForge daily. This tool returns the proof array that can be submitted to the MerklePriceOracle smart contract to trustlessly verify any card's price.

NOTE: Only actively-priced products (market_price > 0) are included in the Merkle tree. Zero-price catalog entries cannot be proven.

oracle_statusA

Get live status of the TCG Price Oracle on LitecoinVM.

Reads DIRECTLY from the LiteForge blockchain (Chain ID 4441) via the Caldera RPC endpoint — this is NOT cached data, it's a live on-chain read at the moment you call it.

Returns: • MerklePriceOracle: current root, total products, freshness, update count • TCGPriceOracleV2: total TWAP updates, last update timestamp • Network: connection status, chain ID, RPC URL, explorer link • Database: card count, price rows, latest data date (from API)

No arguments required.

get_forecastA

Get the calibrated conformal risk forecast for a trading card.

This is the recommended, honest default forecast — distribution-free, deterministic, and never-under-protective. Unlike a Monte Carlo simulation it makes NO distributional assumption: the bands are calibrated on real cross-card price history, so the stated risk is honest out-of-sample (a "5% VaR" means a ~5% loss happens about 5% of the time). Each card also gets two plain-English letter grades.

simulate_priceA

Run a Monte Carlo price simulation for a trading card (opt-in).

For the honest DEFAULT forecast — conformal VaR + Safe-Hold/Momentum grades — use get_forecast. This tool is the stochastic Monte Carlo alternative (Merton/GBM).

HOW THE MATH WORKS: This is NOT fake data. The simulation calibrates parameters from REAL market prices stored in the oracle database (12.7M+ price observations):

  1. Look up the card → get product_id via FTS5 search

  2. Pull up to 365 days of daily price history

  3. Resample to weekly buckets for stable drift estimates

  4. Compute annualized drift (μ) and volatility (σ)

  5. Detect price jumps via 2σ threshold on time-scaled returns

  6. Run 10,000+ vectorized numpy simulation paths

  7. Return percentile forecast bands + risk metrics

If insufficient price history exists (<5 data points), conservative TCG market priors are used (3% drift, 40% vol) and clearly labeled as "default_tcg_priors" in the response.

get_market_snapshotA

Get a market overview — top trading cards sorted by value.

Returns the highest-value cards for a specific game with current market prices and low (buy-it-now) prices.

Games: Pokemon, Magic, Yu-Gi-Oh, One Piece, Disney Lorcana, Flesh and Blood, Dragon Ball Super, Digimon, Star Wars, Union Arena, MetaZoo, Cardfight Vanguard, My Hero Academia.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sailorpepe/litvm-tcg-oracle-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server