Skip to main content
Glama

Silver Price Per Gram MCP

Calculate silver melt value

calculate_silver_value
Read-onlyIdempotent

Melt value of a silver item (sterling flatware, tea set, jewellery, bar, round, scrap) from its weight, unit and fineness at the live silver spot price, in any currency. Optional dealer_spread_percent returns the likely buyer offer. Sterling means at least 925/1000 silver under 16 CFR 23.5. Default fineness is sterling.

Input Schema

NameRequiredDescriptionDefault
unitNoWeight unit: gram, kilogram, troy_ounce, pennyweight, grain, avoirdupois_ounce, pound, troy_pound, tola. Aliases such as g, kg, oz, ozt, dwt, lb work. "oz" means troy ounce; use avoirdupois_ounce for a kitchen scale.gram
weightYesWeight of the item, for example 250.
currencyNoISO 4217 currency code, for example USD, EUR, GBP, INR, CAD, AUD, MXN. Default USD.USD
finenessNoSilver grade: "fine" (999), "britannia" (958.4), "sterling" (925), "coin" (900), "800", or parts per thousand such as 925, or a fraction such as 0.925.sterling
dealer_spread_percentNoPercent a buyer keeps below melt, for example 15 for an offer at 85% of melt. Default 0.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and non-destructive, so the safety profile is covered. The description adds genuine context beyond them: valuation is tied to the live spot price (an external, time-varying input), the spread parameter models a buyer's discount to melt, and sterling is defined against 16 CFR 23.5. It does not note that results will drift between calls as spot moves, which is the one nuance an agent might trip on.

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?

Three sentences, front-loaded with the purpose, then the optional parameter's effect, then the fineness default. The 16 CFR citation is borderline trivia but does justify the 'at least 925' threshold, so it mostly earns its place; the text is dense but not padded.

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 no output schema, the description carries the burden of describing results, and it does so at a high level (melt value in any currency, plus an optional buyer-offer figure). It stops short of naming the returned fields or how spot price and currency conversion are reported, which would fully close the gap for a live-price calculation 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?

Schema coverage is 100%, so the baseline is 3, but the description earns above that by explaining that dealer_spread_percent yields the likely buyer offer (an output-level consequence the schema only frames as a percentage) and by restating that the default fineness is sterling. Unit and currency semantics are left entirely to the schema, which already handles them well.

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 opens with a specific verb-and-resource statement ('Melt value of a silver item ... from its weight, unit and fineness at the live silver spot price') and enumerates the covered item classes (flatware, tea set, jewellery, bar, round, scrap). It does not name the sibling calculate_junk_silver_value, so the boundary with coin-based valuation is left implicit rather than stated.

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 item-type list gives clear context for when this tool applies, and the mention of dealer_spread_percent signals the optional 'what will a buyer pay' use case. There is no explicit exclusion clause telling the agent to prefer calculate_junk_silver_value for coin lots or get_silver_price_per_gram for a bare price lookup.

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.