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

  1. Generate an API key on your API keys page. A free account works; it just sees shorter lists.
  2. Add the block below to your MCP client's config, with your key in place of the placeholder.
  3. 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.

ToolAnswers
market_stretchIs the market broadly extended or broadly depressed right now, and how does that reading rank against its own history?
deviation_rankingWhich symbols sit furthest below — or above — their own 200-day average?
recommended_patternsWhat did last night's scan flag, and has that pattern bucket historically beaten SPY?
ticker_reportEverything held on one symbol: current deviation plus recent pattern detections.
account_statusWhich 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