Skip to main content
Glama
iBlueText MCP server

iBlueText MCP server

Official
by iBlueText

iBlueText MCP server

M8ven Verified

mcptry

iBlueText MCP server

Text your customers from your AI assistant. iBlueText sends real blue-bubble iMessage, SMS and WhatsApp from a dedicated iBlueText line, and checks which numbers are iPhones. This MCP server gives Claude, ChatGPT, Cursor and any other MCP client native tools for it: send one message or a whole campaign, read replies and lead scores, manage contacts, sequences and quick answers, and check which numbers are iPhones.

There are two ways to connect.

1. Hosted (ChatGPT, Claude, Gemini CLI, no API key)

Server URL: https://ibluetext.com/mcp (Streamable HTTP, OAuth sign-in)

  • Claude: Settings › Connectors › Add custom connector › paste the URL › Connect, then sign in to iBlueText and click Allow.

  • ChatGPT: Settings › Apps (Developer mode) › create an app with the URL, then sign in and Allow.

  • Gemini CLI: gemini extensions install https://github.com/iBlueText/ibluetext-mcp, then sign in to iBlueText the first time a tool runs (or /mcp auth ibluetext).

  • Any remote-MCP client: use the URL; the client discovers OAuth from /.well-known/oauth-protected-resource.

24 tools with plain verb names (send_message, create_campaign, check_iphones, list_conversations, ...). Full list and example prompts: https://ibluetext.com/ai-assistants

Related MCP server: whatsapp-mcp-server

2. Local package with an API key (developers, 30 tools)

  1. Create an API key at https://ibluetext.com/portal/integrations.php

  2. Add this to your MCP client config (for example Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "ibluetext": {
      "command": "npx",
      "args": ["-y", "ibluetext-mcp"],
      "env": { "IBT_API_KEY": "sk-ibt-your_key_here" }
    }
  }
}

Claude Code: claude mcp add ibluetext --env IBT_API_KEY=sk-ibt-... -- npx -y ibluetext-mcp

The package adds SMS verification, verify-widget sites and reply webhooks to the hosted tool set.

Tools

Account: ibt_balance · ibt_lines

Lookup: ibt_lookup (which numbers are iPhones; waits for results) · ibt_lookup_status

Send: ibt_send (one iMessage/SMS; channel, attachments, effects, quote-reply, scheduling) · ibt_send_status · ibt_react (tapbacks)

Campaigns: ibt_campaign_create (a whole list: iMessage, SMS, auto-detect or WhatsApp, with {merge} fields) · ibt_campaigns · ibt_campaign_status · ibt_campaign_pause

WhatsApp: ibt_whatsapp_send · ibt_whatsapp_status · ibt_whatsapp_numbers (warm-up, today's limit, reply rate, health)

Contacts & CRM: ibt_conversations (transcripts + lead score) · ibt_conversation_ai · ibt_quick_answers / ibt_quick_answer_set · ibt_contact / ibt_contact_update · ibt_contacts · ibt_sequences / ibt_sequence_enroll

Webhooks: ibt_webhooks / ibt_webhooks_set

Verification: ibt_verify_start / ibt_verify_check · ibt_create_site (SMS-Verify widget)

Notes

  • Paid actions return HTTP 402 when the account is out of credits or has no active line. The tool result is flagged payment_required: true; a person adds credits or a line in the iBlueText dashboard.

  • Opt-outs (STOP) and each line's daily new-contact limit always apply.

  • WhatsApp numbers warm up from 10 new conversations on day 1 to 300/day by day 21; someone who never replied gets at most 3 messages; under 15% replies over 7 days halves the daily limit. Open with a question like "Hey, is this {first_name}?".

  • Local dev: IBT_API_KEY=sk-ibt-... node index.js (MCP over stdio). Tests: npm test (starts the server over stdio, no key or network needed).

  • Security: your API key is only ever sent to https://ibluetext.com/api/v1 (the address is fixed in the code, not configurable). Every tool is annotated: reads are readOnlyHint, and tools that message a real person (send, campaign, WhatsApp, verify) are destructiveHint + openWorldHint, so clients can ask before they run.

  • REST API: https://ibluetext.com/docs/ · OpenAPI: https://ibluetext.com/openapi.json · For AI agents: https://ibluetext.com/llms.txt

Support

russ@ibluetext.com · Privacy · Terms

MIT licensed. iBlueText is a product of RG Loomis LLC.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to read, search, and send iMessages with features like contact name resolution, session grouping, and attachment listing. It provides intent-aligned tools to efficiently navigate conversation history and manage messages through natural language queries.
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without the risk of account bans.
      18
      13 npm
      25
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables sending SMS messages, managing contacts, campaigns, and inbox from AI assistants like Claude and ClickUp.
      33 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to send iMessages, check delivery status, read conversations, and verify iMessage capability over a dedicated line.
      4
      12 npm
      MIT