AIVI Lead Engagement

---

name: aivi-engagement

description: AIVI is the AI engagement layer for lead generation, contact centers, and customer re-activation. Every conversation is analyzed in real-time, building Conversational Intelligence that makes every future interaction smarter.

version: 1.1.0

author: AIVI

url: https://aivi.io

requires: {}

---

Getting Started

Setup (One Time)

1. Create your account at app.aivi.io

Sign in with Google or email.

2. Connect AIVI to your agent:

**Claude Code:**

claude mcp add --transport http aivi https://mcp.aivi.io/mcp

Then authenticate:

`/mcp` → select AIVI → Authenticate

Browser opens → sign in with Google → click Allow Access → done.

Tokens persist across server redeploys (Redis-backed).

**Claude Desktop / claude.ai:**

Settings → Connectors → Add

URL: `https://mcp.aivi.io/mcp`

Sign in when browser opens.

**ChatGPT Developer Mode:**

Settings → Connectors → Developer Mode

Add URL: `https://mcp.aivi.io/mcp`

Sign in when prompted.

**OpenClaw / NemoClaw:**

clawhub install aivi-engagement

Then authenticate: `/mcp` → AIVI → Authenticate → done.

**All other MCP clients:**

Endpoint: `https://mcp.aivi.io/mcp`

Supports OAuth 2.1 + PKCE.

Need help? app.aivi.io/getting-started

---

MCP Connection

| | |

|---|---|

| Transport | HTTP (streamable-http) |

| Endpoint | https://mcp.aivi.io/mcp |

| Health | https://mcp.aivi.io/health |

| Auth Resolve | https://mcp.aivi.io/auth/resolve?authorization_id={id} |

| Compatible | Claude Code, Claude Desktop, OpenClaw, NemoClaw, ChatGPT, any MCP client |

---

Agent Behavior Rules

Authentication is handled automatically via OAuth 2.1. If credentials are missing, direct user to run `/mcp` auth in Claude Code or reconnect via Settings → Connectors. Do not ask for API keys.

If skill returns insufficient_funds:

> "Add credits at app.aivi.io → Billing"

---

Quick Start Prompts

Copy and paste to get started immediately:

1. Score a lead:

"Score the lead at +12065551234"

2. Launch a sequence:

"Launch a 3-day sequence for +12065551234"

3. Check what happened:

"What happened on the last call with +12065551234?"

4. Get ML recommendation:

"What should I do next with +12065551234?"

---

# AIVI Lead Engagement

Use this skill when the user wants to:

Setup Required

MCP endpoint: https://mcp.aivi.io/mcp

Auth: OAuth 2.1 (automatic).

Available Skills

qualify_lead ($0.75)

Use when: user wants to verify and qualify a lead before outreach.

Prerequisites — Enable AIVI Insights:

app.aivi.io → Profile icon → Settings → Integrations → AIVI Insights → Activate → Configure tier rules

Example prompts:

Returns: phone validity and litigator status, contactability level, lead tier (Premium/Standard/Manual/Reject), economic propensity indicators, recommended sequence type, auto-reject flag with reason.

Auto-rejected leads are not charged.

AIVI Insights data is cached for up to 30 days. Cached results are returned free of charge. Re-qualification at $0.75 is recommended when:

Note: Economic indicators are propensity signals at segment level — they reflect likely household characteristics, not verified individual facts.

score_lead ($0.75)

Use when: user wants to score or evaluate a lead before outreach.

Example prompts:

Returns: score 0-100, tier, ML recommendation, phone validity, litigator check, income level, property data, best channel and timing.

launch_sequence

Use when: user wants to start an outreach campaign for a lead.

Example prompts:

Sequences: one_day ($1.00), three_day ($1.50), twelve_day ($3.00). Add $1.00 for booking.

decide_next_action

Use when: user wants the ML model to recommend the best next step.

Example prompts:

Returns: recommended action, channel, timing, all 14 action scores, confidence, exploration flag. Free — no charge.

Prerequisites

For best results, run in this order:

1. score_lead ($0.75) — enriches the lead

2. launch_sequence ($1.00-3.00) — starts engagement

3. decide_next_action (free) — optimizes every step

You can use decide_next_action standalone but it works best after at least one score_lead or launch_sequence has run.

get_outcome

Use when: user wants to know what happened on a call or sequence.

Example prompts:

Conversational Intelligence

Every call processed by AIVI generates:

773 calls analyzed. 494 moments detected:

Works across:

Every call makes the next one smarter.

Billing

All skills require AIVI credits. Add credits at app.aivi.io → Billing.

| Skill | Cost |

|-------|------|

| qualify_lead | $0.75 (cached free, auto-reject free) |

| score_lead | $0.75 |

| launch_sequence (one_day) | $1.00 |

| launch_sequence (three_day) | $1.50 |

| launch_sequence (twelve_day) | $3.00 |

| Booking add-on | +$1.00 |

| decide_next_action | Free |

| get_outcome | Free |