Telumin Documentation
Technical documentation for the Telumin platform — how the threat engine works, how signals map to your holdings, and how to connect Claude via MCP.
What is Telumin?
Telumin is an early-warning system for your portfolio — a threat engine that watches your holdings continuously, matches evidenced signals to them with dollar exposure and explicit time horizons, and enforces the discipline of a written thesis with break-conditions.
Unlike a news feed that gives you noise, Telumin gives you a signal with evidence, matched to a position you actually hold. It never trades for you. Your broker never sees it.
What Telumin is not
Telumin does not pick stocks, does not compute a fair value, and does not tell you what to buy. That is deliberate: valuation answers “what is this business worth?” and belongs before you buy. Telumin answers a different question, continuously, after you own it: are the reasons I hold this still true?
The two are complements, not competitors. A DCF (or multiples, or whatever model you trust) helps you enter with a margin of safety. Telumin helps you stay in — or get out — based on whether the thesis behind the position is still standing.
The full argument — thesis-driven investing, the six pillars, and a fill-in template that wires kill criteria into a DCF as sensitivity cases — is in the Method section.
| Aspect | Valuation (DCF, multiples) | Telumin |
|---|---|---|
| Core question | What is this business worth today? | Are the reasons I own it still valid? |
| When it runs | Before you buy; periodic re-valuation | Continuously, once you hold the position |
| Inputs | Cash-flow forecasts, margins, WACC, terminal value | Your written reasons and their break-conditions |
| Output | Intrinsic value and margin of safety | Evidenced alerts with dollar exposure and a decision window |
| Values stocks? | Yes — that is its purpose | No — by design |
Is Telumin for you?
It earns its place if…
- ✓ You do your own research and valuation
- ✓ You hold individual positions for months or years
- ✓ You want systematic early warnings, not more headlines
- ✓ You can write down why you own something, and what would prove you wrong
Skip it if…
- × You want to be told what to buy, or a fair-value number
- × You mainly hold index funds or ETFs and never revisit them
- × A simple price alert is all you need
Either way the workbook is free forever — start there and let the alerts prove themselves before you pay.
Watching, not willpower
- Refresh the news app, hope you act in time
- Sold the winner on panic; held the loser on hope
- “I bought it because I had a feeling”
- That SEC filing was material and you missed it
- Threat engine scans continuously; alerts when your positions are touched
- Thesis drift sweep fires when the reason you bought starts to break
- Investment Diary holds your thesis with break-conditions on file
- Every signal ships with evidence: source, timestamp, excerpt
How a threat gets to you
Trigger fires
A typed trigger (8-K item code, margin threshold, drawdown %, keyword) matches incoming data and opens an investigation
Three roles debate
An Advocate argues the threat is real, a Skeptic attacks it, an Adjudicator rules — only material signals clear the bar
Ships with evidence
The signal ships to your dashboard with sources, timestamps, and excerpts — matched to your holdings in dollars
Popular Guides
Portfolio Guardian Setup
Run drift-aware rebalancing and trailing stops on your live portfolio
Your First Watchlist
Define a thesis, attach guardrails, and let the pipeline do the work
Earnings & Thesis Drift Alerts
Auto-summarized earnings calls and Day-1 condition tracking
Pricing & Credits
Free workbook, Telumin Plus $39/mo, and credit packs for compute-heavy research
Key Concepts
Signals
Pipeline outputs: a (ticker, direction, confidence) tuple with quant context and an evidence chain. Drive watchlists, alerts, and thesis-guard workflows.
2-Source Rule
The SkepticValidator vetoes any signal that cannot be backed by 2+ independent source confirmations. Hard rule, no overrides.
Watchlist + Thesis
Every position you care about lives on a watchlist with a written thesis, Day-1 conditions, and a stop policy. The system enforces all three.
Backtest Lab
Run any signal strategy against historical data to validate a thesis before committing to it.
Evidence Vault
Immutable record of every signal, source citation, and alert. Exportable to your SIEM or compliance file.
Investment Diary
Required before the protect loop arms. Write your thesis, exit trigger, and position rationale — the engine watches them continuously.
Ready to start?
Open the Quickstart to add your holdings and activate the protect loop. Your broker never sees it.