Pearl MCP Server

Features

• Support for both stdio and SSE transports
• Integration with Pearl API for AI and expert assistance
• Session management for continuous conversations
• Multiple interaction modes:
• AI-only mode for quick automated responses
• AI-Expert mode for AI-assisted human expert support
• Expert mode for direct human expert assistance
• Conversation history tracking
• Stateful session management

Prerequisites

• Python 3.12 or higher
• Pearl API Key (Contact Pearl to obtain your API key)
• pip or uv package manager

Installation

1. Clone the repository:

   git clone https://github.com/Pearl-com/pearl_mcp_server.git
   cd pearl_mcp_server
   

2. Create a virtual environment and activate it:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install dependencies:

   pip install -e .
   

Configuration

1. Create a .env file in the src directory:

   PEARL_API_KEY=your-api-key-here
   

Running the Server# Local Development

Start the server using either stdio (default) or SSE transport:

pearl-mcp-server --api-key your-api-key\n\n# Using SSE transport on custom port
pearl-mcp-server --api-key your-api-key --transport sse --port 8000

Using Remote Server

Pearl provides a hosted MCP server at: https://mcp.pearl.com/mcp This can be used directly with any MCP client without installing the Python application locally.

Available Tools

The server provides the following tools:

1. ask_pearl_ai - Quick AI-only responses without human review
2. ask_pearl_expert - AI-assisted human expert support
3. ask_expert - Direct human expert assistance
4. get_conversation_status - Check the status of an active conversation
5. get_conversation_history - Retrieve full conversation history

Expert Categories

Pearl's MCP server provides access to a wide range of expert categories including Medical & Healthcare, Legal & Financial, Technical & Professional, Education & Career, and Lifestyle & Personal.

Connecting with MCP Clients# Local Connection (stdio transport)

For connecting to a local MCP server using stdio transport, add the following configuration to your MCP client:

{
  "pearl-mcp-server": {
    "type": "stdio",
    "command": "pearl-mcp-server",
    "args": ["--api-key", "your-api-key"],
    "env": {"PEARL_API_KEY": "Your Pearl Api Key"}
  }
}
```\n\n### Remote Connection using mcp-remote
Some MCP clients don't support direct connection to remote MCP servers. For these clients, you can use the `mcp-remote` package as a bridge.

## API Key
To obtain a Pearl API key for using this server:
1. Visit Pearl Contact Page
2. Request an API key for MCP server integration
3. Follow the provided instructions to complete the registration process

Keep your API key secure and never commit it to version control.