Skip to main content
Glama

StockMap

Last night

last_night
Read-onlyIdempotent

What changed in StockMap's calls last night: how many stocks' calls changed band on the market map and the biggest of them, the calls graded last night (made 14 days earlier) with one line on why each was right or wrong, and when the next run starts. Show the not-advice line and the run date with the answer.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
runYesThe run the night is from: the day it ran and the close it called from
gradedNoThe calls graded last night
gradesYes
changesYesThe biggest of them by market cap
not_adviceNoThe model's track-recorded read, not financial advice.
record_urlNohttps://stockmap.io/track-record
calls_issuedNoCalls the run made
more_changesYesThe changes not listed; all of them are on /what-changed
next_run_utcNoWhen the next run starts
run_in_flightYesTrue: tonight's run has not landed yet, so this is the previous night (B2's name for run.not_landed)
changed_on_mapNoStocks whose call changed band on the map
all_changes_urlNohttps://stockmap.io/what-changed

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive, closed-world), so the description is free to add real context: the grading lookback (calls made 14 days earlier), the inclusion of the next run start time, and the mandatory not-advice line and run date. That is meaningful behavioral disclosure beyond structured fields, with no contradictions.

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

Conciseness3/5

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

It is front-loaded with the purpose, but the whole definition is a single run-on sentence packing four distinct output elements plus a trailing formatting instruction ('Show the not-advice line and the run date with the answer'). Every clause carries content, yet the lack of structure makes it harder to scan than a short bulleted enumeration would be.

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?

With an output schema present and annotations covering safety, the description's job is to set expectations about content and it does so thoroughly, including report timing. Only the relationship to sibling tools is left unaddressed.

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

Parameters4/5

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

The tool takes zero parameters, so the baseline is 4; there is nothing for the description to disambiguate. It correctly avoids wasting words on nonexistent inputs.

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

Purpose4/5

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

The description enumerates the concrete content of the report (band changes on the market map, the biggest movers, calls graded last night, next run start), so an agent can tell it produces a daily recap rather than a lookup. However, it never names or contrasts the neighbouring tools it overlaps with conceptually (market_map, stock_call), leaving the boundary to be inferred.

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

Usage Guidelines3/5

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

Usage is only implied by the temporal framing ('what changed ... last night'), which suggests a once-a-day recap. There is no explicit when-to-use, when-not-to-use, or alternative named, and no statement such as 'use market_map for current bands' to route the agent.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources