# iBlueText

iBlueText sends iMessage, SMS, and WhatsApp messages directly from your AI client. Helpful for managing text campaigns, verifying phone numbers, and handling replies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: iBlueText
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/iBlueText/ibluetext-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ibluetext

## What it does

This server bridges your AI environment with a dedicated business number to handle direct customer messaging. It checks which phone numbers belong to iPhones, delivers single iMessage, SMS, or WhatsApp texts, and handles campaign batches with merge tags. The toolset also supports conversation tracking, automated lead scores, and sequence enrollment.

Integration works via two setups. You can point your client to the hosted streamable endpoint at `https://ibluetext.com/mcp` using OAuth sign-in to unlock 22 tools. Alternatively, running the local package through `npx -y ibluetext-mcp` with an `IBT_API_KEY` opens 30 tools, adding SMS verification widgets and reply webhooks.

If your account runs out of credits or lacks an active line, paid operations immediately stop with a 402 error. WhatsApp lines follow strict warm-up schedules, starting at 10 conversations on day 1 and reaching 300 by day 21. Contacts who never reply cannot receive more than 3 follow-ups, and falling below a 15% response rate across 7 days cuts daily volume in half.

## Requirements
- Remote server: `https://ibluetext.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ibluetext https://ibluetext.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ibluetext --url https://ibluetext.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ibluetext": {
            "url": "https://ibluetext.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ibluetext": {
            "type": "http",
            "url": "https://ibluetext.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ibluetext https://ibluetext.com/mcp
```

## When to use it
- check whether target phone numbers use iMessage or WhatsApp
- trigger bulk SMS or iMessage campaigns with template merge tags
- review conversation transcripts and lead scores inside your agent
- set up SMS phone verification workflows with local widgets

## Example prompts
- Check the numbers in leads.txt to see which ones support iMessage.
- Send an iMessage update to +1234567890 saying their order is ready.
- List our active conversations along with recent lead scores.

## Similar
- [c-messaging](https://affpapa.org/en/nevibecode/skills/c-messaging.md) — skill · ★ 179 repo stars
- [SendSeven Messaging](https://affpapa.org/en/nevibecode/mcp/sendseven-messaging.md) — MCP server · ★ 2 repo stars
- [SendKuy](https://affpapa.org/en/nevibecode/mcp/sendkuy.md) — MCP server · ★ 1 repo stars
- [sms](https://affpapa.org/en/nevibecode/skills/sms.md) — skill · 75300 installs
- [sent-messaging](https://affpapa.org/en/nevibecode/skills/sent-messaging.md) — skill · 2900 installs
- [sent](https://affpapa.org/en/nevibecode/skills/sent.md) — skill · 2900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
