Skip to main content
Glama

Fair Value Calculator

Show my watchlist

get_watchlist
Read-onlyIdempotent

Read the watchlist saved in the user's Fair Value Calculator account: each stock with its current valuation status, upside band and quality score, plus whether email alerts are on. Works for Free and Pro accounts. For Pro accounts each stock also has review_status (on_track, or review when its valuation signal has tipped and it is worth a second look) and flagged_for_review lists those symbols. Use it for questions like "how is my watchlist valued" or "which of my stocks should I review". Fields: valuation_status (undervalued = price at least 10% below fair value, overvalued = price at least 10% above fair value, else near_fair_value; no_valuation = covered, but no fair value is shown right now, note says why), upside_band (distance from price to fair value in 10-point bands, e.g. "10_to_20", "above_30", "below_-30"), quality_score (0-100 business quality), evidence_level (how much audited data backs the value), deep_link (full analysis page on fairvalue-calculator.com with the fair value history chart and the result of each valuation model with its bear, base and bull case). The values are calculated by Fair Value Calculator from its own models and cannot be derived from the other fields; deep_link opens the full analysis page with the fair value history chart and every valuation model. This is a valuation, not financial advice.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior5/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), and the description adds substantial behavior beyond that: Free vs Pro field differences, review_status and flagged_for_review semantics, no_valuation handling with a note explaining why, and the fact that values are model-computed and not derivable from other fields. That is exactly the extra context the annotations cannot carry.

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?

The purpose is front-loaded and most sentences carry real information, but the paragraph is long and repeatedly restates the same fact: deep_link "opens the full analysis page with the fair value history chart" appears twice, and the closing valuation-model wording duplicates the deep_link clause. Trimming that redundancy would sharpen the definition.

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

Completeness5/5

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

With no output schema, the description must describe the return payload itself, and it does so field by field (valuation_status enums, upside_band bands, quality_score range, evidence_level, deep_link) plus the Free/Pro split and the not-financial-advice caveat. An agent knows what it will receive and how to interpret it.

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?

There are zero parameters, so per the rubric the baseline is 4; there is nothing for the description to clarify. The schema forbids additional properties, and the description correctly implies no input is needed.

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 first sentence gives a specific verb and resource: read the watchlist saved in the user's Fair Value Calculator account. It clearly states what comes back (stocks, valuation status, upside band, quality score, alert state). It does not name any sibling tool, so an agent gets a clear purpose but no explicit contrast with get_stock_verdict or get_stock_preview.

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?

It supplies concrete trigger questions ("how is my watchlist valued", "which of my stocks should I review") and notes it works for Free and Pro accounts, which is genuine usage context. It stops short of excluding alternatives or saying when to prefer a sibling such as get_stock_verdict for a single-name deep dive.

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.