Skip to main content
Glama

mtgmon Mortgage Analytics

Server Details

Read-only U.S. mortgage market, lender, GSE performance, and servicing analytics.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsC

Average 3.2/5 across 9 of 9 tools scored. Lowest: 2.4/5.

Server CoherenceA
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.

Available Tools

9 tools
compare_lendersC
Read-onlyIdempotent
Inspect

Compare two canonical HMDA lender keys returned by search_lenders.

ParametersJSON Schema
NameRequiredDescriptionDefault
top_nNo
lender_aYes
lender_bYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior2/5

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

Annotations already declare the tool as read-only, idempotent, and non-destructive. The description adds no further behavioral context, such as what 'compare' means or what aspects are compared.

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 description is very concise (single sentence) but lacks structure and additional detail. It is efficient but under-specified for a tool with 3 parameters.

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

Completeness2/5

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

Despite having an output schema and annotations, the description does not explain what the comparison entails (e.g., differences, similarities, metrics). The tool's purpose is clear, but the missing behavioral and parameter context leaves the agent underinformed.

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

Parameters1/5

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

Schema description coverage is 0%, and the description fails to explain any parameters, including the optional 'top_n' which controls result count. The description does not compensate for the missing schema details.

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 clearly states the verb 'compare' and the resource 'canonical HMDA lender keys', and references the sibling tool 'search_lenders', distinguishing it from other tools.

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?

The description implies usage after search_lenders, but does not explicitly state when to use this tool versus alternatives like get_lender_profile or get_market_snapshot.

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

get_dataset_statusA
Read-onlyIdempotent
Inspect

Get mtgmon dataset coverage, freshness, build, and cache status.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior4/5

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

Annotations already indicate readOnly/idempotent/openWorld hints. Description adds value by detailing the returned status components (coverage, freshness, build, cache). 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?

Single sentence that efficiently conveys purpose and scope. No wasted words, front-loaded with action.

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 parameterless tool with output schema, the description provides the key return categories. Annotations cover safety. Could add mention of current state or system context, but sufficient for a status tool.

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 (empty schema, 100% coverage). Description correctly omits parameter info. Baseline of 4 applies per rules for zero parameters.

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 clearly states the tool retrieves mtgmon dataset status, specifying coverage, freshness, build, and cache. Verb 'Get' and resource 'mtgmon dataset' are specific. Sibling tools focus on lenders, loans, etc., making this distinct.

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?

No explicit when-to-use or when-not-to-use guidance. Usage is implied by sibling tool names (compare_lenders, etc.), but no direct alternatives or exclusions are provided.

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

get_lender_profileA
Read-onlyIdempotent
Inspect

Get a bounded HMDA profile for one canonical lender key returned by search_lenders.

ParametersJSON Schema
NameRequiredDescriptionDefault
top_nNo
lenderYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, so the description adds limited behavioral context. The term 'bounded' hints at limited data but is not elaborated. 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?

Single sentence that is both concise and front-loaded with the key information. No unnecessary words, and every word adds value.

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

Completeness3/5

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

There is an output schema, so return values are covered. However, the description fails to mention the top_n parameter and does not clarify what 'bounded' means in terms of HMDA profile data. For a simple tool, it is adequate but not fully complete.

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

Parameters2/5

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

Schema description coverage is 0%, and the description does not explain the top_n parameter or its purpose. The lender parameter is self-explanatory, but the lack of explanation for top_n (defaults, maximum, effect) leaves the agent with incomplete information.

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?

Clearly states the verb 'Get', the resource 'bounded HMDA profile', and specifies it's for one canonical lender key returned by search_lenders, distinguishing it from sibling tools like search_lenders (which returns multiple lenders) and compare_lenders.

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?

Directly tells the agent to use this tool after search_lenders to get a profile for a specific lender key. While it doesn't explicitly state when not to use, the context is clear, and the mention of 'bounded' implies limitations. No alternatives are listed, but the guidance is sufficient.

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

get_loan_performanceC
Read-onlyIdempotent
Inspect

Get bounded GSE loan-performance analytics for one clearly defined topic.

ParametersJSON Schema
NameRequiredDescriptionDefault
gseNoall
top_nNo
topicYes
to_dateNo
from_dateNo
max_pointsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations already declare readOnlyHint=true and idempotentHint=true, so the safety profile is clear. The description adds 'bounded', hinting at output limits or scoping, but does not detail rate limits, pagination, or other behavioral traits beyond what annotations provide.

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 single-sentence description is concise but overly brief. It front-loads the core purpose but sacrifices important details, making it efficient yet insufficient for a tool with six parameters.

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

