The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Rafi listing page.
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.
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:
Complete sign-in and consent in the browser. Use /mcp in Codex to check the connection and available tools.
Open /mcp, select rafi, and complete authentication in the browser.
Add Rafi to ~/.cursor/mcp.json for your account or .cursor/mcp.json for one project:
In Cursor, open Settings → Tools & MCP, select Rafi, and complete authentication in the browser.
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.
| Tool | Access | Behavior |
|---|---|---|
find-leads | Read | Finds up to three leads by search text within the server-selected organization. |
get-voice-playbooks | Read | Gets the outbound and inbound AI voice playbooks for the server-selected organization. |
create-reminder | Write | Creates a call, message, SMS, or status-change reminder for a lead. Datetimes require an explicit UTC offset. The authenticated user is recorded automatically. |
mark-lead-as-dnc | Write | Permanently marks a lead as do not contact and stops prospecting. |
update-voice-playbooks | Write | Updates the server-selected organization's outbound or inbound voice playbook. An empty or null value clears that playbook. |
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.
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.
Disconnecting a client removes its local connection. Clearing authentication also removes its cached OAuth credentials.
codex mcp logout rafi, then codex mcp remove rafi if you also want to remove the server configuration./mcp, select Rafi, and choose Clear authentication. Run claude mcp remove rafi to remove the configuration.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.
create-reminder, mark-lead-as-dnc, and update-voice-playbooks as writes and review them before approval.Install the Rafi skill for compatible agents with:
The skill teaches an agent when to use each Rafi tool, how to resolve leads safely, and when to confirm writes.
For setup, access, or security help, contact support@heyrafi.com.