Skip to main content
Glama

Ariadne Nexus Institutional Quantitative Engine

FINRA TRACE Secondary Debt Tape & Single-CUSIP Collar Structuring

get_debt_radar
Read-onlyIdempotent

Retrieves secondary-market FINRA TRACE dealer execution metrics (last clean price % of par, Z-spread over 10Y U.S. Treasury in bps, effective yield-to-worst %, dealer bid-ask spread in bps, and daily institutional block volume in USD) and solves a Black-Scholes zero-cost 1-year European option collar (put floor strike % and call cap strike %) for a single bond CUSIP or ticker. Use when: inspecting secondary-market dealer liquidity/spreads or structuring a zero-cost downside put / upside call collar for a single bond issue. Do not use when: calculating exact cashflow duration/convexity/DV01 for a custom face value (use get_cusip_valuation instead), or stress-testing a multi-bond portfolio across macro rate shocks (use run_portfolio_stress_test instead). Behavior: Read-only, deterministic market tape and option solver ($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_debt_radar"
  }
}

Input Schema

NameRequiredDescriptionDefault
cusipNo9-character CUSIP identifier to query on the secondary debt tape (e.g., "912828ZG2", "037833EK1", "38141GZX8"; default: "912828ZG2").912828ZG2
tickerNoIssuer ticker symbol to resolve if CUSIP is not specified (e.g., "RWA-AERO", "AAPL", "GS"; default: "RWA-AERO").RWA-AERO
benchmark_ust_yieldNoReference 10-Year U.S. Treasury constant-maturity yield as a percentage used for spread and risk-free collar pricing (e.g., 4.15 for 4.15%; default: 4.15).

Output Schema

