Quarterly taxes due April 15 We'll calculate what you owe and remind you before every deadline.Calculate now →

Skip to main content

API Changelog

All notable changes to the NannyKeeper API, newest first.

v1.0.0Initial release

Public endpoints (no account required)

  • POST /v1/calculate — calculate household employer taxes for a single pay period across all 50 states
  • GET /v1/threshold — check if annual wages cross the IRS FICA threshold ($3,000 for 2026) and state-specific thresholds

Authenticated endpoints (Starter and above)

  • POST /v1/payroll/run — run payroll for one or more employees with YTD tax tracking
  • GET /v1/payroll/:id — retrieve a completed payroll by ID
  • GET /v1/employees — list employees for an employer (cursor-based pagination, PII-safe)
  • POST /v1/employees — create a new employee
  • GET /v1/employers — list all employers in your organization (Professional)
  • POST /v1/employers — create a new employer in your organization (Professional)
  • GET /v1/employers/:id/dd-status — check direct deposit readiness
  • POST /v1/documents/paystub — generate a pay stub PDF for a completed payroll
  • POST /v1/documents/w2 — generate a W-2 for a given tax year
  • POST /v1/ach/transfer — initiate direct deposit ACH transfer (Plus and above)

MCP server

  • Published @nannykeeper/mcp-server to npm
  • Supports calculate_nanny_taxes and check_threshold tools via stdio transport
  • Compatible with Claude Desktop, Cursor, and any MCP-compliant client

Rate limits

  • Free tier: 50 requests/day
  • Starter: 500 requests/day
  • Plus: 2,000 requests/day
  • Professional: 2,000 requests/day