Odel
Pearl

Pearl

@pearl-passport1JavaScriptMITUpdated Today

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

View on GitHub
Server endpointStreamable HTTPOAuthProbed
https://agent.joinpearl.co/mcp

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

Pearl Agent Plugin

Connect Pearl to Codex, Claude, Cursor, and supported AI apps to find places, explore your taste, and review your visits, saved places, trips, and reservations. An eligible Pearl Access membership is required.

Start with the Quick Start & Tester Guide for features, example prompts, cards, and troubleshooting.

Pearl uses one authenticated MCP address: https://agent.joinpearl.co/mcp. Features depend on the connected app and the permissions you approve; the live MCP tools/list response is authoritative. Where available, visit logging and editing require a preview and your explicit confirmation. Table availability does not hold or book a reservation. This MCP release cannot book, change, cancel, or pay for reservations.

Repository availability does not mean Anthropic, Cursor, or OpenAI has approved, endorsed, or listed Pearl.

Install

Codex Desktop and CLI

git clone --branch v0.9.0 --depth 1 https://github.com/Pearl-Passport/pearl-agent-plugin.git
cd pearl-agent-plugin
codex plugin marketplace add .
codex plugin add pearl@pearl-integrations
codex mcp login pearl

Claude Code

git clone --branch v0.9.0 --depth 1 https://github.com/Pearl-Passport/pearl-agent-plugin.git
cd pearl-agent-plugin
claude plugin marketplace add .
claude plugin install pearl@pearl-integrations
claude mcp login plugin:pearl:pearl

For Claude web/desktop Chat, add https://agent.joinpearl.co/mcp as a custom connector, enter public client ID pearl-claude-hosted, and leave Client Secret empty.

Cursor desktop

git clone --branch v0.9.0 --depth 1 https://github.com/Pearl-Passport/pearl-agent-plugin.git
cd pearl-agent-plugin
mkdir -p ~/.cursor/plugins/local
test ! -e ~/.cursor/plugins/local/pearl-cursor
cp -R plugins/pearl/cursor ~/.cursor/plugins/local/pearl-cursor

Reload Cursor, enable Pearl Cursor in Customize, and authenticate. A local install does not automatically reach hosted Cloud Agents or Grok Bot. See host setup for hosted access and reconnecting.

Manage access

Open Pearl → Settings → Account → Connected apps, or open Connected Apps. Choose Revoke to stop a connection without deleting your Pearl data.

Never share passwords, sign-in codes, access tokens, or payment details in chat.

Developer reference

CLI, Registry, and marketplace releases are separate from repository updates. Check the relevant release instructions before installing or publishing.

npm --prefix plugins/pearl test
npm --prefix plugins/pearl run validate
npm --prefix plugins/pearl run validate:live

Help and policies