NameRequiredDescriptionDefault
tapeYesFINRA TRACE secondary market execution and liquidity metrics.
toolYesExecuted tool identifier ("get_debt_radar").
cusipYesResolved 9-character CUSIP identifier.
tickerNoIssuer ticker symbol.
receiptNoCryptographic payment or API key settlement receipt ID.
issuer_nameNoLegal name of the bond issuer.
collar_structuringYesZero-cost 1-year European option collar strikes (% of par) solved via Black-Scholes.

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. Changed9 schema fields changed
    • changedInput schema / properties / apiKey / description
      Previous value: -"Optional Ariadne Developer API key"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 / benchmark_ust_yield / default
      Added value: +4.15
    • changedInput schema / properties / benchmark_ust_yield / description
      Previous value: -"10-Year Treasury benchmark yield % (default: 4.15)"New value: +"Reference 10-Year U.S. Treasury constant-maturity yield as a percentage used for spread and risk-free collar pricing (e.g., 4.15 for 4.15%; default: 4.15)."
    • addedInput schema / properties / cusip / default
      Added value: +"912828ZG2"
    • changedInput schema / properties / cusip / description
      Previous value: -"9-character CUSIP identifier (default: 912828ZG2)"New value: +"9-character CUSIP identifier to query on the secondary debt tape (e.g., \"912828ZG2\", \"037833EK1\", \"38141GZX8\"; default: \"912828ZG2\")."
    • changedInput schema / properties / paymentToken / description
      Previous value: -"Optional Stripe Shared Payment Token"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 / default
      Added value: +"RWA-AERO"
    • changedInput schema / properties / ticker / description
      Previous value: -"Issuer ticker symbol (default: RWA-AERO)"New value: +"Issuer ticker symbol to resolve if CUSIP is not specified (e.g., \"RWA-AERO\", \"AAPL\", \"GS\"; default: \"RWA-AERO\")."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "collar_structuring": {
      +      "description": "Zero-cost 1-year European option collar strikes (% of par) solved via Black-Scholes.",
      +      "properties": {
      +        "downside_floor_strike_pct": {
      +          "description": "Protective put floor strike as a percentage of par.",
      +          "type": "number"
      +        },
      +        "net_upfront_premium_usd": {
      +          "description": "Net upfront premium in USD (0.00 for zero-cost collar).",
      +          "type": "number"
      +        },
      +        "pricing_model": {
      +          "description": "Mathematical option pricing model applied.",
      +          "type": "string"
      +        },
      +        "structure_type": {
      +          "description": "Option hedge structure classification.",
      +          "type": "string"
      +        },
      +        "upside_cap_strike_pct": {
      +          "description": "Covered call cap strike written to fund the put, as % of par.",
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "downside_floor_strike_pct",
      +        "upside_cap_strike_pct",
      +        "net_upfront_premium_usd"
      +      ],
      +      "type": "object"
      +    },
      +    "cusip": {
      +      "description": "Resolved 9-character CUSIP identifier.",
      +      "type": "string"
      +    },
      +    "issuer_name": {
      +      "description": "Legal name of the bond issuer.",
      +      "type": "string"
      +    },
      +    "receipt": {
      +      "description": "Cryptographic payment or API key settlement receipt ID.",
      +      "type": "string"
      +    },
      +    "tape": {
      +      "description": "FINRA TRACE secondary market execution and liquidity metrics.",
      +      "properties": {
      +        "benchmark_ust_10y_yield_pct": {
      +          "description": "Reference 10Y U.S. Treasury benchmark yield %.",
      +          "type": "number"
      +        },
      +        "bid_ask_spread_bps": {
      +          "description": "Dealer round-trip bid-ask liquidity spread in basis points.",
      +          "type": "number"
      +        },
      +        "daily_reported_volume_usd": {
      +          "description": "24-hour reported institutional par volume in USD.",
      +          "type": "number"
      +        },
      +        "effective_yield_to_worst_pct": {
      +          "description": "Effective yield-to-worst (YTW) as a percentage.",
      +          "type": "number"
      +        },
      +        "last_clean_price": {
      +          "description": "Most recent institutional print clean price as % of par.",
      +          "type": "number"
      +        },
      +        "secondary_spread_bps": {
      +          "description": "Credit spread over benchmark U.S. Treasury in basis points.",
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "last_clean_price",
      +        "secondary_spread_bps",
      +        "effective_yield_to_worst_pct",
      +        "bid_ask_spread_bps"
      +      ],
      +      "type": "object"
      +    },
      +    "ticker": {
      +      "description": "Issuer ticker symbol.",
      +      "type": "string"
      +    },
      +    "tool": {
      +      "description": "Executed tool identifier (\"get_debt_radar\").",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "tool",
      +    "cusip",
      +    "tape",
      +    "collar_structuring"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare readOnlyHint/idempotentHint/destructiveHint=false, so the bar is lower, yet the description adds material context beyond them: the operation is deterministic, costs $0.50 USD per call, authenticates via x-api-key or x-payment-token headers, and returns an x402/MPP paymentChallenge without charging when credentials are absent. That payment/auth behavior is exactly the kind of thing an agent cannot learn from 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?

Front-loaded with purpose, then use/don't-use routing, then behavior — a clean and predictable structure. The parenthetical enumeration of returned metrics is somewhat redundant given that an output schema exists, costing a little length, but every other clause carries real decision value.

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 read-only, deterministic, paid market-data plus option-solver tool with three fully documented parameters and an output schema, the description covers purpose, selection criteria, alternatives, cost, auth behavior, and failure mode. Nothing an agent needs in order to decide and call correctly is missing.

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 the baseline is 3. The description adds only a small amount: it frames cusip/ticker as alternate single-issue identifiers and ties the benchmark to both Z-spread and risk-free collar pricing, but supplies no default, format, or interaction rules beyond what the schema already documents.

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?

States a specific verb ('Retrieves') with two concrete resources: FINRA TRACE secondary dealer execution metrics and a Black-Scholes zero-cost 1-year European collar solver for a single bond. The scope ('single bond CUSIP or ticker') is explicit, and the definition names sibling tools it is not, so an agent can distinguish it without opening any schema.

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?

Provides explicit 'Use when' conditions (dealer liquidity/spread inspection, zero-cost collar structuring) and explicit 'Do not use when' conditions routed to named alternatives: get_cusip_valuation for cashflow duration/convexity/DV01 and run_portfolio_stress_test for multi-bond macro shocks. Both inclusion and exclusion criteria are stated, not inferred.

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.