Rafi MCP

Use Rafi from an MCP-compatible AI client to find authorized leads, create reminders, manage do-not-contact status, and read or update AI voice playbooks.

Setup

Supported clients are Codex, Claude Code, and Cursor. You need an active Rafi account with access to at least one organization. Rafi uses browser-based OAuth; you do not need to create or paste an API key.

Production server URL:

https://nest-app-775685078591.us-east1.run.app/api/mcp

Codex

codex mcp add rafi --url https://nest-app-775685078591.us-east1.run.app/api/mcp
codex mcp login rafi

Complete sign-in and consent in the browser. Use /mcp in Codex to check the connection and available tools.

Claude Code

claude mcp add --transport http rafi https://nest-app-775685078591.us-east1.run.app/api/mcp

Open /mcp, select rafi, and complete authentication in the browser.

Cursor

Add Rafi to ~/.cursor/mcp.json for your account or .cursor/mcp.json for one project:

{
  "mcpServers": {
    "rafi": {
      "type": "http",
      "url": "https://nest-app-775685078591.us-east1.run.app/api/mcp"
    }
  }
}

In Cursor, open Settings → Tools & MCP, select Rafi, and complete authentication in the browser.

Available tools

Rafi selects one organization on the server and limits every tool to that organization and its leads. It selects the lowest-ID active organization the account owns, or otherwise the lowest-ID active organization where the account is a member. MCP requests cannot select another organization. Resources outside that scope are returned as not found.

Example prompts:

• Find leads named Morgan.
• Show my voice playbooks.
• Remind me to call lead 456 at 2026-08-06T15:00:00-03:00 about the listing.
• Mark lead 456 as do not contact.
• Replace my outbound voice playbook with this text: ...

Your AI client may ask for confirmation before a write. Review the lead, time, and content carefully before approving it.

Permissions and consent

Signing in grants the connected client permission to invoke Rafi's read and write MCP tools on your behalf. Rafi applies your existing account permissions to every request; connecting the client does not grant access to additional organizations or leads.

Authentication identifies the user automatically. Do not provide internal fields such as createdBy.

Disconnect or revoke access

Disconnecting a client removes its local connection. Clearing authentication also removes its cached OAuth credentials.

• Codex: run codex mcp logout rafi, then codex mcp remove rafi if you also want to remove the server configuration.
• Claude Code: open /mcp, select Rafi, and choose Clear authentication. Run claude mcp remove rafi to remove the configuration.
• Cursor: open Settings → Tools & MCP, select Rafi, clear authentication, and disable or remove the server. Remove the rafi entry from mcp.json if it was added manually.

To invalidate the OAuth grant on the Rafi side as well, contact support@heyrafi.com.

Security

• Never paste access tokens, credentials, or internal API keys into prompts or configuration files.
• Use only the production URL shown in this README.
• Treat create-reminder, mark-lead-as-dnc, and update-voice-playbooks as writes and review them before approval.
• Disconnect clients you no longer use and contact support if you suspect unauthorized access.

Optional agent skill

Install the Rafi skill for compatible agents with:

npx skills add heyrafi/rafi-mcp --skill rafi-mcp

The skill teaches an agent when to use each Rafi tool, how to resolve leads safely, and when to confirm writes.

Support

For setup, access, or security help, contact support@heyrafi.com.