mnotify-mcp-server 0.1.1

MNotify MCP server: expose MNotify SMS tools over the Model Context Protocol

MNotify MCP Server

Expose the MNotify SMS API as an MCP server so IDEs and AI tools (e.g., Cursor) can securely call real MNotify actions (send SMS, manage contacts/groups/templates, delivery reports) via stdio.

This page describes the package specifically for PyPI. For the broader repository (including a local CLI agent), see the project README on GitHub.

Installation

pip install mnotify_mcp_server

Quick Start

Set your MNotify API key and start the MCP server process:

export MNOTIFY_API_KEY=sk_mnotify_...

# Start the server
mnotify_mcp server
# or
mnotify-mcp
# or
python -m mnotify_mcp.server

Environment

• MNOTIFY_API_KEY is required.
• Python 3.10+.

Tools Exposed

• SMS: send_quick_bulk_sms, send_bulk_group_sms, update_scheduled_sms
• Reports: sms_delivery_report, specific_sms_delivery_report, periodic_sms_delivery_report
• Contacts: add_contact, update_contact, delete_contact, get_contact_details, get_contact_list, get_group_contacts
• Groups: add_group, update_group, delete_group, get_group_details, get_group_list
• Templates: get_template_list, get_message_template, add_message_template, update_message_template, delete_message_template
• Utilities: register_sender_id, check_sender_id, check_sms_balance

Validation & Guardrails

• Message length ≤ 460; sender ID length ≤ 11
• Scheduling requires schedule_time in YYYY-MM-DD HH:MM

Security

• Never pass secrets as tool arguments; the server reads MNOTIFY_API_KEY from the environment.
• The server does not log secrets.