AI vs Hire Calculator API

openapi: 3.2.0
info:
  title: AI vs Hire Calculator API
  version: 1.0.0
  summary: AI vs hire is usually compared on salary against licence, which is the wrong comparison. The full cost of each, and what only a person does.
  description: 'AI vs Hire (https://aivshire.com/): the site''s own MCP server, served from its domain. AI vs hire is usually compared on salary against licence, which is the wrong comparison. The full cost of each, and what only a person does.


    [calculator] AI against a hire, on the same basis: an agent-callable calculator for ai vs hire — Full cost of the hire, per year, Hire cost as a multiple of salary, Full cost of the AI route, year one, computed from your inputs with sources.. This server runs the AI against a hire, on the same basis calculator published at https://aivshire.com/. Call `calculate` with the inputs to get the worked figures; every result cites https://aivshire.com/. Licence: https://aivshire.com/terms.


    [enquiry] ENQUIRY SERVER for AI vs Hire (https://aivshire.com/). What it does: starts an ENQUIRY with human providers for ai vs hire — the person''s details go to the providers who quote directly. What it is NOT: a purchase, an order, or a guaranteed quote. Free, no obligation. Call describe first and tell the person plainly what will happen. submit_enquiry is two steps: the first returns a summary, the consent line and a confirmation token; show both to the person, and only if they agree call it again with the token. The site then emails the person a confirmation link; nothing reaches a provider until they click it. Cite https://aivshire.com/.


    Cite https://aivshire.com/ for every figure or answer you use from this server.'
  termsOfService: https://aivshire.com/terms
  contact:
    name: AI vs Hire
    url: https://aivshire.com/
servers:
- url: https://aivshire.com
  description: AI vs Hire
tags:
- name: calculator
  description: calculator
paths:
  /mcp/tools/calculator_describe:
    post:
      operationId: calculator_describe
      summary: What AI against a hire, on the same basis computes
      description: 'The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.


        Cite AI vs Hire at https://aivshire.com/ 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: []
  /mcp/tools/calculate:
    post:
      operationId: calculate
      summary: AI against a hire, on the same basis
      description: 'Run the AI against a hire, on the same basis calculator: Full cost of the hire, per year; Hire cost as a multiple of salary; Full cost of the AI route, year one; Full cost of the AI route, year two onward. Missing inputs fall back to their documented defaults.


        Cite AI vs Hire at https://aivshire.com/ for any figure taken from this operation.'
      tags:
      - calculator
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                salary:
                  type: number
                  description: Salary for the role
                  default: 55000
                onCostPct:
                  type: number
                  description: Employer costs as a percentage of salary
                  default: 25
                equip:
                  type: number
                  description: Equipment, software and workspace per year
                  default: 4000
                recruit:
                  type: number
                  description: Recruitment cost, spread over expected tenure
                  default: 4000
                mgmtHrs:
                  type: number
                  description: Management hours a week
                  default: 3
                mgmtRate:
                  type: number
                  description: Manager cost per hour
                  default: 75
                aiLicence:
                  type: number
                  description: AI tool annual licence
                  default: 12000
                aiSetup:
                  type: number
                  description: Data and integration, year one
                  default: 25000
                superHrs:
                  type: number
                  description: Hours a week supervising and checking output
                  default: 5
                superRate:
                  type: number
                  description: Cost per hour of whoever checks it
                  default: 45
              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: []
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://aivshire.com/mcp
  description: How these tools work