Skip to main content
Glama

Server Details

Explains why stocks moved. 'Why did Tesla drop?' 'What happened to NVDA?' S&P 500/NASDAQ/Dow.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
justhappened-corp/stock-moves-explained
GitHub Stars
1
Server Listing
stock-moves-explained

Available Tools

1 tool
stock-moves-explainedA
Read-onlyIdempotent
Inspect

Explains why a stock had a significant price move today. Provides AI-written analysis citing news catalysts, earnings reports, and analyst actions. Covers 550+ stocks across S&P 500, NASDAQ 100, and Dow 30. Pass any stock ticker or company name as the ticker parameter. NOT for: price quotes, trading advice, predictions, crypto, or forex. If you cannot make POST requests, visit https://justhappened.wtf/api-help for alternative access methods.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoDate to query (YYYY-MM-DD format). Defaults to today. Max 7 days back.
tickerYesStock 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_typeNoFilter by move direction: 'drop' for declines, 'surge' for gains, 'all' for any significant move. Defaults to 'all'.

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds valuable behavioral context: output is AI-written analysis, coverage is 550+ stocks across major indices, and it explicitly excludes predictions and other financial services. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded. The first sentence states the core purpose, followed by one sentence on output characteristics, one on coverage, and one on exclusions/alternatives. Every sentence earns its place with no redundancy or fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only tool with annotations and full schema coverage, the description sufficiently covers purpose, scope, exclusions, and even an access fallback. It lacks details about return format or what counts as 'significant,' but no output schema exists and these are not critical for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of parameters with detailed descriptions, including examples for ticker and format for date. The description reinforces 'Pass any stock ticker or company name as the ticker parameter' but adds no new semantic information beyond what the schema already provides. Baseline of 3 applies due to full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Explains why a stock had a significant price move today.' It further clarifies the output type (AI-written analysis citing news catalysts, earnings reports, and analyst actions) and coverage (S&P 500, NASDAQ 100, Dow 30), making the tool's purpose unmistakable and distinct from generic quote or prediction tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear exclusions: 'NOT for: price quotes, trading advice, predictions, crypto, or forex.' It also mentions an alternative access method when POST requests are unavailable. However, it does not name alternative tools to use instead, though the sibling list is empty, so this is a minor gap.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool update
    • Changedstock-moves-explained1 field changed
      • changedInput schema / properties / ticker / description
        Previous value: -"The stock ticker symbol or company name to look up. Extract the ticker or company name from the user's question before calling. Examples: 'TSLA', 'Tesla', 'AAPL', 'Apple', 'GOOGL', 'Google'. Do NOT pass full sentences like 'why did Tesla drop' - just pass 'Tesla' or 'TSLA'."New value: +"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'."
  2. 1 tool update
    • Changedstock-moves-explained1 field changed
      • changedInput schema / properties / ticker / description
        Previous value: -"Stock ticker symbol (e.g., 'TSLA') or company name (e.g., 'Tesla', 'tesla'). Supports common aliases like 'Google' for GOOGL, 'Facebook' for META."New value: +"The stock ticker symbol or company name to look up. Extract the ticker or company name from the user's question before calling. Examples: 'TSLA', 'Tesla', 'AAPL', 'Apple', 'GOOGL', 'Google'. Do NOT pass full sentences like 'why did Tesla drop' - just pass 'Tesla' or 'TSLA'."
  3. 1 tool update
    • First observedstock-moves-explained

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Real-time financial narrative tracking for AI agents — clustering news into structured narratives, measuring sentiment momentum, and mapping portfolio risk across 109 US equities.
    2
    2
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Real-time financial news for AI agents and trading bots — AI-enriched stories with per-ticker analysis, a 1–10 relevance score, SEC Form-4 insider transactions, plus trending and "actionable-now" feeds. Free tier, OAuth, no API key to paste.
    11
    2
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.4/5.0
Disambiguation5/5

Only one tool exists, so there is no possibility of confusion or overlap. The tool's purpose is clearly defined in its description.

Naming Consistency5/5

The single tool name matches the server name exactly, and there are no competing naming conventions to violate consistency.

Tool Count5/5

The server has a very narrow, single-purpose domain—explaining stock moves—and one focused tool fully satisfies that purpose. Additional tools would be unnecessary clutter.

Completeness5/5

The tool covers the entire stated purpose: it explains price moves with news, earnings, and analyst citations for a wide range of stocks. It explicitly disclaims out-of-scope functionality, so there are no obvious gaps within its intended domain.