# Pearl [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Pearl-Passport/pearl-agent-plugin  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pearl

## Description
Read-only Pearl place discovery, recommendations, and private member travel context.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "pearl": {
    "url": "https://agent.joinpearl.co/mcp"
  }
}
```

## Documentation

## What the Pearl MCP server does

The Pearl MCP server gives supported AI applications access to Pearl member context and place-related capabilities. It is intended for eligible Pearl Reserve and Elite members who want to find places, receive recommendations, explore their preferences, or ask about their travel history.

Available account data can include visits, saved places, trips, and reservations. The exact feature set depends on the connected host application and the permissions granted during authentication. The live MCP `tools/list` response is the authoritative source for the capabilities exposed to a particular connection.

## How it works

Pearl provides one authenticated MCP endpoint at `https://agent.joinpearl.co/mcp`. A compatible host connects to that address, the member authenticates, and the host receives the permissions needed for the enabled capabilities. The host’s available tools may differ by application.

Some supported operations can modify visits, saved places, or private trip information. When those operations are available, Pearl requires a preview and explicit confirmation before applying the change. Reconnecting Codex, Claude, or Cursor may be necessary to approve newly added permissions. ChatGPT retains the visit-only action set submitted for that host.

## Setup and configuration

Install the integration through the relevant host workflow or connect the hosted MCP address as a custom connector. Codex users can add the marketplace and plugin, then run `codex mcp login pearl`. Claude Code users can install the marketplace plugin and run `claude mcp login plugin:pearl:pearl`.

For Claude web or desktop Chat, add the MCP address as a custom connector, use the public client ID `pearl-claude-hosted`, and leave the client secret blank. Cursor users can install Pearl from an available marketplace, or clone the repository and copy its local Cursor plugin files before reloading Cursor and authenticating.

Access can be revoked in Pearl under Settings, Account, and Connected apps. Revoking a connection stops that connection without deleting Pearl data.

## Tools and capabilities

The Pearl MCP server supports these documented use areas:

- Discovering places and receiving recommendations
- Exploring a member’s taste
- Reviewing visits and saved places
- Reviewing trips and reservations
- Making supported private-data changes after preview and confirmation

Table availability is informational. It does not hold or book a reservation.

## Limitations and notes

This release cannot book, change, cancel, or pay for reservations. Capability availability varies by host and approved permissions, so an installation should not assume every documented operation is present.

A local Cursor installation does not reach hosted Cloud Agents or Grok Bot. Repository updates, CLI releases, registry releases, and marketplace releases are separate; follow the applicable release instructions when updating or publishing. Do not provide passwords, sign-in codes, access tokens, or payment details in chat.

The software is licensed under MIT. Pearl’s repository availability does not indicate approval, endorsement, or listing by Anthropic, Cursor, or OpenAI.

_Full upstream README: https://allmcps.com/mcp/pearl/readme_