Skip to main content
Glama

Ariadne Nexus Institutional Quantitative Engine

Single-Bond CUSIP Valuation & Jump-Diffusion Analytics

get_cusip_valuation
Read-onlyIdempotent

Computes deterministic fair market value (USD), yield-to-maturity (approximate and exact cashflow YTM %), Macaulay and modified duration (years), convexity, DV01 (USD per 1bp shift), and Merton jump-diffusion 95% confidence bounds for a single corporate, sovereign, or RWA fixed-income security. Use when: pricing or analyzing an individual bond CUSIP/ticker given par value, coupon, maturity, and clean market price. Do not use when: scanning FINRA TRACE secondary dealer prints or structuring single-security option collars (use get_debt_radar instead), or running multi-position portfolio macro shocks and VaR/CVaR (use run_portfolio_stress_test instead). Behavior: Read-only, deterministic, side-effect-free calculation ($0.50 USD per call via HTTP header x-api-key or x-payment-token; returns an x402/MPP paymentChallenge without charging if credentials are omitted).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_cusip_valuation"
  }
}

Input Schema

NameRequiredDescriptionDefault
cusipNo9-character alphanumeric CUSIP security identifier (e.g., "912828ZG2", "037833EK1", "38141GZX8"). Defaults to "912828ZG2" if omitted.912828ZG2
tickerNoOptional issuer ticker symbol used as fallback lookup when CUSIP is omitted (e.g., "UST-5Y", "AAPL", "GS").
asset_typeNoFixed-income instrument classification governing jump-diffusion volatility calibration (default: "CORPORATE_BOND").CORPORATE_BOND
face_valueNoPar / notional principal face value in USD (positive number, e.g., 1000000 for $1M par; default: 1000000).
coupon_rateNoAnnualized stated coupon rate as a percentage (e.g., 6.25 for 6.25% paid semi-annually; default: resolved from security master or 6.25).
market_priceNoCurrent clean market trading price expressed as a percentage of par (e.g., 93.50 for 93.50% of par; default: 93.50).
maturity_yearsNoRemaining time to stated maturity in years (minimum 0.5, e.g., 5.0 for 5 years; default: 5.0).

Output Schema

