za.co.zaroniacalculator.api/verify

Official4 tools

by api

Independent ZARONIA coupon verification for SA FRNs & money-market paper, SARB-compounded index.

This MCP server provides independent ZARONIA coupon verification for South African FRNs and money-market paper, using a SARB-compounded index. It exposes four tools that support verification workflows for coupon-related calculations and indexing referenced by its service description.

🛠️ Key Features

Independent ZARONIA coupon verification
Supports SA FRNs and money-market paper
Uses a SARB-compounded index
Provides 4 tools

🚀 Use Cases

Verify ZARONIA coupons for SA floating-rate notes (FRNs)
Verify coupons for money-market paper
Confirm results based on SARB-compounded index behavior

⚡ Developer Benefits

Clear, domain-specific verification scope for ZARONIA
Programmatic access via multiple tools (4)
Aligns verification with SARB-compounded index requirements

⚠️ Limitations

Description does not specify supported input formats, output schemas, authentication, or error handling details.

Captured live from the server via tools/list.

get_conventions

FREE. The exact calculation conventions of both engines (listed FRN: SARB §2.2.3 compounded index, 5-bday lookback, Modified Following; OTC: 1-bday lookback, Act/365, half-up 4dp), the verification tolerance, and the index source. Call this first.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_latest_index

FREE. The latest published SARB Compounded ZARONIA Index point — date and 12dp value. Use it to confirm data freshness before verifying.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_frn_coupon

PAID ($0.25). Independently recompute and verify a listed South African ZARONIA FRN coupon (SARB §2.2.3 compounded-index formula). Returns the coupon to 4dp, full audit workings (observation dates, index values, formula), and a match/mismatch verdict at 0.05bp tolerance when expected_coupon_pct is given. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Parameters8

calc_date	string	required	YYYY-MM-DD — issue, reset or mid-period date to recompute at
issue_date	string	required	YYYY-MM-DD
first_coupon_date	string	required	YYYY-MM-DD — first IPD; Modified Following schedule from here
coupon_frequency	string	required
margin_pct	number	required	Prospectus margin/spread, percent p.a.
lookback_bdays	integer	optional	Per-bond lookback, default 5
expected_coupon_pct	number	optional	The coupon you were given — enables the verdict
api_key	string	optional	zaronia-verify API key (bypasses x402; metered for invoicing)

Raw schema

{
  "type": "object",
  "properties": {
    "calc_date": {
      "type": "string",
      "description": "YYYY-MM-DD — issue, reset or mid-period date to recompute at"
    },
    "issue_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "first_coupon_date": {
      "type": "string",
      "description": "YYYY-MM-DD — first IPD; Modified Following schedule from here"
    },
    "coupon_frequency": {
      "type": "string",
      "enum": [
        "Monthly",
        "Quarterly",
        "Semi-annually",
        "Annually"
      ]
    },
    "margin_pct": {
      "type": "number",
      "description": "Prospectus margin/spread, percent p.a."
    },
    "lookback_bdays": {
      "description": "Per-bond lookback, default 5",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "expected_coupon_pct": {
      "description": "The coupon you were given — enables the verdict",
      "type": "number"
    },
    "api_key": {
      "description": "zaronia-verify API key (bypasses x402; metered for invoicing)",
      "type": "string"
    }
  },
  "required": [
    "calc_date",
    "issue_date",
    "first_coupon_date",
    "coupon_frequency",
    "margin_pct"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_otc_coupon

PAID ($0.10). Independently recompute and verify an OTC money-market ZARONIA coupon (1-bday lookback, Act/365, half-up 4dp). Returns coupon, workings and a verdict at 0.05bp tolerance when expected_coupon_pct is given. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Parameters4

settlement_date	string	required	YYYY-MM-DD — settlement = issue date
margin_pct	number	required
expected_coupon_pct	number	optional
api_key	string	optional	zaronia-verify API key

Raw schema

{
  "type": "object",
  "properties": {
    "settlement_date": {
      "type": "string",
      "description": "YYYY-MM-DD — settlement = issue date"
    },
    "margin_pct": {
      "type": "number"
    },
    "expected_coupon_pct": {
      "type": "number"
    },
    "api_key": {
      "description": "zaronia-verify API key",
      "type": "string"
    }
  },
  "required": [
    "settlement_date",
    "margin_pct"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (4)

get_conventionsget_latest_indexverify_frn_couponverify_otc_coupon

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.zaroniacalculator.co.za/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "verify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.zaroniacalculator.co.za/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_conventions

get_latest_index

verify_frn_coupon

verify_otc_coupon

Install

Remote endpoint

Related servers