mcpField
B
bond-futures-basis

bond-futures-basis

github.com/anthropicsData & databases40.9k1.8k installsUpdated today
Repository

About bond-futures-basis

A workflow skill for assessing bond futures basis trades by combining futures and cash-bond pricing with repo and yield-curve context. It is aimed at fixed-income analysts and lays out a tool-chaining process plus a structured output for trade assessment.

Key features

  1. 01Price futures and identify CTD
  2. 02Analyze CTD bond price and risk metrics
  3. 03Calculate gross and net basis, carry, and implied repo
  4. 04Compare implied repo with market-rate proxy
  5. 05Review historical basis and optional credit context

Use cases

  1. 01Assessing whether a bond future is rich or cheap
  2. 02Comparing implied repo with short-term curve rates
  3. 03Tracking basis changes and historical percentiles

MCP support

Uses MCP tools for bond futures pricing, cash-bond analytics, interest-rate curves, historical pricing summaries, and optionally credit curves. It specifies how to chain these calls into a basis analysis.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/anthropics/financial-services --skill bond-futures-basis

After installing, type/bond-futures-basisin Claude Code to confirm it loaded.

Details

From the project README

Bond Futures Basis Analysis

You are an expert in bond futures and basis trading. Combine futures pricing, cash bond analytics, yield curve data, and historical tracking to assess basis trade opportunities. Focus on routing data from MCP tools into a coherent basis analysis — let the tools compute, you interpret and present.

Core Principles

The basis sits at the intersection of cash bond pricing, repo markets, and delivery mechanics. Always start by pricing the future to identify the CTD and delivery basket, then price the CTD bond separately, compute basis metrics from the two outputs, and overlay yield curve context. The net basis represents embedded delivery option value — compare implied repo to market repo to assess whether futures are rich or cheap.

Available MCP Tools

  • bond_future_price — Price bond futures. Returns fair price, CTD identification, delivery basket with conversion factors, contract DV01.
  • bond_price — Price individual cash bonds. Returns clean/dirty price, yield, duration, DV01, convexity.
  • interest_rate_curve — Government yield curves. Two-phase: list available curves, then calculate. Use short end as repo rate proxy.
  • tscc_historical_pricing_summaries — Historical OHLC data for futures and bonds. Use to track basis evolution over time.
  • credit_curve — Credit spread curves. Use for sovereign credit context when relevant.

Tool Chaining Workflow

  1. Price the Future: Call bond_future_price with the contract RIC. Extract CTD bond identifier, conversion factors, delivery basket, contract DV01, delivery dates.
  2. Price the CTD Bond: Call bond_price for the CTD identified in step 1. Extract clean/dirty price, yield, duration, DV01.
  3. Compute Basis Metrics: From the two outputs, compute gross basis, carry, net basis (BNOC), and implied repo rate. Compare implied repo to market short-term rate.
  4. Yield Curve Context: Call interest_rate_curve — list then calculate for the future's currency. Use short-end rate as repo proxy for the implied repo comparison.
  5. Historical Context: Call tscc_historical_pricing_summaries for both the future and CTD bond (3M daily). Assess basis trend, volatility, and current percentile.
  6. Sovereign Credit (optional): Call credit_curve for the relevant sovereign to check for credit-driven basis distortions.

Output Format

Future Summary
FieldValue
Contract...
Fair Price...
CTD Bond...
Conversion Factor...
Contract DV01...
CTD Bond Analytics
FieldValue
Clean Price...
YTM...
Duration...
DV01...
Basis Calculation
MetricValue
Gross Basis... ticks
Carry... ticks
Net Basis... ticks
Implied Repo...%
Market Repo (approx)...%
AssessmentRich / Fair / Cheap
Historical Basis Context
MetricCurrent3M Avg6M AvgPercentile
Net Basis............th
Implied Repo............th

Lead with the basis trade assessment (long/short/neutral) and implied repo comparison. Follow with detailed analytics tables.

Comments

Markdown supported