Skip to main content
Glama

mtgmon Mortgage Analytics

get_market_snapshot

Read-onlyIdempotent

Get current mortgage, TBA, Treasury, SOFR, and fitted MBS-basis observations.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNo
metaYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already cover safety and idempotency. Description adds value by specifying the types of observations retrieved, but doesn't mention any additional behavioral traits like freshness or pagination.

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?

Single sentence, no wasted words, front-loaded with the action and key nouns.

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?

Given zero parameters and presence of output schema, the description fully informs the agent about the tool's data scope without missing critical details.

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?

No parameters exist, so schema coverage is trivially 100%. Description does not need to provide parameter details; baseline 4 applies.

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?

Description uses specific verb 'Get' and clearly lists the financial data categories (mortgage, TBA, Treasury, SOFR, fitted MBS-basis). It distinguishes well from sibling tools which focus on lenders, loans, etc.

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?

No explicit when/when-not guidance, but the purpose is clear and the sibling tools have distinct domains, providing implicit context for when to use this tool.

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.

TDQS

B3.2/5.0
Disambiguation4/5

Most tools target clearly distinct data domains: lender search/profile/compare cluster around HMDA lender analytics, while market snapshot, loan performance, servicer analytics, and SEC filing tools are separate. The only minor ambiguity is between get_lender_profile, compare_lenders, and search_lenders which all deal with lender keys, though their intents (search vs. profile vs. comparison) are distinct.

Naming Consistency4/5

Tools follow a consistent get_/search_/compare_ verb pattern with clear noun targets (lenders, market_snapshot, loan_performance, sec_filing). The one deviation is that search_lenders, search_sec_filings, and compare_lenders use non-get verbs while the rest use get_, but this is a sensible pattern matching read vs. search semantics.

Tool Count5/5

At 9 tools, this is well within the ideal 3-15 range and each tool appears to represent a meaningful consumer capability for a mortgage analytics domain. The count feels appropriately scoped without redundancy or bloat.

Completeness3/5

The surface covers market data, SEC filings, lender profiles, loan performance, and servicer analytics, but there are notable gaps: there's no mutation capability (all read-oriented), no way to combine or join across these domains, and no search tool for loan performance or market data topics - those are limited to pre-bounded topics. Some domains feel like they have single query points rather than full browsing coverage.

Resources