Completeness2/5

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

Given the tool's complexity (6 parameters, enums, date ranges), the description is incomplete. It does not explain 'bounded', how topics map to analytics, date usage, or the meaning of top_n and max_points. The presence of an output schema mitigates return value documentation, but parameter usage remains underdescribed.

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

Parameters2/5

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

Schema description coverage is 0%, and the description does not explain any parameter beyond implying topic selection. Critical parameters like gse, top_n, dates, and max_points have no semantic guidance, forcing the agent to rely on enum names and defaults.

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 clearly states the purpose: retrieving 'GSE loan-performance analytics' with qualifiers 'bounded' and 'one clearly defined topic', which distinguishes it from broader sibling tools like get_market_snapshot or get_servicer_analytics, though it does not explicitly name alternatives.

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

Usage Guidelines2/5

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

No explicit guidance on when to use this tool versus siblings. The description does not mention conditions for use, prerequisites, or exclusions, leaving the agent to infer from the tool name and sibling list.

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

get_market_snapshotA
Read-onlyIdempotent
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
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.

get_sec_filingC
Read-onlyIdempotent
Inspect

Get one SEC filing, its entity roles, summary, and extracted facts.

ParametersJSON Schema
NameRequiredDescriptionDefault
filing_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false, and openWorldHint=true, covering the safety and state profile. The description itself adds the behavioral detail that it returns 'entity roles, summary, and extracted facts,' which is useful context about the returned payload. However, no mention of what happens if the filing_id doesn't exist, or any auth/limits. With rich annotations carrying the safety burden, a 3 is fair.

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

Conciseness4/5

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

One clear, single sentence that is front-loaded with the core action. No filler or redundancy. It earns its compactness despite the single-parameter tool not needing much elaboration.

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

Completeness3/5

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

An output schema exists, so return values are documented there. The tool is simple (1 param), has strong annotations, and an output schema. Given the simplicity, the description is reasonably complete, but it could benefit from noting that filing_id comes from search_sec_filings. Since output schema covers the response structure, this is adequate but not exceptional.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate for the filing_id parameter. The description mentions 'SEC filing' but doesn't explain what filing_id is, its format, or how to obtain a valid one (e.g., from search_sec_filings output). The schema only gives max/min length constraints (1-96 chars). The description adds essentially no parametric meaning beyond what the schema field name implies.

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

Purpose3/5

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

The description says 'Get one SEC filing, its entity roles, summary, and extracted facts.' This uses a specific verb (get) and names the resource (SEC filing) plus what's returned (entity roles, summary, extracted facts). However, it doesn't distinguish from sibling get_* tools like get_dataset_status or get_market_snapshot, which could be confused. The 'one' hints at singular result but lacks scope context.

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

Usage Guidelines2/5

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

No explicit when-to-use or when-not-to-use guidance is given. The sibling search_sec_filings clearly exists for discovery; this tool is likely for retrieval after a search returns a filing_id, but that connection is never stated. No alternatives are mentioned. The single-parameter signature implies you'd already know the filing_id, but the description doesn't explain that prerequisite.

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

get_servicer_analyticsC
Read-onlyIdempotent
Inspect

Get a servicer scorecard, vintage performance fan, or lender transfer analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
gseNoall
modeYes
top_nNo
lenderNo
vintageNo
max_pointsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations provide readOnlyHint, idempotentHint, and destructiveHint, fully covering safety. The description adds no additional behavioral traits (e.g., pagination, data sources), so it meets the baseline for annotation-rich tools without extra value.

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

Conciseness4/5

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

Single sentence is concise and front-loaded. However, it omits important details; conciseness should not sacrifice completeness.

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

Completeness2/5

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

With 6 parameters and an output schema, the description is too minimal. It fails to describe each mode's output or parameter effects, making it incomplete for effective tool use.

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

Parameters2/5

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

Schema description coverage is 0%, but the description only implicitly connects mode to outputs. It does not explain parameters like gse, top_n, lender, vintage, or max_points, leaving their semantics unclear.

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?

Description clearly states the tool gets three types of servicer analytics (scorecard, performance fan, transfer analysis) aligning with the mode parameter. It is specific about the resources but does not elaborate on each mode's output, preventing a 5.

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

Usage Guidelines2/5

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

