Fixed-income desk
Read the rate environment and price a bond in one workflow: the live Treasury curve, the recession-signal spread, inflation context, then price and yield a specific coupon bond at current rates.
5 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
Evaluating a bond or building a rates view - you want the current curve, the 2s10s spread as a cycle signal, real-yield context from inflation, and the price/yield math on a specific coupon bond, all grounded in live Treasury data.
Tools in this pack
All 5 run inside the single $0.017 call above. Each is also callable on its own if you only need one part.
- US Treasury daily yield curve GET /api/treasury-yield-curve Latest US Treasury daily constant-maturity yield curve in one object: recordDate plus mo1, mo3, mo6, yr1, yr2, yr3, yr5, yr7, yr10, yr20 and yr30, each a yield in percent. Source: FRED DGS* series (St. Louis Fed), public domain. No params - always returns the most recent published curve, which trails today by a business day or two; for a date range use treasury-yield-history.
- Treasury yield-curve spreads + inversion GET /api/yield-curve-spread Derived 2s10s and 3m10y Treasury yield-curve spreads (in basis points) plus a boolean recession-signal flag when the curve is inverted. Source: FRED constant-maturity yields (public domain). No params.
- Bond price POST /api/bond-price Price a fixed-coupon bond from its yield to maturity: present-value the coupons plus face. Returns clean price, coupon per period, current yield, and premium/discount vs par.
- Bond yield to maturity POST /api/bond-ytm Solve a bond's yield to maturity from its market price - the annual rate that present-values the coupons plus face to that price. Bracketed bisection root-find.
- US CPI year-over-year inflation GET /api/cpi-yoy Latest US Consumer Price Index year-over-year inflation rate (headline CPI-U) plus the trailing 12 months of YoY readings - the headline inflation number. Source: FRED CPIAUCSL with pc1 transformation. No params.
Bought one at a time, these 5 tools cost $0.018 together; the pack is that sum less a 10% bundle discount, rounded up to the $0.001 settlement floor, which is $0.017.
Workflow
- Pull the live Treasury yield curve with treasury-yield-curve - every maturity from 1M to 30Y.
- Check yield-curve-spread for the 2s10s (and 3M-10Y) spread - a persistent inversion is the classic recession lead indicator.
- Get year-over-year CPI from cpi-yoy so you can read the curve in real (inflation-adjusted) terms.
- Price a coupon bond with bond-price using the relevant maturity's yield from the curve as the YTM.
- Invert it with bond-ytm from a market price to confirm the yield, and compare to the curve to see if the bond is cheap or rich.
Arguments
| Name | Required | Description | Example |
|---|---|---|---|
couponRate | no | Bond annual coupon rate as a decimal (e.g. 0.05) | 0.05 |
What one call returns
A JSON object with pack, args, steps, summary; steps holds one entry per tool (treasury-yield-curve, yield-curve-spread, bond-price, bond-ytm, cpi-yoy), each with its own result or error. Full example on the API page.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response. With the agent402-client SDK (npm i agent402-client, an ES module):
import { Agent402 } from "agent402-client";
// payFetch: an x402-wrapped fetch your wallet signs (@x402/fetch).
// Tools on the free tier need no options: new Agent402() pays them by proof-of-work.
// an existing prepaid credits key also works: new Agent402({ creditsKey })
const client = new Agent402({ fetch: payFetch });
const result = await client.call("skill-fixed-income-desk", {"couponRate":"0.05"});
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Analyze the bond market using Agent402's fixed-income-desk skill pack. (1) Pull the live Treasury yield curve, (2) get the 2s10s spread and say whether it's inverted, (3) get YoY CPI for real-yield context, (4) price a 10-year bond with a 0.05 coupon at the current 10Y yield, (5) invert that price with bond-ytm to confirm the yield. Summarize the rate environment and whether the bond is fairly priced.