NannyFYI MCP Integration Guide

Endpoint

https://nanny.fyi/api/mcp

Supported Methods

• initialize
• ping
• resources/list
• resources/read
• tools/list
• tools/call

Tools

• find_nannies: Search nearby nanny profiles.
• search_nannies: Search public profiles by name or pinyin keywords.
• get_nanny_reviews: Read recent free public reviews and link to older review access.
• list_job_posts: List public job and caregiver-available posts.
• verify_certificate: Verify a skills certificate ID.
• get_market_stats: Aggregate area stats (supply, verified share, reviews/rating, category & language breakdowns).
• get_nanny_profile: Fetch one public profile by provider ID.

Agent Setup

For setup instructions for Claude Code, ChatGPT, Codex, Cursor, Gemini CLI, and other MCP clients, use the user-facing guide.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05"
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

Tool Call Examples

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "find_nannies",
    "arguments": {
      "top": 5,
      "country": "US",
      "state": "CA",
      "city": "Sunnyvale",
      "distance": 30,
      "language": "Mandarin"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "verify_certificate",
    "arguments": {
      "certificateId": "ABCD1234"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "get_nanny_profile",
    "arguments": {
      "id": "6366c7c954c9536d6c04bc35"
    }
  }
}