Enrolling in a Dependent Care FSA?How to claim up to $7,500
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.

Encrypted SSNs and account numbers
All 50 states
IRS-compliant data
# Install the MCP server
claude mcp add nannykeeper \
  --env NANNYKEEPER_API_KEY=nk_live_YOUR_KEY \
  -- npx -y @nannykeeper/mcp-server@latest

# 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. Pro 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 \
  --env NANNYKEEPER_API_KEY=nk_live_YOUR_KEY \
  -- npx -y @nannykeeper/mcp-server@latest

# 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

2 months free

Starter

For 1 employee

$8/month

$100/year

Get started

Includes:

  • 1 household employee
  • Unlimited payroll runs
  • Federal + state tax calculations
  • Professional pay stubs
  • Employee portal (W-4 & SSN)
  • W-2 & Schedule H generation
  • 500 API requests/day
Direct Deposit$8/transfer+0.8% over $1,000

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 + 0.8% over $1,000)
  • Priority email support
  • 2,000 API requests/day
Direct Deposit$6/transfer+0.8% over $1,000
For Developers

Pro

For CPAs & developers

$25/month

$300/year · 5 employees per household included, then $60/yr each

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+0.8% over $1,000

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
Encrypted SSNs and account numbers
AES-256 encryption
Secure data storage

Who it's for

Not just nannies

Someone you pay to work in your home is your household employee when you can control what work is done and how it is done. The API calculates taxes for each of them with the same endpoint and the same accuracy.

Nanny

Full-time, part-time, or live-in. At $3,000+ per nonexempt worker in 2026, the API assesses Social Security and Medicare; FUTA and state taxes use their own inputs and tests.

Housekeeper

A house cleaner is your employee when you can control not only what work is done but how it is done; one who runs their own business, brings their own tools and offers their services to the public is usually self-employed. For an employee, the API works the same way: pass the state and wages, get the breakdown.

Read the guide

Senior Caregiver

A home aide or companion you hire directly is usually a household employee. Same API call, same tax engine, and wages for nursing-type care may be deductible as a medical expense if you itemize.

Read the guide

Family Member

Paying a family member? Your spouse, your child under 21 and your parent are exempt from some federal taxes. The calculator and threshold endpoints don't ask who you're paying, so they assume no exemption applies and note that one might. Payroll run through an account uses the relationship saved on the employee.

Read the guide

Other Staff

Cooks, personal assistants, gardeners, and estate managers can be household employees when the family controls the work. The $3,000 figure is the 2026 per-worker FICA test, not the classification test.

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, employer Social Security (6.2%) and Medicare (1.45%) generally apply when one nonexempt household employee reaches $3,000. Schedule H can also be triggered by the separate FUTA test ($1,000 in cash wages in any calendar quarter of this year or last year) or federal income-tax withholding. State thresholds and family exceptions are separate.
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.
In Claude Code, run claude mcp add nannykeeper --env NANNYKEEPER_API_KEY=nk_live_YOUR_KEY -- npx -y @nannykeeper/mcp-server@latest. In Claude Desktop, add @nannykeeper/mcp-server to your config with your API key as an environment variable. Anyone can use the tax tools (calculate_nanny_taxes, check_threshold). With a Starter plan, an agent can also list your employees, preview and run payroll, read payrolls and get pay stubs.
Yes — the Pro tier ($30/month, 5 employees per household included, then $6/mo each) 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: November 2026

Start building with NannyKeeper

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