No guidance on when to use this tool versus siblings like compare_lenders or get_lender_profile. The description lacks context for tool selection, leaving the agent to infer from tool names alone.

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

search_lendersC
Read-onlyIdempotent
Inspect

Find canonical HMDA lender keys, optionally filtered by charter, state, or volume.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNovolume_desc
limitNo
queryNo
stateNo
charterNo
min_volumeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint, so the safety and idempotency profile is clear. The description adds that the tool finds keys with optional filters, but does not disclose other behaviors like result limits or sorting behavior beyond what the schema implies.

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

Conciseness4/5

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

The description is a single 12-word sentence, extremely concise and front-loaded. However, for a tool with 6 parameters and a nondeterministic search behavior, it sacrifices completeness for brevity.

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

Completeness2/5

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

Given the tool's complexity (6 parameters, search semantics, output schema exists but is not detailed), the description is insufficient. It does not explain what 'canonical HMDA lender keys' means, how filtering interacts, or how to interpret results, relying too heavily on the schema.

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

Parameters2/5

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

The schema has 6 parameters with 0% description coverage; the description mentions only three filters (charter, state, volume) via 'optionally filtered by charter, state, or volume'. It fails to explain 'sort', 'limit', 'query', or how 'min_volume' relates to volume, leaving significant gaps.

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 uses a specific verb 'Find' and identifies the resource as 'canonical HMDA lender keys', making the tool's purpose clear. However, it does not distinguish this tool from siblings like 'compare_lenders' or 'get_lender_profile', which also operate on lenders.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives such as 'get_lender_profile' or 'compare_lenders'. It neither states prerequisites nor gives examples of appropriate contexts, leaving the agent without decision-making support.

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

search_sec_filingsC
Read-onlyIdempotent
Inspect

Search newest-first SEC filings after terminal summary processing.

ParametersJSON Schema
NameRequiredDescriptionDefault
cikNo
formNo
limitNo
queryNo
cursorNo
tickerNo
to_dateNo
from_dateNo
summary_statusNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
metaYes
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, covering the safety profile. The description adds the 'newest-first' ordering and 'after terminal summary processing' sequencing context, which is beyond the annotations. However, it does not disclose pagination semantics (cursor), date-range behavior, or what summary_status values do. With four strong annotations present, credit is given for the ordering/sequencing context, but it is thin.

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 description is very short (one clause), which is concise, but it packs in a confusing phrase ('after terminal summary processing') without explanation. It is under-specified more than efficiently concise — a single sentence that burdens the reader to decipher ambiguous terminology.

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

Completeness2/5

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

This is a moderately complex search tool with 9 parameters, an output schema, and a summary_status filter. The description doesn't explain the filter semantics, pagination via cursor, or the relationship to get_sec_filing. Even with the output schema present, critical usage semantics (which statuses exist, how filtering works) are unexplained.

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

Parameters1/5

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

Schema description coverage is 0%, and the description adds zero parameter-level meaning. With 9 parameters, including a summary_status enum, a cursor for pagination, date ranges, and search fields, the description explains none of them. The baseline would be 3 if coverage were high, but with 0% coverage the description must compensate and does not at all.

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

Purpose3/5

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

The description states 'Search newest-first SEC filings after terminal summary processing,' which names the resource (SEC filings) and the ordering (newest-first) with a specific action verb. However, it does not distinguish from sibling get_sec_filing, which retrieves filings, and the phrase 'after terminal summary processing' is ambiguous without context.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus get_sec_filing or search_lenders among siblings. It implies search use-case (query-based discovery) but gives no exclusions or alternatives. The 'after terminal summary processing' clue hints at a workflow context but is too vague to be actionable.

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

Discussions

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

Related MCP Servers

  • A
    license
    -
    quality
    C
    maintenance
    Hosted, read-only MCP server for US market intelligence: US market mood, per-stock sentiment and the SentiSense Score, sentiment-tagged market-moving news, analyst ratings, and institutional 13F flows.
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    Hosted MCP server providing read-only access to US public company fundamentals, segment breakdowns, peer comparisons, and earnings data sourced directly from SEC filings.
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Provides read-only MCP tools for market snapshots, position risk, order reconciliation, and daily report previews with deterministic financial calculations, evidence chains, and audit trails.
    MIT
  • A
    license
    -
    quality
    C
    maintenance
    Enables access to financial market data including EOD, intraday, fundamentals, news, and more via 75 read-only MCP tools.
    5
    MIT

View all MCP Servers

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources