# Bonds API

> Sovereign bond yields, spreads, and yield curves for 60+ countries.
> Authentication: `X-API-Key: YOUR_KEY` header, or an OAuth bearer token from POST /oauth/token.
> Base URL: `https://bonds-api.com/api/v1`
> Get your key: https://bonds-api.com/register
> MCP: `POST https://mcp.bonds-api.com` (this server) — 7 tools, one per endpoint below.

## Endpoints

- **GET /latest** (tool: `latest`) — Most recent bond yields for one or more countries/maturities.
- **GET /historical** (tool: `historical`) — Bond yield on one specific past date.
- **GET /timeseries** (tool: `timeseries`) — Bond yield time series over a date range.
- **GET /spread** (tool: `spread`) — Yield spread of a country against a benchmark (e.g. Bund, Treasury).
- **GET /curve** (tool: `curve`) — A country's full yield curve.
- **GET /intraday** (tool: `intraday`) — Intraday yield snapshots for one day (Professional plan).
- **GET /fluctuation** (tool: `fluctuation`) — Change, min and max yield over a period.

---

For parameters, examples, and sample responses see: /llms-full.txt
OpenAPI 3.0 spec: https://bonds-api.com/openapi.json