UP RATE
73%
MCP-native · 25M+ indexed patterns
The archive of what happened next.
Anchor any chart. Get back the 500 historical days that look like it — split into outcome playbooks by what they actually did next. Empirical analogs, not predictions. The grounding layer for AI agents in markets.
25M+
indexed patterns
~9ms
retrieval (1-3s warm call)
80.8%
coverage record, held out
13
canonical MCP tools
$0
free tier
NVDA · 1h · anchored 2026-05-28live
Uptrend 28%Sharp choppy 10%Sideways 44%Downtrend 18%
Live example · NVDA · as of 2026-05-28
300 analogs from 10 years, split into 4 outcome paths.
Not a forecast. The empirical split of what historical analogs actually did over the next 5 trading days. Hover a mode to read its distribution.
Outcome moden5d medianup rate
Uptrendclean continuation84+5.2%73%
Sharp choppy uptrendvolatile, net up31+2.8%67%
Smooth sidewaysrange-bound drift132+1.1%62%
Downtrendfailed breakout53-2.1%43%
Forward-return distribution · 5d
Uptrend
IQR (25–75)
+1.8 / +8.9%
A new way to query markets
Pattern search has always been mathematical. We made it shape-based.
Old way · indicator search
Search by formulas someone wrote.
- Define a “rising wedge” with a math expression.
- Scan the universe for charts matching the rule.
- You query in indicator space — the same query for everyone.
- Limited to patterns someone bothered to formalize.
TradingView · ThinkOrSwim · Finviz · Trendspider
Chart Library · pattern search
Search by raw chart shape.
- Take an actual chart — a real stock on a real date.
- Get back the 500 historical days that look like it as raw shape.
- Cluster them into 3–4 outcome modes — what they actually did next.
- Each mode reports count, median return, up rate, and the IQR.
25M+ patterns · 19K symbols · 10 years
How a query flows
From anchor to actionable read in one MCP call.
01 / ANCHOR
Anchor
Your agent picks any (symbol, date, timeframe). NVDA · today · 1h — the chart you want to understand.
02 / MATCH
Match
The system finds the 500 historical days that look most like your subject as raw price + volume shape. No indicators. No formulas.
03 / STRATIFY
Stratify
Cluster the 500 analogs into 3–4 outcome modes by what they did next. Each reports count, median, up rate, and distinguishing features.
How the agent talks to you
We don’t script the agent. We hand it the comp set.
The MCP tool returns descriptive comp-set fields — comp strength, match quality, conditions, coverage record, and the drivers that separated past winners from losers. Your agent reads them and writes the answer in its own voice. Numbers stay in parentheses.
pull_comps returned · comp set summary
comp set
comp_strength=lowmatch_quality=looseconditions=normalcoverage=0.81
drivers
sector_laggingnarrative_passiveearnings_near
caveat_flags
soft_in_regime_sampleregime_was_derived
sample
quality=okn_in_regime=21n_total=132
CLagent reads the flags and writes in its own voice ↓
“Honestly, this one reads like a coin flip. NVDA’s in-regime analogs printed about the same as everything else — the comp set doesn’t separate up from down here.”
Of the 132 closest analogs, 21 printed under a regime like today’s. Their 5-day median was +0.09% with a 52% hit rate — small enough that the regime isn’t doing much work.
What I’d watch
- Sector lagging hard. XLK 60-day RS is −10.4 — skews tech reads lower until it turns.
- News without follow-through. Pulse +0.29 — looks like vol repricing, not a narrative change.
- Earnings in 16 sessions. Pattern reads weaken this close to the print.
POST /api/v1/pull_comps · NVDA · 2026-05-11 · 1h● ~9ms retrieval · 1-3s warm call · not financial advice
Every read is grounded in the 13 canonical tools your agent can also call directly: search pull_comps cohort_introspect cohort_members cohort_groupby cohort_rerank symbol_intelligence analyze context explain portfolio track_record report_feedback — pull_comps is the front-of-house comp-set primitive (cohort_analyze remains available with its original field names).
The coverage record · held-out, symbol-disjoint
80.8%
Our nominal 80% forward-return band held 80.8% across 302,880 audited cases (5-day horizon, no same-stock leakage). It is an audit of past predicted-vs-realized coverage, not a forward claim — and it is live: call /api/v1/calibration and check it yourself.
Separately, in a blind paired evaluation a judge — not told which agent held which tools — preferred the grounded reasoning on every scenario, across all six dimensions below. An agent given a research desk investigates more, so a gap is expected by construction; what the blind judge adds is that the grounded reasoning was preferred even when both agents reached the same conclusion.
Read the full methodology →For developers
Drop-in chart pattern intelligence for any AI agent.
MCP-native. Works with Claude Desktop, Cursor, Hermes Agent, or any MCP-capable client. Under a minute to install.
# Install$ pip install chartlibrary-mcp # Register with Hermes Agent$ hermes mcp add chartlibrary \ --command "chartlibrary-mcp" # Also works with Claude Desktop & Cursor✓ 9 tools registered · ready
Free
Generous limits for experimentation
$0
Builder
Real agent workloads · faster rate limits
$29/mo
Scale
Production deployments · priority support
$99/mo
Agent
Cohort session handles · decision_brief orchestrator
$299/mo
Read the API docs
13 canonical tools, calibration report, methodology
What’s next
The next ten years of markets × AI runs on grounded retrieval.
Every AI agent that talks about stocks today is making up cohort statistics. The interfaces got smarter; the grounding didn’t catch up. Chart Library is the layer.
Now
MCP-native retrieval
13 canonical tools. 25M+ patterns. Calibrated forward distributions, regime stratification, and Layer 5 memory that compounds with every query.
Soon
Live + multi-timeframe
Real-time intraday updates. One subject, simultaneous matches across 5min / 15min / 1h / 1d.
Next
Cross-asset
Crypto first — the active agent-trading market. Then futures, then international equities. Same architecture, broader universe.
Chart Library
Build an agent that knows what happened before.
Anchor a chart, pull its comp set, and let your agent reason from what the market actually did — not from what it imagined.