# Rafi

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/heyrafi/rafi-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rafi

## Description
Manage authorized Rafi leads, reminders, DNC status, and AI voice playbooks.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "rafi": {
    "command": "npx",
    "args": ["-y","rafi"]
  }
}
```

## Documentation & README

# 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:

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

### Codex

```sh
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

```sh
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:

```json
{
  "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.

| 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.

## 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](mailto: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:

```sh
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](mailto:support@heyrafi.com).