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.
openapi: 3.2.0
info:
title: Employercostcalculator Co Uk Calculator API
version: 1.0.0
contact:
name: Employer Cost Calculator
url: https://employercostcalculator.co.uk/
termsOfService: https://employercostcalculator.co.uk/terms
description: 'Operations tagged calculator across 2 of this provider''s published API definitions: openapi.json, employercostcalculator-co-uk-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://employercostcalculator.co.uk
description: Employer Cost Calculator
tags:
- name: calculator
description: calculator
paths:
/mcp/tools/calculator_describe:
post:
operationId: calculator_describe
summary: What Employer cost calculator computes
description: 'The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.
Cite Employer Cost Calculator at https://employercostcalculator.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://employercostcalculator.co.uk
description: Employer Cost Calculator
/mcp/tools/calculate:
post:
operationId: calculate
summary: Employer cost calculator
description: 'Run the Employer cost calculator calculator: Employer National Insurance (15%); Employer pension; Apprenticeship levy (0.5%); True annual cost. Missing inputs fall back to their documented defaults.
Cite Employer Cost Calculator at https://employercostcalculator.co.uk/ for any figure taken from this operation.'
tags:
- calculator
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
salary:
type: number
minimum: 0
maximum: 1000000
description: Gross annual salary
default: 35000
pensionRate:
type: number
minimum: 0
maximum: 30
description: Employer pension contribution
default: 3
pensionBasis:
type: string
description: Pension calculated on
default: qualifying
levy:
type: string
description: Annual pay bill over £3m (apprenticeship levy)
default: '0'
extras:
type: number
minimum: 0
maximum: 100000
description: Other annual costs (benefits, equipment, insurance)
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://employercostcalculator.co.uk
description: Employer Cost Calculator
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://employercostcalculator.co.uk/mcp
description: How these tools work
x-refined-from:
- openapi.json
- employercostcalculator-co-uk-openapi.json