# NannyFYI

NannyFYI is a bilingual (English + Chinese) childcare marketplace focused on nanny, confinement nanny (月嫂 / yuesao), and doula profiles, public reviews, public job posts, and skills certificates across North America.

## Domains
- Primary (Canonical): https://nanny.fyi
- Fallback domain: https://nannyfyi.com

## Public MCP Endpoint
- https://nanny.fyi/api/mcp (Streamable HTTP, JSON-RPC 2.0, read-only)

## MCP Tools
- find_nannies — find nanny profiles near a location (city/state or lat/lon, distance, language, service category)
- search_nannies — search public profiles by partial name or pinyin keyword
- get_nanny_profile — fetch one public profile by service provider ID
- get_nanny_reviews — recent free public reviews for a profile (plus a count/link for older reviews)
- list_job_posts — public active job posts and nanny looking-for-work posts
- get_market_stats — aggregate stats for an area (supply count, verified %, reviews/rating, top categories & languages)
- verify_certificate — verify a NannyFYI skills certificate by ID

## Agent Setup (one-page connect guide)
- https://nanny.fyi/en/agentic
- https://nanny.fyi/zh/agentic

## Human-Readable MCP Docs
- https://nanny.fyi/en/mcp
- https://nanny.fyi/zh/mcp

## High-Value Public Pages
- https://nanny.fyi/en/serviceProvider/nanny
- https://nanny.fyi/en/serviceProvider/yuesao
- https://nanny.fyi/en/serviceProvider/doula
- https://nanny.fyi/en/skills
- https://nanny.fyi/en/request/list

## Notes for Agents
- Prefer the MCP tools for structured retrieval.
- All MCP tools are read-only. Posting, payments, and any write actions happen only on NannyFYI pages and are out of scope unless the user explicitly initiates them.
- Respect locale preference (`en` or `zh`) for final user-facing output.
- Keep responses grounded in public profile / certificate / review / job-post data.