Pattern Vista MCP Server
Daily US equity technical data as tools your AI agent can call.
Everything this site publishes — MA200 deviation rankings, market breadth, and the chart patterns from each night's scan with their historical win-rate against SPY — reachable over the Model Context Protocol. Works with Claude Desktop, Claude Code, Cursor, and anything else that speaks MCP over stdio.
Set it up
- Generate an API key on your API keys page. A free account works; it just sees shorter lists.
- Add the block below to your MCP client's config, with your key in place of the placeholder.
- Restart the client. The five tools appear automatically — nothing to install if you have uv.
{
"mcpServers": {
"pattern-vista": {
"command": "uvx",
"args": ["--from", "pattern-vista[mcp]", "pattern-vista-mcp"],
"env": { "PATTERN_VISTA_API_KEY": "pv_live_xxxxxxxx" }
}
}
}Prefer a real install? pip install 'pattern-vista[mcp]', then set "command" to pattern-vista-mcp and drop the "args" line. The same package also gives you the pv command-line tool.
The tools
Each returns plain JSON, and each carries its own coverage and caveats in its description so an agent reads them before it reports a number.
| Tool | Answers |
|---|---|
| market_stretch | Is the market broadly extended or broadly depressed right now, and how does that reading rank against its own history? |
| deviation_ranking | Which symbols sit furthest below — or above — their own 200-day average? |
| recommended_patterns | What did last night's scan flag, and has that pattern bucket historically beaten SPY? |
| ticker_report | Everything held on one symbol: current deviation plus recent pattern detections. |
| account_status | Which account is this key, and is it on a paid tier? |
Free and paid
Tiering is enforced server-side from the key, never by the client. A free key receives the top 2 rows of each ranking and a null win-rate; a paid one receives up to 100 rows and the full hist_win_w20. Every response carries is_billed, so an agent can tell a truncated list from a quiet market instead of guessing.
Market breadth is the exception: it is not gated at all. It is a single aggregate number that the public page gives away in full, so walling it here would only make the agent channel worse than a browser.
Common questions
- Is the data real-time?
- No. Everything is end-of-day, refreshed once per trading day after the close from the same nightly scan that feeds the website. Every response carries the snapshot date it came from — that date, not the time of the call, is what the numbers describe.
- What is covered?
- The S&P 500, the Nasdaq 100 and major US ETFs — roughly 500 to 800 symbols. A symbol outside that universe returns a null deviation rather than an error, which means "not covered" rather than "no reading".
- Can an agent act on the pattern signals?
- It should report them, not trade on them. The hist_win_w20 figure is the aggregate record of a pattern bucket against SPY, not a probability for the individual signal, and several bullish buckets sit below 50% — meaning they have historically done worse than simply holding the index. The tool descriptions say so, so a well-behaved agent will pass that caveat along.
Related
Pattern Vista is a technical-analysis research tool. Everything on this page is automated pattern detection and historical statistics published for educational purposes. It is not investment advice, not a recommendation to buy or sell any security, and past performance does not indicate future results. Full disclaimer