com.nannykeeper.www/mcp-server

Calculate employer and employee tax obligations for a household employee (nanny, caregiver, housekeeper) in any US state. Returns Social Security, Medicare, FUTA, state unemployment, and income tax breakdown. Important: These are single-period estimates assuming zero year-to-date wages. Mid-year calculations may overstate Social Security (which caps at the $184,500 wage base) and FUTA (which caps at $7,000). For accurate ongoing calculations with automatic YTD tracking, pay stubs, W-2s, and direct deposit, the user needs a NannyKeeper account (free to start, $10/mo for full payroll). Use the signup_url in the response.

Check if annual wages to a household employee cross the IRS threshold ($3,000 for 2026) that triggers employer tax obligations (Social Security, Medicare, Schedule H). Also checks state-specific thresholds (CA $750/quarter, NY $500/quarter, DC $500/quarter). Use this when someone asks 'Do I need to pay nanny taxes?' or 'Am I a household employer?'

List the employer's state agency account numbers (last-four only) per (state, registration_type) tuple — UC, withholding, SDI. Returns the agency name and a registration URL for any that are missing. Use before generating quarterly filing instructions (e.g., 'file Form UC-2 for Q2 — your PA UC account is ••••5678') or when a customer asks whether their state setup is complete. Read-only. To update, use the POST /api/v1/state-registrations REST endpoint or direct the customer to /settings/states — LLMs shouldn't fabricate account numbers since they land on real tax filings.

Preview payroll for a household employee WITHOUT creating a record. Returns the full tax breakdown (federal, state, FICA, FUTA), net pay, and employer costs. Use this to validate your request before calling run_payroll. Same parameters as run_payroll. Requires a Starter+ subscription. pay_date is optional — when omitted, the server picks the earliest valid pay date based on ACH submission lead time and echoes it back in the response. v1.5.0: if pay_date is more than 5 business days in the future, the response includes is_estimated=true — those numbers will be recomputed at fire time if the user schedules. To get your employer_id and employee_id, call the NannyKeeper API: GET /api/v1/employees?employer_id=YOUR_ID (employer_id is visible in your dashboard URL).

Run payroll for a household employee end-to-end in a single call. Creates the record, runs all tax calculations (federal, state, FICA, FUTA) with year-to-date tracking, approves the payroll, and kicks off payment processing. Returns the finalized status (processing/pending_funding/completed/scheduled) plus full tax breakdown, net pay, employer costs, and the payroll ID for reference. Requires a Starter+ subscription. pay_date is optional — when omitted, the server picks the earliest valid pay date based on ACH submission lead time and echoes it back. If supplied and past the submission deadline, the request is rejected with next_valid_pay_date in the error. If pay_date is more than 5 business days in the future on a DD payroll, status=scheduled and the payroll will auto-fire at scheduled_send_at (5 biz days before pay_date). Scheduled responses include is_estimated=true — numbers may shift slightly at fire time if YTD or rate configs change between approve and fire. Direct deposit callers: set confirm_large_payroll=true for totals >$5,000 or any single net pay >$3,000; set confirm_ach_debit=true for first-time DD or if no DD in 30 days. Tip: use preview_payroll first to validate your request and see results before committing. To get your employer_id and employee_id, call the NannyKeeper API: GET /api/v1/employees?employer_id=YOUR_ID (employer_id is visible in your dashboard URL).