com.pearl.mcp/pearl-api-mcp-server

Official4 tools

Hybrid human + AI expertise for faster, trusted answers and decisions via MCP Server.

Combines human and AI expertise to provide trusted answers and decisions.

Captured live from the server via tools/list.

askPearlAi

Use this when the user wants a rapid AI-generated answer, draft, or alternative perspective on a low-risk or exploratory topic that does not require human validation. Do not use for medical, legal, financial, or safety-critical questions — use askExpert or askPearlExpert instead.

Parameters (3)

questionstringrequired
The user's question
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
sessionIdstring
Optional session ID for continuing a conversation

askPearlExpert

Use this when the problem is complex, ambiguous, high-stakes, or multidisciplinary and would benefit from AI intake followed by escalation to a human expert. Do not use for simple fact queries (use askPearlAi) or when the user explicitly requests a human directly (use askExpert). Supports phone callback — pass phoneNumber and contactPreference='phone' if the user wants a call.

Parameters (6)

questionstringrequired
The user's question
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
sessionIdstring
Optional session ID for continuing a conversation
phoneNumberstring
Customer's phone number for expert callback in E.164 format (e.g., +15551234567). Only pass when the user explicitly provides it.
contactPreferencestring
Customer's preferred contact method. Set to 'phone' when the user wants a phone callback.
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.

askExpert

Use this when the user explicitly asks to speak with a real human expert, needs personalized advice in a complex or sensitive domain, or says something like 'Can I talk to a real expert?'. Supports phone callback — pass phoneNumber and contactPreference='phone' if the user wants a call.

Parameters (6)

questionstringrequired
The user's question
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
sessionIdstring
Optional session ID for continuing a conversation
phoneNumberstring
Customer's phone number for expert callback in E.164 format (e.g., +15551234567). Only pass when the user explicitly provides it.
contactPreferencestring
Customer's preferred contact method. Set to 'phone' when the user wants a phone callback.
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.

verifyAnswer

Use this when a professional needs to validate the correctness, safety, or trustworthiness of a specific AI-generated answer, or when the user asks to have an answer double-checked by a real expert.

Parameters (4)

answerstringrequired
The AI-generated answer that requires human verification
chatHistoryarray
Optional prior messages for context (ordered, oldest first)
sessionIdstring
Existing session ID to continue; generated if omitted
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "pearl-api-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pearl.com/sse"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.