Skip to main content
Glama

Server Details

FRED macro data, Treasury yields, FX rates & macro indicators for AI agents. Pay-per-query via x402.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
zev-lll/lastlook-data
GitHub Stars
0

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 DescriptionsA

Average 4.3/5 across 12 of 12 tools scored.

Server CoherenceA
Disambiguation4/5

Most tools have distinct purposes, but there is slight overlap between get_current_value, get_series, and get_value_by_date. However, descriptions clarify when to use each, reducing ambiguity.

Naming Consistency5/5

All tools follow a consistent 'get_' + descriptive noun pattern with snake_case, making it easy to infer functionality from the name.

Tool Count5/5

With 12 tools, the set is well-scoped for an economic data server. Each tool covers a specific data retrieval need without being overwhelming.

Completeness4/5

The tools cover current values, historical series, specific dates, calendar, FX rates, yields, yield curve, policy spread, and recession indicators. Minor gaps exist (e.g., no tool for other maturities' daily yields), but core use cases are well-covered.

Available Tools

12 tools
get_current_valueGet Current FRED Series ValueA
Read-onlyIdempotent
Inspect

Returns only the single most recent value for any supported FRED series. Cheaper than get_series ($0.01 vs $0.05). Use this when you need just the latest reading — e.g. current CPI, unemployment rate, mortgage rate. Use get_series instead when you need historical observations.

ParametersJSON Schema
NameRequiredDescriptionDefault
series_idYesFRED series ID e.g. CPIAUCSL, UNRATE, MORTGAGE30US, DGS10, DCOILWTICO, SAHMREALTIME

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the observation (YYYY-MM-DD)
labelYesHuman-readable series name
valueYesMost recent observed value
series_idYesFRED series identifier
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 value by specifying the data scope ('single most recent value') and cost difference, which are not covered by 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?

Two sentences, no wasted words. The key information (purpose, cost, usage guidance) is front-loaded and easy to parse.

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?

The tool is simple with one parameter and has an output schema. The description covers purpose, usage, cost, and alternatives comprehensively. No gaps.

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?

Schema coverage is 100% with enums and descriptions for series_id. The description mentions examples (CPI, unemployment rate, mortgage rate) that align with the enum, but adds little semantic meaning beyond the schema.

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 tool 'returns only the single most recent value for any supported FRED series.' It explicitly distinguishes the purpose from the sibling tool get_series by contrasting 'current reading' vs. 'historical observations.'

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

Usage Guidelines5/5

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

The description provides explicit guidance on when to use this tool ('when you need just the latest reading') and when to use the alternative get_series ('when you need historical observations'). It also highlights a cost advantage ($0.01 vs $0.05), aiding decision-making.

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

get_economic_calendarGet Economic CalendarA
Read-onlyIdempotent
Inspect

Returns upcoming FRED economic data release dates — CPI, jobs report, GDP, Treasury rates, and more. Use this to find out when the next major economic data will be published.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysYesLookahead window in days: 30, 60, or 90

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYesNumber of scheduled releases
releasesYesScheduled FRED economic data releases
calendar_endYesEnd date of the calendar window
calendar_startYesStart date of the calendar window
Behavior4/5

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

Annotations already declare readOnlyHint and idempotentHint. The description adds that it retrieves release dates and mentions the data source (FRED). No side effects or behavioral quirks needed, so the description complements annotations well.

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?

Two sentences with no redundant information. The purpose is front-loaded and the structure is efficient.

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?

For a simple param set with an output schema, the description fully covers what the tool does, when to use it, and gives concrete examples. No gaps.

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 schema covers the single parameter 'days' with enum and description. The description does not elaborate on the parameter beyond what the schema provides, meeting the baseline expectation for high 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 explicitly states it returns upcoming FRED economic data release dates and lists examples (CPI, jobs report, GDP). It clearly distinguishes from sibling tools like get_current_value which return actual values.

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 instructs to use this tool to find when the next major economic data will be published. While it doesn't explicitly mention when not to use it, the sibling context makes it clear that value-retrieval tools are for actual numbers.

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

get_fx_rate_by_dateGet G10 FX Rate by DateA
Read-onlyIdempotent
Inspect

Returns the exchange rate for a G10 currency pair on a specific date. Source: European Central Bank. Use YYYY-MM-DD format.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesDate in YYYY-MM-DD format e.g. 2026-01-15
pairYesG10 currency pair e.g. EURUSD, USDJPY

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the rate (YYYY-MM-DD)
pairYesCurrency pair identifier
rateYesExchange rate on the requested date
labelYesHuman-readable pair name
Behavior4/5

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

Annotations already indicate read-only, idempotent, open-world. The description adds data source (ECB) and date format, providing useful context without contradicting 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?

Three sentences, no waste. Purpose, source, and format are front-loaded and efficient.

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?

Output schema covers return details. Description covers purpose, source, and format. Could mention error handling for missing dates but openWorldHint covers that.

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?

Schema coverage is 100%. Description reinforces date format and enumeration context. Adds marginal value over schema by specifying G10 identity.

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 it returns exchange rates for G10 pairs on a specific date, with data source and format. It distinguishes from siblings like get_fx_rate_current and get_fx_rate_series.

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 single-date lookup but does not explicitly guide when to use over alternatives like get_fx_rate_current or get_fx_rate_series.

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

get_fx_rate_currentGet Current G10 FX RateA
Read-onlyIdempotent
Inspect

Returns the current exchange rate for a G10 currency pair. Source: European Central Bank. Supported: EURUSD, GBPUSD, USDJPY, USDCHF, USDCAD, AUDUSD, NZDUSD, USDSEK, USDNOK.

ParametersJSON Schema
NameRequiredDescriptionDefault
pairYesG10 currency pair e.g. EURUSD, USDJPY, GBPUSD

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the rate (YYYY-MM-DD)
pairYesCurrency pair identifier
rateYesCurrent exchange rate
labelYesHuman-readable pair name
Behavior4/5

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

Annotations already provide safety and idempotency cues. The description adds the data source (European Central Bank) and explicitly lists all supported currency pairs, which is useful beyond 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?

Two sentences, clear and front-loaded with the core purpose; no extraneous words. Efficient and to the point.

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?

The tool is simple with one parameter and an output schema. The description covers source, supported pairs, and purpose, making it fully complete for an agent to use 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 single parameter 'pair' is fully documented with an enum and description in the schema, achieving 100% coverage. The description merely restates 'G10 currency pair', adding no new information beyond the schema.

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 'returns', the resource 'current exchange rate', and the scope 'G10 currency pair', with a specific list of supported pairs. It distinguishes from sibling tools like get_fx_rate_by_date or get_fx_rate_series.

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 implies usage for current rates only, and the list of pairs sets expectations. However, it does not explicitly state when not to use or suggest alternatives like get_fx_rate_by_date for historical rates.

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

get_fx_rate_seriesGet G10 FX Rate HistoryA
Read-onlyIdempotent
Inspect

Returns historical daily exchange rates for a G10 currency pair. Source: European Central Bank.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysYesHistory window: 30 ($0.05), 90 ($0.10), or 365 ($0.25)
pairYesG10 currency pair e.g. EURUSD

Output Schema

ParametersJSON Schema
NameRequiredDescription
endYesEnd date of the window
pairYesCurrency pair identifier
countYesNumber of observations returned
labelYesHuman-readable pair name
startYesStart date of the window
observationsYesDaily exchange rates
Behavior4/5

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

Annotations already provide read-only, idempotent, open-world hints. Description adds value by specifying the data source (ECB) and that rates are daily. No contradictions 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.

Conciseness4/5

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

The description is a single sentence that efficiently states the core functionality. It is front-loaded with the verb and resource. Could potentially add a bit more context without becoming verbose.

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 the presence of an output schema, the description need not detail return values. It sufficiently covers source, data type, and scope. Annotations and schema together provide a complete picture for a tool of this complexity.

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?

Schema coverage is 100%, with enums and descriptions for both parameters. The description adds minimal extra meaning beyond 'G10 currency pair' which aligns with the enum list. Baseline 3 is appropriate.

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 name, title, and description clearly indicate the tool retrieves historical daily exchange rates for G10 currency pairs from the ECB. It competently distinguishes itself from sibling tools like 'get_current_value' and 'get_fx_rate_by_date' which serve different purposes.

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 implies usage for obtaining historical series, but lacks explicit guidance on when-not-to-use or direct comparisons with siblings. However, the context of sibling names helps differentiate use cases.

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

get_policy_spreadGet Fed Policy Spread (EFFR vs IORB)A
Read-onlyIdempotent
Inspect

Returns the spread between the Effective Federal Funds Rate (EFFR) and Interest on Reserve Balances (IORB), with an interpretation of Fed policy stance. EFFR below IORB is the normal operating band. Source: FRED.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
effrYesEffective Federal Funds Rate (%)
iorbYesInterest on Reserve Balances (%)
as_ofYesDate of the most recent data
spreadYesEFFR minus IORB spread in percentage points
interpretationYesPolicy stance interpretation
Behavior4/5

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

Annotations already indicate readOnly, idempotent, and not destructive. The description adds value by explaining the return includes an interpretation and the normal band, and identifies the data source (FRED). This goes beyond 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?

Two sentences front-load the core function, with no wasted words. Every sentence provides essential information: what it returns, the interpretation, and the source.

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 there are no parameters and an output schema exists (not shown but present), the description sufficiently covers the tool's purpose, return content, and source. No additional context is needed.

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 no parameters, so schema coverage is 100%. The baseline for no parameters is 4, and the description does not need to add parameter information. It implicitly suggests a zero-parameter invocation.

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 tool returns the spread between EFFR and IORB with interpretation of Fed policy stance, specifying the normal band and source. This is a specific verb+resource that distinguishes it from sibling tools that return single values or series.

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 for getting this specific spread, but does not provide explicit guidance on when to use versus alternatives like get_current_value or get_value_by_date. No exclusions or alternative tools are mentioned.

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

get_recession_indicatorGet Sahm Rule Recession IndicatorA
Read-onlyIdempotent
Inspect

Returns the real-time Sahm Rule recession indicator. A value >= 0.50 signals a recession is likely underway. Measures the rise in unemployment from its recent low. Source: FRED SAHMREALTIME.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
as_ofYesDate of the most recent observation
valueYesSahm Rule indicator value
signalYesHuman-readable signal description
thresholdYesTrigger threshold (0.50)
triggeredYesTrue if value >= 0.50 (recession signal active)
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint, and non-destructive. The description adds context about the indicator's meaning (recession threshold, measurement methodology) and data source. No contradictions. It enhances understanding beyond 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 three sentences, front-loaded with the main purpose, and each sentence adds value: what it returns, the key threshold, and the source. No redundant or extra words.

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 an output schema, the description adequately covers what the tool does and the significance of the value. It could optionally mention freshness (e.g., 'real-time' implies current but not frequency) but overall is complete.

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 input schema has no parameters (0), so schema coverage is 100%. The description does not need to explain parameters. The baseline of 4 applies as it provides sufficient context for a parameterless tool.

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 it returns the real-time Sahm Rule recession indicator, explaining what it measures, the threshold for recession (>=0.50), and the data source (FRED SAHMREALTIME). This distinguishes it from sibling tools like get_current_value or get_series by naming the specific indicator and its purpose.

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 this tool should be used when a recession indicator is needed, but it does not explicitly guide when to use this over alternatives such as get_series for FRED data or other get_ tools. It lacks when-not-to-use or comparison with siblings, which are many.

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

get_seriesGet FRED Data SeriesA
Read-onlyIdempotent
Inspect

Returns recent observations for any supported FRED data series. Use this to get current and historical values for mortgage rates, Treasury yields, Fed funds rate, CPI, SOFR, unemployment, GDP, energy prices, and more. Common use cases:

  • Current 30-yr mortgage rate: series_id=MORTGAGE30US, days=30

  • Current Fed funds rate: series_id=FEDFUNDS, days=30

  • Current 10-yr Treasury yield: series_id=DGS10, days=30

  • Current CPI (inflation): series_id=CPIAUCSL, days=30

  • Current WTI crude oil: series_id=DCOILWTICO, days=30 The most recent observation in the returned array is the current value.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysYesHistory window: 30 ($0.05), 90 ($0.10), or 365 ($0.25). Use 30 for current/recent values.
series_idYesFRED series ID. Use IORB for Interest on Reserve Balances, EFFR for Effective Fed Funds Rate, MORTGAGE30US for 30-yr mortgage rate, SAHMREALTIME for Sahm Rule, etc.

Output Schema

ParametersJSON Schema
NameRequiredDescription
endYesEnd date of the series window
countYesNumber of observations returned
labelYesHuman-readable series name
startYesStart date of the series window
series_idYesFRED series identifier
current_dateYesDate of the most recent observation
observationsYesAll observations in the window
current_valueYesMost recent observed value
Behavior4/5

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

Annotations already indicate read-only, idempotent, and non-destructive. The description adds value by clarifying that the most recent observation is the current value and by disclosing the cost tiers for each days option. No contradictions 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.

Conciseness4/5

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

The description is appropriately sized and front-loaded with purpose. The bulleted examples are clear and useful, though listing 6 could be trimmed to 3 representative ones without losing clarity.

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 the tool's simplicity (2 params, output schema present, annotations covering safety), the description provides all necessary information: what it returns, examples, parameter details, cost hints, and how to interpret the last observation. No gaps.

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 input schema has 100% coverage with descriptions. The description adds practical context for each parameter: examples of common series_id values and the meaning of days options (e.g., '30 for current/recent values'). This enhances understanding beyond the schema.

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 it returns recent observations for FRED data series and provides multiple concrete examples (mortgage rates, yields, CPI, etc.). However, it does not explicitly distinguish itself from sibling tools like get_current_value or get_value_by_date, which could cause confusion.

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 offers common use cases and examples, implying when to use the tool (e.g., to get current or recent values). But it lacks explicit guidance on when not to use it or how it differs from alternatives like get_current_value or get_value_by_date.

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

get_treasury_yield_by_dateGet 30-Year Treasury Yield by DateA
Read-onlyIdempotent
Inspect

Returns the 30-year US Treasury yield for a specific date. Business days only. Use YYYY-MM-DD format.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesDate in YYYY-MM-DD format e.g. 2026-05-09

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the observation (YYYY-MM-DD)
yield_percentYes30-year Treasury yield as a percentage
Behavior4/5

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

Annotations clearly mark the tool as read-only, idempotent, and non-destructive. The description adds the important behavioral trait that it only returns data for business days. This is sufficient given the annotations and simple nature of the tool.

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 only two sentences, front-loading the core purpose and immediately following with essential usage constraints. Every word adds value with no redundancy.

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?

Given the simplicity of the tool (single parameter, good annotations, output schema exists), the description covers the key behavioral constraint (business days) and format requirement. Missing detail about behavior on non-business days is minor but prevents a perfect score.

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 input schema has 100% coverage with a clear pattern and description for the date parameter. The description adds the valuable context 'Business days only', which is not in the schema and clarifies when valid inputs are expected.

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 it returns the 30-year US Treasury yield for a specific date. The title and name reinforce this. The distinction from siblings like get_treasury_yield_current and get_yield_curve is implicit but clear due to the specific time scope.

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 gives usage constraints (business days only, YYYY-MM-DD format) but does not explicitly state when to use this tool versus alternatives. It implies use for a specific historical date, not for current values or curves, but lacks explicit 'when to use' and 'when not to use' guidance.

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

get_treasury_yield_currentGet Current 30-Year Treasury YieldA
Read-onlyIdempotent
Inspect

Returns the most recent 30-year US Treasury constant maturity yield (DGS30) from FRED. Free — no payment required. For other series use get_current_value or get_series.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the observation (YYYY-MM-DD)
yield_percentYesCurrent 30-year Treasury yield as a percentage
Behavior4/5

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

Annotations cover readOnly, idempotent, etc. Description adds context: free (no payment), data source (FRED). 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.

Conciseness5/5

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

Two sentences, no waste. First sentence defines tool, second adds cost and alternative references. Front-loaded.

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?

For a parameterless tool with output schema, description covers source, series, type of data. Complete.

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 in schema; baseline 4 as per guidelines. Description has no need to add parameter info.

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 it returns the most recent 30-year US Treasury constant maturity yield (DGS30). Specific verb+resource and names siblings.

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

Usage Guidelines5/5

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

Explicitly says when to use: for current 30-year yield. Provides alternatives for other series: get_current_value or get_series.

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

get_value_by_dateGet FRED Series Value by DateA
Read-onlyIdempotent
Inspect

Returns the value of any supported FRED series for a specific date. Business days only. Use YYYY-MM-DD format.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesDate in YYYY-MM-DD format e.g. 2026-01-15
series_idYesFRED series ID

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYesDate of the observation (YYYY-MM-DD)
labelYesHuman-readable series name
valueYesObserved value on the requested date
series_idYesFRED series identifier
Behavior4/5

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

Annotations already indicate idempotent, read-only, and non-destructive behavior. The description adds the constraint 'Business days only,' which is valuable behavioral information beyond the 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 two sentences, with the key action in the first sentence and necessary constraints in the second. No extraneous information.

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?

Given that an output schema exists (as per context signals), the description covers purpose, date format, and business day restriction. It does not explain behavior on non-business days, but for a read-only query tool, this is adequate.

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?

Schema coverage is 100%, and both parameters have descriptions and enum. The description adds no new semantic information beyond what the schema provides, so baseline score of 3 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?

The description clearly states it returns the value of any supported FRED series for a specific date, with a specific verb+resource. It distinguishes from siblings like get_current_value (which returns current values) and get_treasury_yield_by_date (which is limited to treasury yields).

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 provides explicit guidance: 'Business days only' and 'Use YYYY-MM-DD format.' While it doesn't explicitly state when not to use it, the context of siblings makes the use case clear.

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

get_yield_curveGet Yield Curve SpreadsA
Read-onlyIdempotent
Inspect

Returns 2s10s (2-year vs 10-year) and 3m10y (3-month vs 10-year) Treasury yield curve spreads with inversion signal. An inverted yield curve (negative spread) historically precedes recessions. Source: FRED.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
DGS2Yes2-Year Treasury yield
DGS10Yes10-Year Treasury yield
as_ofYesDate of the most recent underlying data
DGS1MOYes1-Month T-Bill rate
signalYesCurve shape signal: Fully inverted, Partially inverted, or Normal
spread_2s10sYes10Y minus 2Y Treasury spread in percentage points
spread_3m10yYes10Y minus 3-Month T-Bill spread in percentage points
inverted_2s10sYesWhether the 2s10s spread is negative (inverted)
inverted_3m10yYesWhether the 3m10y spread is negative (inverted)
Behavior4/5

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

Annotations already indicate read-only, idempotent, non-destructive behavior. The description adds value by specifying the exact metrics and their historical significance, which aids output interpretation.

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?

Two concise, front-loaded sentences with no wasted words. Each sentence adds essential information: returns and context.

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?

Fully complete for a zero-parameter tool with annotations and output schema. Description clarifies the specific spreads and source, leaving no ambiguity.

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; per guidelines baseline is 4. Description adds meaning about what the tool returns beyond schema, though schema coverage is 100%.

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 specifies the exact spreads returned (2s10s, 3m10y) and the inversion signal, clearly distinguishing it from siblings like get_treasury_yield_* that return individual yields.

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 implies a use case (recession analysis) by stating that inverted curves precede recessions, but does not explicitly exclude alternatives or provide when-not-to-use guidance.

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!

Try in Browser

Your Connectors

Sign in to create a connector for this server.