{
  "$schema": "https://modelcontextprotocol.io/schema/2024-11-05/server.json",
  "name": "ai-receptionist-mcp-server",
  "title": "AI-Reception.ist Voice Telephony MCP Server",
  "description": "Model Context Protocol tools for testing, simulating, and estimating autonomous AI phone receptionists, call flows, and telephony integrations.",
  "version": "1.0.0",
  "homepage": "https://ai-reception.ist",
  "tools": [
    {
      "name": "simulate_call_flow",
      "description": "Simulate an interactive inbound or outbound voice call flow for a specific industry (Healthcare, Legal, Real Estate, E-Commerce, Dental, etc.).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "industry": {
            "type": "string",
            "enum": [
              "healthcare",
              "medical-tourism",
              "dental-implant",
              "hair-implant",
              "eye-surgery",
              "esthetic",
              "legal",
              "real-estate",
              "e-commerce",
              "education",
              "software",
              "personnel-concierge"
            ],
            "description": "The target industry vertical."
          },
          "callerIntent": {
            "type": "string",
            "description": "The simulated caller's goal (e.g., 'Book emergency dental appointment', 'Inquire about hair graft cost', 'Schedule property showing')."
          },
          "language": {
            "type": "string",
            "default": "en",
            "description": "Language code (en, tr, es, de, fr, ar)."
          }
        },
        "required": ["industry", "callerIntent"]
      }
    },
    {
      "name": "calculate_telephony_roi",
      "description": "Calculate estimated monthly cost savings, recovered missed call revenue, and receptionist hours saved.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "monthlyCallVolume": {
            "type": "number",
            "description": "Average inbound calls per month (e.g. 1500)."
          },
          "averageCallDurationMinutes": {
            "type": "number",
            "default": 3,
            "description": "Average call length in minutes."
          },
          "humanHourlyRate": {
            "type": "number",
            "default": 25,
            "description": "Average hourly wage of front-desk personnel in USD."
          },
          "missedCallPercentage": {
            "type": "number",
            "default": 22,
            "description": "Estimated percentage of calls currently unanswered during peak or after-hours."
          }
        },
        "required": ["monthlyCallVolume"]
      }
    },
    {
      "name": "test_voice_prompt",
      "description": "Validate and test a proposed AI Receptionist system prompt against telephony constraints (latency, tone, objection handling, HIPAA boundary checks).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "systemPrompt": {
            "type": "string",
            "description": "The raw prompt instructions for the AI receptionist."
          },
          "provider": {
            "type": "string",
            "enum": ["retell", "vapi", "livekit", "daily", "twilio", "openai_realtime", "custom_sip"],
            "default": "retell"
          }
        },
        "required": ["systemPrompt"]
      }
    },
    {
      "name": "get_provider_capabilities",
      "description": "Retrieve supported telephony codecs, VAD thresholds, TTS voices, and transfer protocols for a specific telephony provider.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string",
            "enum": ["retell", "vapi", "livekit", "daily", "twilio", "openai_realtime", "custom_sip"]
          }
        },
        "required": ["provider"]
      }
    }
  ]
}
