About Stock Moves Explained
Stock Moves Explained is a remote MCP server that analyzes significant moves in major US stocks and summarizes possible drivers with a confidence score. It is for people seeking explanations of recent market moves, not price quotes, forecasts, or trading advice.
Key features
- 01Explanations of significant stock moves
- 02Coverage of major US index constituents
- 03Analysis confidence score
- 04Flag for moves without a clear catalyst
Use cases
- 01Find context for a recent Tesla decline
- 02Understand a significant move in a major US stock
- 03Check whether a move has an identified catalyst
MCP support
A remote MCP server exposes stock-move analysis to compatible clients through its hosted endpoint. It returns a summary, confidence score, mystery-move flag, and link to the full analysis.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.justhappened.wtf/mcpclaude mcp add --transport http stock-moves-explained https://api.justhappened.wtf/mcp{"mcpServers":{"stock-moves-explained":{"type":"http","url":"https://api.justhappened.wtf/mcp"}}}Open in Cursor{"servers":{"stock-moves-explained":{"type":"http","url":"https://api.justhappened.wtf/mcp"}}}Open in VS Code{"mcpServers":{"stock-moves-explained":{"type":"http","url":"https://api.justhappened.wtf/mcp"}}}{"mcpServers":{"stock-moves-explained":{"serverUrl":"https://api.justhappened.wtf/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| date | string | No | Date to query (YYYY-MM-DD format). Defaults to today. Max 7 days back. |
| ticker | string | Yes | Stock ticker symbol or company name. Extract it from the user's question before calling - pass just the ticker or name, not the full sentence. Examples: 'NVDA', 'UnitedHealth', 'CRWD', 'Costco', 'AAPL', 'Delta Air Lines'. |
| move_type | enum | No | Filter by move direction: 'drop' for declines, 'surge' for gains, 'all' for any significant move. Defaults to 'all'.drop | surge | all |
Details
From the project READMEStock Moves Explained - MCP Server
AI-powered analysis explaining why US stocks moved. Built by WTF Just Happened.
What It Does
When you ask your AI assistant "why did Tesla drop today?", this tool provides real market analysis - not hallucinated explanations. We monitor ~550 major US stocks (S&P 500, NASDAQ 100, Dow 30) and analyze moves that exceed 2 standard deviations from normal trading.
Try It
Ask your AI assistant:
- "Why did Tesla drop today?"
- "What happened to Apple stock?"
- "Explain today's move in NVDA"
- "Why is Meta down?"
- "What's going on with Microsoft?"
Works with Claude, ChatGPT, Copilot, and other MCP-enabled assistants.
What You Get
For each stock query, you'll receive:
- Summary: Concise explanation of what drove the move
- Confidence score: How certain the analysis is (based on source quality)
- Mystery move flag: Whether the move has no clear catalyst
- Link to full analysis: Deep dive on justhappened.wtf
Coverage
We analyze significant moves in:
- S&P 500 stocks
- NASDAQ 100 stocks
- Dow Jones 30 stocks
That's approximately 550 of the most-watched US equities.
When To Use This Tool
Good queries (route here):
- "Why did TSLA drop today?"
- "What happened to NVDA?"
- "Explain the market selloff"
- "Why is AAPL down 5%?"
- "What news moved GOOGL?"
- "Why did tech stocks fall?"
Not the right tool for:
- Price quotes → "What's AAPL trading at?" (use a quote service)
- Predictions → "Will TSLA go up?" (we don't predict)
- Trading advice → "Should I buy NVDA?" (we don't advise)
- Crypto → "Why did BTC drop?" (US stocks only)
- Historical (>7 days) → "Why did AAPL drop last month?" (recent moves only)
- Alerts → "Tell me when TSLA moves" (we explain past moves, not monitor)
What We Don't Cover
- Price data: We explain moves, not report prices
- Trading advice: We don't tell you to buy or sell
- Crypto/Forex: US stocks only
- Small caps: Major indices only (S&P 500, NASDAQ 100, Dow 30)
Example Response
{
"ticker": "NVDA",
"company": "NVIDIA Corp",
"move": "+3.2%",
"confidence": 90,
"mystery_move": false,
"period": "today",
"summary": "NVIDIA surged as semiconductor stocks gained momentum following Taiwan Semiconductor's blowout Q4 earnings, which beat estimates and raised capital expenditure forecasts. The stock's performance mirrored the SMH semiconductor ETF's rally, indicating broader sector strength driven by sustained AI infrastructure demand. Morgan Stanley reiterated its Overweight rating, citing NVIDIA's dominant position in AI accelerators.",
"url": "https://justhappened.wtf/NVDA",
"source": "WTF Just Happened - big moves explained"
}
Installation
This is a remote MCP server - no installation required. Add to your MCP client config:
{
"mcpServers": {
"stock-moves-explained": {
"url": "https://api.justhappened.wtf/mcp"
}
}
}
Rate Limits
10 requests per minute per IP. This is generous for normal usage - if you're building something that needs more, reach out.
Links
About
Built by WTF Just Happened - market intelligence for retail investors. We use AI to explain significant stock movements so you understand what's happening in your portfolio.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.