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

Skip to main content

Nanny tax API for
AI agents & developers

The only household employer tax engine with an API. Calculate Social Security, Medicare, FUTA, and state taxes for all 50 states — programmatically.

Free tier: 50 requests/day. No credit card required.

Get Free API KeyTry It Now
Bank-level security
All 50 states
IRS-compliant data
# Install the MCP server
claude mcp add nannykeeper \
  npx @nannykeeper/mcp-server \
  -e NANNYKEEPER_API_KEY=nk_live_YOUR_KEY

# Then just ask Claude:
# "How much would I owe in taxes if I pay
#  my nanny $35,000/year in California?"

Built for every use case

Whether you're an AI agent, a tax preparer, or a developer building a product — the API has you covered.

For AI Agents

Let Claude, ChatGPT, or any AI assistant calculate nanny taxes in conversation. MCP server included — install in 30 seconds.

For Tax Preparers

Manage payroll for all your household employer clients from one dashboard and one API key. Professional tier supports up to 50 employers.

For Developers

Build household payroll into your app. Full REST API for calculations, payroll processing, W-2 generation, and direct deposit.

See it in action

This calls the same POST /api/v1/calculate endpoint your app or AI agent would use.

Try the API

$

Calls POST /api/v1/calculate — the same endpoint your app or AI agent would use.

ResponseJSON

Click “Calculate” to see the API response

Works with any language

Calculate your first nanny paycheck in 5 lines of code.

# Install the MCP server
claude mcp add nannykeeper \
  npx @nannykeeper/mcp-server \
  -e NANNYKEEPER_API_KEY=nk_live_YOUR_KEY

# Then just ask Claude:
# "How much would I owe in taxes if I pay
#  my nanny $35,000/year in California?"

What the API covers

50-State Tax Engine

  • Federal income tax (IRS Pub 15-T)
  • Social Security + Medicare (FICA)
  • FUTA (federal unemployment)
  • State income tax (all 50 + DC)
  • State unemployment (SUI/SUTA)
  • SDI, PFL, local taxes

Full Payroll API

  • Run payroll with YTD tracking
  • Generate pay stub PDFs
  • Process direct deposit (ACH)
  • Employee management
  • W-4 tax elections
  • Threshold monitoring

Tax Documents

  • W-2 generation (all copies)
  • Schedule H preparation
  • Quarterly filing checklists
  • Tax deadline reminders
  • SS-4 (EIN application)
  • Pay period calculations

Simple, transparent pricing

API access included on every plan. Start free, upgrade when you need payroll.

When you're ready for full payroll

Save 17%

Starter

For 1 employee

$8/month

$100/year

Get Started

Includes:

  • 1 household employee
  • Unlimited payroll runs
  • Federal + state tax calculations
  • Professional pay stubs
  • W-2 & Schedule H generation
  • 500 API requests/day
Direct Deposit$8/transfer
Most Popular

Plus

For up to 5 employees

$15/month

$180/year

Get Started

Everything in Starter, plus:

  • Up to 5 household employees
  • Direct deposit ($6/transfer)
  • Employee W-4 self-service
  • Priority email support
  • 2,000 API requests/day
Direct Deposit$6/transfer

Professional

For CPAs & developers

$25/month + $6/employer

$300 + $72/employer/year

Get Started

Everything in Plus, plus:

  • Up to 50 employer accounts
  • Multi-employer API access
  • Manage all clients in one place
  • Build & resell products
  • 2,000 API requests/day
Direct Deposit$6/transfer

Just need calculations?

The free tier gives you 50 API requests/day — tax calculations and threshold checks for all 50 states. No credit card, no time limit. Compare all plans →

Get Free API Key
View full pricing comparison →
Bank-level security
AES-256 encryption
Secure data storage

Who it's for

Not just nannies

Anyone paid to work in a home is a household employee. The API calculates taxes for all of them — same endpoint, same accuracy.

Nanny

Full-time, part-time, or live-in. If you pay $3,000+ a year, the API calculates Social Security, Medicare, FUTA, and state taxes automatically.

Try the APIView API reference

Housekeeper

House cleaners are W-2 employees, not 1099 contractors. The API handles their taxes the same way — pass the state and wages, get the breakdown.

Read the guide

Senior Caregiver

A home aide or companion counts as a household employee. Same API call, same tax engine — and their wages may be deductible as a medical expense.

Read the guide

Family Member

Paying a parent or sibling? Some family members are exempt from certain taxes. The API accounts for relationship-based exemptions automatically.

Read the guide

Other Staff

Cooks, personal assistants, gardeners, estate managers, au pairs — if they're paid $3,000+ a year to work in a home, the same tax rules apply.

Read the guide

FAQ

Questions about the API

Use NannyKeeper's REST API: POST /api/v1/calculate with your state, annual wages, and pay frequency. The response includes a complete breakdown of Social Security, Medicare, FUTA, state unemployment, and income taxes. Free tier: 50 requests/day.
For 2026, if you pay a household employee $3,000 or more per year, you must pay employer Social Security (6.2%) and Medicare (1.45%) taxes, and file Schedule H with your personal 1040. Some states have lower thresholds: California $750/quarter, New York $500/quarter, DC $500/quarter.
Yes — the free tier includes 50 API requests per day for tax calculations and threshold checks. No credit card required. Paid tiers ($10-18/month) unlock payroll processing, document generation (W-2, pay stubs), and direct deposit.
Install via npx: add @nannykeeper/mcp-server to your Claude Desktop config with your API key as an environment variable. The server provides calculate_nanny_taxes and check_threshold tools that AI agents can use in conversation.
Yes — the Professional tier ($30/month + $6/employer) supports up to 50 employers and permits resale with "Powered by NannyKeeper" attribution. For white-label access without attribution, contact hello@nannykeeper.com.
All 50 US states plus DC. The API calculates federal taxes (Social Security, Medicare, FUTA, income tax) and state-specific taxes (state income tax, state unemployment, SDI, PFL, and local taxes where applicable). State configs are updated each tax year.
The free tier uses the same tax engine as our paid payroll product — same rates, same rules. The one limitation: free calculations assume zero year-to-date wages (single-period estimate). Mid-year calculations may differ slightly because SS wage base exhaustion and FUTA caps depend on YTD data. For ongoing accuracy, use a paid plan with YTD tracking.
You get a 429 response with a Retry-After header. Limits reset at midnight UTC. The response also includes X-RateLimit-Remaining and X-RateLimit-Reset headers on every request so you can track usage proactively.
Last updated: March 2026

Start building with NannyKeeper

Get your free API key and start calculating nanny taxes for all 50 states. No credit card required.

Get Free API KeySet Up MCP Server