pearl-api-mcp-server

Get direct assistance from a human expert. Use when:

• The user explicitly asks to speak with a real human expert

• They need personalized advice in complex or sensitive domains

• They request a human directly (e.g., 'Can I talk to a real expert?') Returns a session_id for follow-up questions.

Get a quick AI-generated response without human expert review. Use when:

• The user wants a rapid draft or alternative perspective

• The topic is low-risk / exploratory and doesn't require human validation

• Comparing approaches or brainstorming Avoid for: medical, legal, financial, or safety‑critical questions (use askExpert or askPearlExpert).

Hybrid intake → human expert escalation. Flow:

1. AI gathers clarifying context

2. Conversation can escalate to a human expert with structured info Use when:

• Problem is complex, ambiguous, multidisciplinary, or high stakes

• A tailored recommendation or diagnostic reasoning is needed

• You anticipate follow-up requiring human judgment Avoid for: trivial fact queries (use askPearlAi) or direct human request (use askExpert).

Submit a single AI-generated answer for human expert verification. Use when:

• You need a professional to validate correctness, safety, or trustworthiness of an AI answer

• The user asks to have the previous answer double‑checked by a real expert Parameters:

• answer: REQUIRED string. The AI answer to verify.

• chatHistory: OPTIONAL array. Prior conversation context (excluding the answer if duplicated).

• sessionId: OPTIONAL string to continue an existing verification session. Auto-generated if omitted. Returns JSON with verified answer, session_id, status, and guidance for follow-up.