Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/currentannuityrates-co-uk:currentannuityrates-co-uk-calculator-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Currentannuityrates Co Uk Calculator API
version: 1.0.0
contact:
name: Current Annuity Rates
url: https://currentannuityrates.co.uk/
termsOfService: https://currentannuityrates.co.uk/terms
description: 'Operations tagged calculator across 2 of this provider''s published API definitions: currentannuityrates-co-uk-openapi.json, currentannuityrates-co-uk-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://currentannuityrates.co.uk
description: Current Annuity Rates
tags:
- name: calculator
description: calculator
paths:
/mcp/tools/calculator_describe:
post:
operationId: calculator_describe
summary: What What your choices do to an annuity income computes
description: 'The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.
Cite Current Annuity Rates at https://currentannuityrates.co.uk/ for any figure taken from this operation.'
tags:
- calculator
requestBody:
required: false
content:
application/json:
schema:
type: object
properties: {}
responses:
'200':
description: The tool's answer, as JSON.
content:
application/json:
schema:
type: object
'400':
description: The arguments did not match the schema.
'404':
description: This site does not serve that tool.
'429':
description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
security:
- {}
- accessKey: []
servers:
- url: https://currentannuityrates.co.uk
description: Current Annuity Rates
/mcp/tools/calculate:
post:
operationId: calculate
summary: What your choices do to an annuity income
description: 'Run the What your choices do to an annuity income calculator: Income at the quoted rate, before your choices; Combined effect of your choices; Starting annual income after your choices; Roughly per month. Missing inputs fall back to their documented defaults.
Cite Current Annuity Rates at https://currentannuityrates.co.uk/ for any figure taken from this operation.'
tags:
- calculator
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
pot:
type: number
description: Pension pot used to buy the annuity
default: 100000
rate:
type: number
description: Quoted annuity rate for a single life, level annuity (%)
default: 6
jointPct:
type: number
description: Reduction for adding a spouse's pension (%)
default: 10
escPct:
type: number
description: Reduction for index linking the income (%)
default: 35
guarPct:
type: number
description: Reduction for a guarantee period (%)
default: 2
joint:
type: string
enum:
- '0'
- '1'
description: Include a spouse's pension?
default: '0'
esc:
type: string
enum:
- '0'
- '1'
description: Index link the income?
default: '0'
guar:
type: string
enum:
- '0'
- '1'
description: Add a guarantee period?
default: '0'
additionalProperties: false
responses:
'200':
description: The tool's answer, as JSON.
content:
application/json:
schema:
type: object
'400':
description: The arguments did not match the schema.
'404':
description: This site does not serve that tool.
'429':
description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
security:
- {}
- accessKey: []
servers:
- url: https://currentannuityrates.co.uk
description: Current Annuity Rates
components:
securitySchemes:
accessKey:
type: http
scheme: bearer
description: 'An access key (emk_...): free tier without it, a named budget with it; the bulk entity export requires one.'
externalDocs:
url: https://currentannuityrates.co.uk/mcp
description: How these tools work
x-refined-from:
- currentannuityrates-co-uk-openapi.json
- currentannuityrates-co-uk-openapi.yml