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:

text

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:

text

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#

TransportHTTP (streamable-http)Endpointhttps://mcp.aivi.io/mcpHealthhttps://mcp.aivi.io/healthAuth Resolvehttps://mcp.aivi.io/auth/resolve?authorization_id={id}CompatibleClaude 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:

• Score a lead before contacting them
• Launch an AI voice + SMS sequence
• Check if a phone number is valid or a litigator
• Get ML recommendation on best channel and timing
• Launch a premium Supercharged campaign

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:

• "Qualify this lead at +12065551234"
• "Is +12065551234 worth contacting?"
• "Verify this lead before we call"

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:

• Lead has been inactive for 30+ days
• Phone ownership may have changed
• Time-sensitive financial qualification (mortgage, auto, insurance, debt consolidation)

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:

• "Score this lead at +12065551234"
• "Is this lead worth calling?"
• "What does AIVI know about +13105551234?"

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:

• "Launch a 3-day sequence for this lead"
• "Start the Supercharged 1-day campaign"
• "Enroll +12065551234 in a 12-day sequence with booking enabled"

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:

• "What should I do next with this lead?"
• "Should I call or text +12065551234?"
• "What's the ML recommendation for this contact?"

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:

• "What happened on that call?"
• "Did the sequence convert?"
• "Show me the topics from the last call"

Conversational Intelligence#

Every call processed by AIVI generates:

• Topics discussed (automatically extracted)
• Key moments (objections, callbacks, compliance, escalations)
• Sentiment arc (positive, negative, neutral)
• Outcome classification

773 calls analyzed. 494 moments detected:

• 140 objections raised
• 117 callback promises
• 24 compliance misses
• 12 escalation requests

Works across:

• Lead generation (new prospects)
• Contact center (inbound + outbound)
• Customer re-activation (lapsed base)
• Ongoing care (existing customers)

Every call makes the next one smarter.

Billing#

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

SkillCostqualify_lead$0.75 (cached free, auto-reject free)score_lead$0.75launch_sequence (one_day)$1.00launch_sequence (three_day)$1.50launch_sequence (twelve_day)$3.00Booking add-on+$1.00decide_next_actionFreeget_outcomeFree