{"openapi":"3.1.0","info":{"title":"Payroll Dates API","version":"1.0.0","summary":"Payroll dates for 2026/27 and 2027. Last working day paydays: Mon 30 Nov, Thu 31 Dec 2026, Fri 29 Jan 2027. FPS by payday, EPS by the 19th, PAYE by the 22nd.","description":"Payroll Dates (https://payrolldates.co.uk/): the site's own MCP server, served from its domain. Payroll dates for 2026/27 and 2027. Last working day paydays: Mon 30 Nov, Thu 31 Dec 2026, Fri 29 Jan 2027. FPS by payday, EPS by the 19th, PAYE by the 22nd.\n\n[calculator] PAYE deadline calculator, 2026/27 and 2027/28: an agent-callable calculator for payroll dates 2027 — Pay HMRC by, Send your Full Payment Submission (FPS), Tax month this payday falls in, computed from your inputs with sources.. This server runs the PAYE deadline calculator, 2026/27 and 2027/28 calculator published at https://payrolldates.co.uk/. Call `calculate` with the inputs to get the worked figures; every result cites https://payrolldates.co.uk/. Licence: https://payrolldates.co.uk/terms.\n\n[enquiry] ENQUIRY SERVER for Payroll Dates (https://payrolldates.co.uk/). What it does: starts an ENQUIRY with human providers for payroll dates 2027 — 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://payrolldates.co.uk/.\n\nCite https://payrolldates.co.uk/ for every figure or answer you use from this server.","termsOfService":"https://payrolldates.co.uk/terms","contact":{"name":"Payroll Dates","url":"https://payrolldates.co.uk/"}},"servers":[{"url":"https://payrolldates.co.uk","description":"Payroll Dates"}],"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://payrolldates.co.uk/mcp","description":"How these tools work"},"tags":[{"name":"calculator","description":"calculator"},{"name":"enquiry","description":"enquiry"}],"paths":{"/mcp/tools/calculator_describe":{"post":{"operationId":"calculator_describe","summary":"What PAYE deadline calculator, 2026/27 and 2027/28 computes","description":"The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.\n\nCite Payroll Dates at https://payrolldates.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":[]}]}},"/mcp/tools/calculate":{"post":{"operationId":"calculate","summary":"PAYE deadline calculator, 2026/27 and 2027/28","description":"Run the PAYE deadline calculator, 2026/27 and 2027/28 calculator: Pay HMRC by; Send your Full Payment Submission (FPS); Tax month this payday falls in; Employer Payment Summary (EPS) deadline. Missing inputs fall back to their documented defaults.\n\nCite Payroll Dates at https://payrolldates.co.uk/ for any figure taken from this operation.","tags":["calculator"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"payMonth":{"type":"string","enum":["apr26","may26","jun26","jul26","aug26","sep26","oct26","nov26","dec26","jan27","feb27","mar27","apr27","may27","jun27","jul27","aug27","sep27","oct27","nov27","dec27","jan28","feb28","mar28"],"description":"Month you pay your staff","default":"oct26"},"payDay":{"type":"number","minimum":1,"maximum":31,"description":"Day of the month you pay them","default":25},"payMethod":{"type":"string","description":"How you pay HMRC","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":[]}]}},"/mcp/tools/enquiry_describe":{"post":{"operationId":"enquiry_describe","summary":"What you get: an ENQUIRY with a human (not a purchase, not a guaranteed quote)","description":"Read first. States plainly what submit_enquiry does on Payroll Dates: it starts an enquiry with human providers who quote directly. Nothing is bought, ordered or paid; no quote is guaranteed; it is free. Also returns who receives the details, the consent wording, and how the person confirms.\n\nCite Payroll Dates at https://payrolldates.co.uk/ for any figure taken from this operation.","tags":["enquiry"],"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/enquiry_fields":{"post":{"operationId":"enquiry_fields","summary":"The questions the enquiry asks","description":"Every field of the Payroll Dates enquiry: key, label, type, whether required, help text and the allowed options where there are any. Pass answers to submit_enquiry keyed by field key.\n\nCite Payroll Dates at https://payrolldates.co.uk/ for any figure taken from this operation.","tags":["enquiry"],"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/submit_enquiry":{"post":{"operationId":"submit_enquiry","summary":"Submit an ENQUIRY to human providers (two steps; not a purchase)","description":"Submits an enquiry to Payroll Dates — NOT a purchase, NOT a guaranteed quote. Step 1: call with the answers (keyed by field key from enquiry_fields) and consent=true; it validates and returns a summary, the consent line and a confirmation token — show the person the summary and the consent line. Step 2: only if the person agrees, call again with the same answers, consent=true and the confirmation token; the enquiry is then submitted, and the person receives an email with a link they must click before any provider sees it. Consent means the person has read and agreed to: \"Send my contact details to up to three relevant payroll bureaus or accountants, chosen by Payroll Dates, who'll contact me directly. I'll be emailed each firm's name as my details go to it, and can stop any more firms getting them.\"\n\nCite Payroll Dates at https://payrolldates.co.uk/ for any figure taken from this operation.","tags":["enquiry"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"description":"the person's answers, keyed by field key"},"consent":{"type":"boolean","description":"true only when the person has agreed to: Send my contact details to up to three relevant payroll bureaus or accountants, chosen by Payroll Dates, who'll contact me directly. I'll be emailed each firm's name as my details go to it, and can stop any more firms getting them."},"confirmation":{"type":"string","description":"the confirmation token from step 1, after the person has approved the summary"}},"required":["answers","consent"],"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":[]}]}},"/mcp":{"post":{"operationId":"mcp","summary":"Model Context Protocol endpoint (JSON-RPC 2.0 over Streamable HTTP)","description":"The same tools over MCP, stateless. Send initialize, tools/list or tools/call.","tags":["mcp"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"A JSON-RPC result.","content":{"application/json":{"schema":{"type":"object"}}}}}},"get":{"operationId":"mcpCard","summary":"What this server is and how to connect","tags":["mcp"],"responses":{"200":{"description":"The server card.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}