Domestic Helper Agency System MCP tools support employer requirements, consultant follow-up, helper profiles, skills and availability, documents and expiry dates, medical and training status, match recommendations, interview scheduling, placement stages, contract documents, visa and immigration workflows, insurance, payments and pass-through charges, refunds, arrival handover, post-placement follow-up, replacement cases, and audit logs.
domestic_helper.config.get
readRead agency stages, consultant assignment, contract templates, document checklist, visa steps, payment milestones, and approval rules.
-
No approval required; read-only setup lookup.
Return tenant-scoped configuration only and hide integration credentials.
domestic_helper.consultants.list
readList consultants, teams, caseload, language skills, and assignment availability.
domestic_helper.config.get
No approval required; read-only consultant lookup.
Expose workload and contact fields only to authorized managers.
domestic_helper.employers.list
readList employers by consultant, state, requirements, budget, location, urgency, or follow-up date.
domestic_helper.config.get
No approval required; read-only employer lookup.
PII and household details must be scoped by consultant ownership and role.
domestic_helper.employer.get
readRead employer profile, household requirements, matching preferences, consent records, contracts, payments, and follow-up summary.
domestic_helper.employers.list
No approval required; read-only employer detail.
Mask identity/contact fields when caller lacks employer-case permission.
domestic_helper.household_requirements.get
readRead care needs for elderly/children/pets, chores, language, rest day, accommodation, salary, and acceptable conditions.
domestic_helper.employer.get
No approval required; read-only requirement detail.
Household data is sensitive and must not be used outside the case scope.
domestic_helper.helpers.list
readList helpers by source country, skill, experience, language, availability, salary, document state, or region.
domestic_helper.config.get
No approval required; read-only helper lookup.
Return only helper profiles the caller is allowed to view.
domestic_helper.helper.get
readRead helper profile, work history, skills, languages, expectations, restrictions, documents, interviews, and match history.
domestic_helper.helpers.list
No approval required; read-only helper detail.
Passport, identity, medical, and contact data require strict permission checks.
domestic_helper.helper_availability.list
readList helper availability for interviews, contract, departure, matched, held, or unavailable windows.
domestic_helper.helper.get
No approval required; read-only availability lookup.
Availability must include current placement lock and timestamp.
domestic_helper.helper_documents.list
readList helper identity, passport, contract, reference, photo, certificate, and expiry records.
domestic_helper.helper.get
No approval required; read-only document metadata lookup.
Do not return raw file URLs unless caller has document permission.
domestic_helper.helper_training_medical.list
readList medical, vaccination, training, skill test, insurance, and completion/expiry state.
domestic_helper.helper.get
No approval required; read-only medical/training status.
Medical data is highly sensitive and must be minimized and role-scoped.
domestic_helper.match_candidates.list
readList recommendable helpers for employer requirements with reasons, gaps, risks, and consultant notes.
domestic_helper.household_requirements.get, domestic_helper.helpers.list
No approval required; read-only candidate shortlist.
Recommendations must be explainable and avoid unsupported claims.
domestic_helper.match.get
readRead match case, recommendation reasons, stage, interviews, employer feedback, helper feedback, and next step.
domestic_helper.match_candidates.list
No approval required; read-only match detail.
Do not expose other employers attached to the same helper unless authorized.
domestic_helper.interviews.list
readList interviews by employer, helper, consultant, time, channel, state, or outcome.
domestic_helper.match.get
No approval required; read-only interview lookup.
Interview records must be scoped to the active case.
domestic_helper.interview.get
readRead interview schedule, link, timezone, questions, employer notes, helper response, recordings/files, and outcome.
domestic_helper.interviews.list
No approval required; read-only interview detail.
Recordings and notes require consent and role permission.
domestic_helper.placements.list
readList selected or active placements with stage, consultant, contract, visa, and payment state.
domestic_helper.employer.get, domestic_helper.helper.get
No approval required; read-only placement lookup.
Placements expose both employer and helper data; enforce both-side permissions.
domestic_helper.placement.get
readRead full placement workflow: match, interviews, contract, visa, payments, arrival, follow-up, and replacement state.
domestic_helper.placements.list
No approval required; read-only placement detail.
Return only fields allowed by the caller role and case ownership.
domestic_helper.contracts.list
readList contracts by employer, helper, placement, state, signing, version, or expiry date.
domestic_helper.placement.get
No approval required; read-only contract lookup.
Contract visibility requires case and document permissions.
domestic_helper.contract.get
readRead contract terms, salary, rest day, allowance, insurance, employer/helper data, signing, and version.
domestic_helper.contracts.list
No approval required; read-only contract detail.
Always show contract version and signature state to prevent stale documents.
domestic_helper.visa_cases.list
readList visa cases by placement, employer, helper, state, deadline, delay risk, or next step.
domestic_helper.placements.list
No approval required; read-only visa case lookup.
Visa data includes identity data and must be role-scoped.
domestic_helper.visa_case.get
readRead visa case, documents, submission, medical, insurance, immigration approval, arrival, and handover state.
domestic_helper.visa_cases.list
No approval required; read-only visa case detail.
Do not expose passport or medical files unless explicitly permitted.
domestic_helper.document_checklist.list
readList required documents and rules for employer, helper, contract, visa, insurance, and arrival.
domestic_helper.config.get, domestic_helper.placement.get
No approval required; read-only checklist lookup.
Show missing/expired/rejected states separately.
domestic_helper.documents.list
readList case documents, type, version, expiry date, review state, rejection reason, and re-upload request.
domestic_helper.document_checklist.list
No approval required; read-only document metadata lookup.
Raw files require separate permission and access logging.
domestic_helper.payments_invoices.list
readList service fees, pass-through charges, payment milestones, payments, partial payments, refunds, and balances.
domestic_helper.placement.get
No approval required; read-only billing lookup.
Payment and bank references require finance permission.
domestic_helper.invoice.get
readRead invoice, lines, payments, refunds, reconciliation, pass-through source, and dunning history.
domestic_helper.payments_invoices.list
No approval required; read-only invoice detail.
Invoice lines must show source placement or pass-through record.
domestic_helper.follow_ups.list
readList post-placement follow-ups, arrival preparation, first-week check-ins, complaints, reminders, and closure tasks.
domestic_helper.placement.get
No approval required; read-only follow-up lookup.
Complaints and private notes require strict role visibility.
domestic_helper.replacement_cases.list
readList replacement requests, contract terms, eligibility, reason, state, fee, and next step.
domestic_helper.placement.get, domestic_helper.contract.get
No approval required; read-only replacement lookup.
Replacement eligibility must reference contract terms and approval state.
domestic_helper.pipeline_report.get
readRead summary for employer requirements, matches, interviews, contracts, visa, arrival, payments, and consultant workload.
domestic_helper.placements.list, domestic_helper.visa_cases.list
No approval required; read-only pipeline report.
Aggregate where possible and protect consultant/client personal data.
domestic_helper.audit_logs.list
readList audit logs for employers, helpers, matches, interviews, contracts, documents, visa, payments, replacement, and notices.
domestic_helper.config.get
No approval required for authorized auditors; read-only audit lookup.
Audit logs must be immutable and include actor, source, before/after, approval id, and result.
domestic_helper.match.preview
previewPreview whether helper match fits employer requirements, gaps, restrictions, documents, interview availability, and risks.
domestic_helper.household_requirements.get, domestic_helper.helper.get
No approval required; preview only and does not create match.
Expose reasons and missing data; do not make unsupported suitability claims.
domestic_helper.interview_schedule.preview
previewPreview interview time, channel, timezone, participants, translation needs, conflicts, and notice content.
domestic_helper.match.get, domestic_helper.helper_availability.list
No approval required; preview only and does not schedule interview.
Do not send meeting links or messages from preview.
domestic_helper.contract_package.preview
previewPreview contract package data, employer/helper fields, salary, allowance, insurance, fees, document gaps, and signing steps.
domestic_helper.placement.get, domestic_helper.document_checklist.list
No approval required; preview only and does not create contract.
Flag missing identity/document data before contract generation.
domestic_helper.visa_timeline.preview
previewPreview visa submission, document collection, medical, insurance, immigration approval, arrival date, and delay risk.
domestic_helper.visa_case.get, domestic_helper.documents.list
No approval required; preview only and does not update visa case.
Timeline is an estimate; show assumptions and pending blockers.
domestic_helper.document_completeness.preview
previewPreview whether case documents are complete, expired, rejected, need re-upload, or block contract/visa.
domestic_helper.document_checklist.list, domestic_helper.documents.list
No approval required; preview only and does not approve documents.
Do not treat unreadable or missing files as complete.
domestic_helper.payment_schedule.preview
previewPreview service fee, pass-through charges, payment milestones, discounts, refunds, balances, and payment reminders.
domestic_helper.placement.get, domestic_helper.payments_invoices.list
No approval required; preview only and does not create invoice or payment.
Show source fee rules and avoid duplicate charges.
domestic_helper.replacement_eligibility.preview
previewPreview replacement eligibility against contract, deadline, reason, fee, existing complaints, and approval needs.
domestic_helper.placement.get, domestic_helper.contract.get, domestic_helper.replacement_cases.list
No approval required; preview only and does not open replacement case.
Eligibility must cite contract terms and current case status.
domestic_helper.action_request.status
statusCheck approval, execution, failure, rollback, or partial-completion state for domestic helper write actions.
action_request_id
No approval required; status lookup for submitted actions.
Return only action requests visible to the caller.
domestic_helper.employer.upsert
writeCreate or update employer profile, contacts, consent records, consultant, state, and follow-up ownership.
domestic_helper.employer.get, domestic_helper.employers.list
Approval required when changing contact, consent, owner, or case status.
Validate duplicate employers and preserve before/after audit for PII.
domestic_helper.requirement.upsert
writeCreate or update household needs, care targets, skill requirements, salary, rest day, accommodation, and preferences.
domestic_helper.household_requirements.get, domestic_helper.employer.get
Approval required when requirement changes affect active matches.
Keep requirement history so match decisions remain traceable.
domestic_helper.helper.upsert
writeCreate or update helper profile, experience, skills, languages, expected salary, restrictions, and availability state.
domestic_helper.helper.get, domestic_helper.helpers.list
Approval required when changing availability, restriction, or public profile claims.
Do not overwrite identity-sensitive data without document-backed audit.
domestic_helper.helper_availability.update
writeUpdate helper interviewable, held, matched, unavailable, contractable, or departure-ready state.
domestic_helper.helper_availability.list, domestic_helper.helper.get
Approval required when state affects active matches or placements.
Prevent double-hold and conflicting placement locks.
domestic_helper.document.upload
writeUpload or update employer/helper/contract/visa document, version, expiry date, type, and review state.
domestic_helper.documents.list, domestic_helper.document_checklist.list
Approval required for identity, passport, medical, contract, or visa documents.
Scan and permission-scope files; log file access and version changes.
domestic_helper.match.create
writeCreate employer-helper match with recommendation reasons, gaps, risks, consultant, and next step.
domestic_helper.match.preview, domestic_helper.match_candidates.list
Consultant approval required before match is shown to employer.
Require explainable reasons and avoid unsupported suitability claims.
domestic_helper.match_stage.update
writeUpdate match stage, employer/helper intent, rejection reason, hold state, and next step.
domestic_helper.match.get
Approval required when stage locks helper, rejects candidate, or triggers contract workflow.
Stage changes must preserve previous outcome and reason.
domestic_helper.interview.schedule
writeSchedule employer-helper interview with meeting, translation arrangement, reminders, and notices.
domestic_helper.interview_schedule.preview, domestic_helper.match.get
Approval required before sending interview invitation or meeting link.
Respect consent, timezone, and duplicate schedule checks.
domestic_helper.interview_result.record
writeRecord interview outcome, score, employer intent, helper intent, rejection reason, and next step.
domestic_helper.interview.get
Approval required when result advances to placement or rejects helper.
Separate factual result from subjective notes and keep audit history.
domestic_helper.placement.confirm
writeConfirm placement and lock employer, helper, consultant, contract preparation, document collection, and payment milestones.
domestic_helper.placement.get, domestic_helper.match.get, domestic_helper.payment_schedule.preview
Manager approval required before placement confirmation.
Prevent double-placement and ensure both parties have current consent/status.
domestic_helper.contract.create
writeGenerate contract package, version, signing tasks, and required documents from confirmed placement.
domestic_helper.contract_package.preview, domestic_helper.placement.get
Approval required before contract package creation or client-facing release.
Block contract creation when required identity fields or documents are missing.
domestic_helper.contract_signing.update
writeUpdate employer/helper signing state, signing date, version, refusal reason, and re-sign request.
domestic_helper.contract.get
Approval required when signing state advances workflow or changes contract version.
Never overwrite prior signed versions; append versioned signing records.
domestic_helper.visa_case.create
writeCreate visa/immigration case, steps, document requirements, target dates, and owner for placement.
domestic_helper.visa_timeline.preview, domestic_helper.placement.get
Approval required before visa case creation or submission tracking starts.
Require confirmed placement and contract readiness before visa workflow.
domestic_helper.visa_step.update
writeUpdate visa submission, document collection, medical, insurance, approval, arrival, or handover step.
domestic_helper.visa_case.get, domestic_helper.document_completeness.preview
Approval required for submission, approval, rejection, arrival, or handover milestones.
Preserve official dates, references, and before/after status.
domestic_helper.medical_training.update
writeUpdate helper medical, vaccination, training, skill test, insurance, or related expiry dates.
domestic_helper.helper_training_medical.list, domestic_helper.helper.get
Approval required for medical, insurance, or certification status changes.
Medical data must be minimized, permission-scoped, and auditable.
domestic_helper.invoice.create
writeCreate service fee, pass-through charge, visa fee, insurance fee, or other placement invoice.
domestic_helper.payment_schedule.preview, domestic_helper.payments_invoices.list
Finance approval required before invoice creation or release.
Prevent duplicate charges and show source fee rule.
domestic_helper.payment.record
writeRecord payment, partial payment, refund, reconciliation, unapplied receipt, or overdue follow-up.
domestic_helper.invoice.get, domestic_helper.payments_invoices.list
Finance approval required for payment application, reversal, refund, or write-off.
Keep payment references auditable and redact bank data by role.
domestic_helper.follow_up.create
writeCreate arrival preparation, first-week check-in, after-sales care, complaint, reminder, or closure task.
domestic_helper.follow_ups.list, domestic_helper.placement.get
Approval required for complaint escalation or closure.
Private complaint notes must not be sent to the wrong party.
domestic_helper.replacement_case.create
writeCreate replacement case with eligibility, reason, fee, contract basis, replacement workflow, and notices.
domestic_helper.replacement_eligibility.preview, domestic_helper.replacement_cases.list
Manager approval required before opening replacement case or promising eligibility.
Must cite contract terms and preserve complaint/replacement audit trail.
domestic_helper.notification.send
writeSend match, interview, document, visa, payment, arrival, follow-up, or replacement notices to employer, helper, or consultant.
domestic_helper.employer.get, domestic_helper.helper.get, domestic_helper.placement.get
Approval required for client/helper-facing, payment, visa, contract, or replacement notifications.
Respect consent, channel rules, templates, language, and duplicate-send suppression.