mcp avatar

Pearl Api Mcp Server

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

Connects to Pearl's expertise platform at mcp.pearl.com, exposing both SSE and streamable HTTP transports for integrating human and AI collaborative workflows into Claude. The server appears designed for scenarios where you need validated answers or decision support that combines algorithmic insights with human expertise, rather than relying on the LLM alone. You'd reach for this when accuracy and trust matter more than speed, such as technical troubleshooting, research validation, or complex problem-solving where subject matter experts can augment AI capabilities. The dual transport support suggests flexible integration options for different deployment contexts.

tools
7
auth
Required
transport
SSE, HTTP
last updated
Oct 2, 2025

Install

From registry metadata
$ npx add-mcp https://mcp.pearl.com/sse --name pearl-api --transport sse --header 'X-API-Key: ${X_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport sse pearl-api https://mcp.pearl.com/sse --header 'X-API-Key: YOUR_X_API_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

askPearlAiUse 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.3 params

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* required
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
question*string
The user's question
sessionIdstring
Optional session ID for continuing a conversation
askPearlExpertUse 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 askExper...6 params

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 askExper...

Parameters* required
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
contactPreferencestring
Customer's preferred contact method. Set to 'phone' when the user wants a phone callback.one of chat · phone
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.
phoneNumberstring
Customer's phone number for expert callback in E.164 format (e.g., +15551234567). Only pass when the user explicitly provides it.
question*string
The user's question
sessionIdstring
Optional session ID for continuing a conversation
askExpertUse 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 wan...6 params

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 wan...

Parameters* required
chatHistoryarray
Optional conversation history. This ensures experts see the complete context
contactPreferencestring
Customer's preferred contact method. Set to 'phone' when the user wants a phone callback.one of chat · phone
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.
phoneNumberstring
Customer's phone number for expert callback in E.164 format (e.g., +15551234567). Only pass when the user explicitly provides it.
question*string
The user's question
sessionIdstring
Optional session ID for continuing a conversation
verifyAnswerUse 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.4 params

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* required
answer*string
The AI-generated answer that requires human verification
chatHistoryarray
Optional prior messages for context (ordered, oldest first)
enableMockResponseboolean
When true, the API returns a hardcoded mock expert success response instead of routing to a real expert. Useful for testing downstream behavior.
sessionIdstring
Existing session ID to continue; generated if omitted
getConversationHistoryRetrieve the full message history for a session. Includes all messages (after any formatting done during processing). Use to resume discussions.1 params

Retrieve the full message history for a session. Includes all messages (after any formatting done during processing). Use to resume discussions.

Parameters* required
sessionId*string
The session ID of the conversation
send_answer_for_verificationUse this tool only when the user explicitly requests to start verification, fact-checking, or expert validation of an AI-generated answer. This tool must be used exclusively to initiate the verification process. Do not call it to check status, retrieve results, or for any foll...2 params

Use this tool only when the user explicitly requests to start verification, fact-checking, or expert validation of an AI-generated answer. This tool must be used exclusively to initiate the verification process. Do not call it to check status, retrieve results, or for any foll...

Parameters* required
conversation*array
Full conversation between the user and the AI assistant to be reviewed by a human expert. Must contain at least one assistant message — the AI-generated answer that will be assessed.
questionCategory*string
The category that best describes the question being verified. - "Car" for automotive/vehicle topics - "Veterinary" for pet or animal health - "Health" for human medical topics - "Tech" for technolo...one of Car · Veterinary · Health · Tech · Law · Other
get_verification_stateUse this when polling the current status of a verification request previously submitted via send_answer_for_verification. Returns the verification state (not started, in progress, or completed) and the expert's verdict once the review is complete.1 params

Use this when polling the current status of a verification request previously submitted via send_answer_for_verification. Returns the verification state (not started, in progress, or completed) and the expert's verdict once the review is complete.

Parameters* required
sessionId*string
The session identifier of the chat whose verification state should be retrieved. Must match the sessionId previously returned by send_answer_for_verification.

Sponsors

Details

Transport
SSE, HTTP
Auth
Required
Registry
MCP registry, active
Resources
2
Prompts
2
Tools verified
Nov 6, 2026

More from mcp