infobip-mcp v1.0.0

Unified Model Context Protocol (MCP) server for Infobip APIs. Consolidates SMS, WhatsApp, Email, 2FA/OTP, and Account management into a single, high-performance local MCP server.

Features (5 Unified Tools)

• infobip_sms: Send single/bulk SMS, fetch delivery reports (DLR), and view message logs
• infobip_whatsapp: Send text, approved Meta templates, and media (images, documents, videos, audio)
• infobip_email: Send transactional emails (HTML/text), track delivery reports and logs
• infobip_2fa: Generate and dispatch 2FA OTP codes, verify PIN codes, resend PINs, manage 2FA applications
• infobip_account: Check real-time account balance and currency

Quick Start

1. Configuration (API Key)

Store your Infobip API key in ~/.secrets/infobip-key.txt or set the environment variable:

export INFOBIP_API_KEY="your-infobip-api-key"
export INFOBIP_BASE_URL="https://xxxxx.api.infobip.com"  # Optional, defaults to https://api.infobip.com

2. Add to MCP Client (Claude Desktop, OpenCode, Cursor, Windsurf)

Option 1: Via uvx (Instant - No manual install)

{
  "mcpServers": {
    "infobip": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Steph-ux/infobip-mcp.git", "infobip-mcp"]
    }
  }
}

Option 2: Via pip install

pip install git+https://github.com/Steph-ux/infobip-mcp.git

Then in your MCP config:

{
  "mcpServers": {
    "infobip": {
      "command": "infobip-mcp"
    }
  }
}

Option 3: Local Clone

{
  "mcpServers": {
    "infobip": {
      "command": "python",
      "args": ["D:\\Steph\\script\\infobip-mcp\\server.py"]
    }
  }
}

Usage Examples

1. Send SMS

infobip_sms(
    action='send',
    to='+33612345678',
    text='Your verification code is 482910',
    from_sender='AuthService'
)

2. Send WhatsApp Template

infobip_whatsapp(
    action='send_template',
    from_sender='447860099299',
    to='33612345678',
    template_name='order_confirmation',
    language='en',
    placeholders=['John', 'ORDER-9812']
)

3. Send Transactional Email

infobip_email(
    action='send',
    from_email='notifications@yourdomain.com',
    to='customer@example.com',
    subject='Invoice #4912',
    html='<h1>Thank you for your purchase</h1><p>Your order is confirmed.</p>'
)

4. Send and Verify 2FA PIN

# Step 1: Send PIN
infobip_2fa(
    action='send_pin',
    application_id='APP_ID_123',
    message_id='MSG_ID_456',
    to='+33612345678'
)

# Step 2: Verify PIN
infobip_2fa(
    action='verify_pin',
    pin_id='PIN_ID_789',
    pin='4829'
)

5. Check Balance

infobip_account(action='balance')

Testing

pytest tests

License

MIT