NameRequiredDescriptionDefault
toolYesExecuted tool identifier ("get_cusip_valuation").
cusipYesResolved 9-character CUSIP identifier.
receiptNoCryptographic payment or API key settlement receipt ID.
dv01_usdYesDollar value of a 1 basis point (0.01%) parallel yield shift in USD.
convexityNoApproximate second-order rate sensitivity convexity.
issuer_nameNoLegal name of the issuing entity.
credit_ratingNoComposite institutional credit rating (e.g., AAA, AA, BBB).
security_nameNoDescriptive bond issue title.
recommendationYesDeterministic relative-value signal based on clean price vs. par.
exact_convexityNoExact semi-annual cashflow convexity.
market_value_usdYesCurrent mark-to-market position value in USD.
yield_to_maturity_pctYesApproximate annualized yield-to-maturity percentage.
exact_cashflow_ytm_pctNoExact Newton-Raphson semi-annual cashflow yield-to-maturity percentage.
macaulay_duration_yearsNoCashflow-weighted Macaulay duration in years.
modified_duration_yearsYesApproximate interest-rate sensitivity modified duration in years.
jump_diffusion_95_bounds_usdNoMerton jump-diffusion 1-year 95% confidence interval bounds in USD.
exact_modified_duration_yearsNoExact semi-annual cashflow modified duration in years.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • removedInput schema / properties / apiKey
      Removed value: -{
      -  "description": "Optional Ariadne Nexus Developer API key (\"nexus_live_...\") for authenticated execution. May also be passed via the x-api-key HTTP header.",
      -  "type": "string"
      -}
    • removedInput schema / properties / paymentToken
      Removed value: -{
      -  "description": "Optional Stripe Shared Payment Token (\"spt_...\") or settled x402 payment receipt hash (\"rcpt_...\") for pay-per-call execution ($0.50 USD).",
      -  "type": "string"
      -}
  2. Changed15 schema fields changed
    • changedInput schema / properties / apiKey / description
      Previous value: -"Optional Ariadne Developer API key (nexus_live_...)"New value: +"Optional Ariadne Nexus Developer API key (\"nexus_live_...\") for authenticated execution. May also be passed via the x-api-key HTTP header."
    • addedInput schema / properties / asset_type / description
      Added value: +"Fixed-income instrument classification governing jump-diffusion volatility calibration (default: \"CORPORATE_BOND\")."
    • addedInput schema / properties / coupon_rate / default
      Added value: +6.25
    • changedInput schema / properties / coupon_rate / description
      Previous value: -"Annual coupon rate % (default: 6.25)"New value: +"Annualized stated coupon rate as a percentage (e.g., 6.25 for 6.25% paid semi-annually; default: resolved from security master or 6.25)."
    • addedInput schema / properties / cusip / default
      Added value: +"912828ZG2"
    • changedInput schema / properties / cusip / description
      Previous value: -"9-character CUSIP identifier (e.g. 912828ZG2)"New value: +"9-character alphanumeric CUSIP security identifier (e.g., \"912828ZG2\", \"037833EK1\", \"38141GZX8\"). Defaults to \"912828ZG2\" if omitted."
    • addedInput schema / properties / face_value / default
      Added value: +1000000
    • changedInput schema / properties / face_value / description
      Previous value: -"Face value in USD (default: 1000000)"New value: +"Par / notional principal face value in USD (positive number, e.g., 1000000 for $1M par; default: 1000000)."
    • addedInput schema / properties / market_price / default
      Added value: +93.5
    • changedInput schema / properties / market_price / description
      Previous value: -"Market price as % of par (default: 93.50)"New value: +"Current clean market trading price expressed as a percentage of par (e.g., 93.50 for 93.50% of par; default: 93.50)."
    • addedInput schema / properties / maturity_years / default
      Added value: +5
    • changedInput schema / properties / maturity_years / description
      Previous value: -"Years to maturity (default: 5.0)"New value: +"Remaining time to stated maturity in years (minimum 0.5, e.g., 5.0 for 5 years; default: 5.0)."
    • changedInput schema / properties / paymentToken / description
      Previous value: -"Optional Stripe Shared Payment Token (spt_...) or receipt hash"New value: +"Optional Stripe Shared Payment Token (\"spt_...\") or settled x402 payment receipt hash (\"rcpt_...\") for pay-per-call execution ($0.50 USD)."
    • addedInput schema / properties / ticker
      Added value: +{
      +  "description": "Optional issuer ticker symbol used as fallback lookup when CUSIP is omitted (e.g., \"UST-5Y\", \"AAPL\", \"GS\").",
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "convexity": {
      +      "description": "Approximate second-order rate sensitivity convexity.",
      +      "type": "number"
      +    },
      +    "credit_rating": {
      +      "description": "Composite institutional credit rating (e.g., AAA, AA, BBB).",
      +      "type": "string"
      +    },
      +    "cusip": {
      +      "description": "Resolved 9-character CUSIP identifier.",
      +      "type": "string"
      +    },
      +    "dv01_usd": {
      +      "description": "Dollar value of a 1 basis point (0.01%) parallel yield shift in USD.",
      +      "type": "number"
      +    },
      +    "exact_cashflow_ytm_pct": {
      +      "description": "Exact Newton-Raphson semi-annual cashflow yield-to-maturity percentage.",
      +      "type": "number"
      +    },
      +    "exact_convexity": {
      +      "description": "Exact semi-annual cashflow convexity.",
      +      "type": "number"
      +    },
      +    "exact_modified_duration_years": {
      +      "description": "Exact semi-annual cashflow modified duration in years.",
      +      "type": "number"
      +    },
      +    "issuer_name": {
      +      "description": "Legal name of the issuing entity.",
      +      "type": "string"
      +    },
      +    "jump_diffusion_95_bounds_usd": {
      +      "description": "Merton jump-diffusion 1-year 95% confidence interval bounds in USD.",
      +      "properties": {
      +        "annual_total_volatility_pct": {
      +          "description": "Combined diffusive and Poisson jump annualized volatility %.",
      +          "type": "number"
      +        },
      +        "lower_bound_usd": {
      +          "description": "95% downside tail valuation bound in USD.",
      +          "type": "number"
      +        },
      +        "upper_bound_usd": {
      +          "description": "95% upside valuation bound in USD.",
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "macaulay_duration_years": {
      +      "description": "Cashflow-weighted Macaulay duration in years.",
      +      "type": "number"
      +    },
      +    "market_value_usd": {
      +      "description": "Current mark-to-market position value in USD.",
      +      "type": "number"
      +    },
      +    "modified_duration_years": {
      +      "description": "Approximate interest-rate sensitivity modified duration in years.",
      +      "type": "number"
      +    },
      +    "receipt": {
      +      "description": "Cryptographic payment or API key settlement receipt ID.",
      +      "type": "string"
      +    },
      +    "recommendation": {
      +      "description": "Deterministic relative-value signal based on clean price vs. par.",
      +      "enum": [
      +        "DEEP_DISCOUNT_BUY",
      +        "ACCUMULATE",
      +        "HOLD_PAR"
      +      ],
      +      "type": "string"
      +    },
      +    "security_name": {
      +      "description": "Descriptive bond issue title.",
      +      "type": "string"
      +    },
      +    "tool": {
      +      "description": "Executed tool identifier (\"get_cusip_valuation\").",
      +      "type": "string"
      +    },
      +    "yield_to_maturity_pct": {
      +      "description": "Approximate annualized yield-to-maturity percentage.",
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "tool",
      +    "cusip",
      +    "market_value_usd",
      +    "yield_to_maturity_pct",
      +    "modified_duration_years",
      +    "dv01_usd",
      +    "recommendation"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive, closed-world behavior, and the description adds important operational context: deterministic side-effect-free calculation, a $0.50 USD per-call charge, and x402/MPP paymentChallenge behavior when credentials are omitted. This is exactly the kind of pricing and auth behavior an agent needs 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 dense but well structured: capabilities first, then use/don't-use routing, then behavioral and payment details. Every sentence carries useful selection or invocation information, with no filler.

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 complexity, the description covers purpose, selection boundaries, payment/auth behavior, and side-effect profile, while the output schema handles return values. An agent has enough context to decide when to call it and how to invoke it 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?

Schema description coverage is 100%, so all seven parameters are already documented in the input schema, including defaults, units, and the asset-type enum. The description reinforces the key inputs but does not add significant 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 uses a specific verb-and-resource framing: computes fair market value, YTM, durations, convexity, DV01, and jump-diffusion confidence bounds for a single fixed-income security. It clearly distinguishes the tool from sibling workflows such as TRACE scanning, option collars, and portfolio stress testing.

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?

It gives an explicit 'Use when' condition involving pricing or analyzing an individual bond CUSIP/ticker with par value, coupon, maturity, and clean price. It also gives explicit 'Do not use when' cases and names the correct alternatives: get_debt_radar and run_portfolio_stress_test.

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.