MCP Sms Ir

🚀 SMS.ir MCP Server

This is a Model Context Protocol (MCP) server for the SMS.ir messaging service. It enables AI assistants like Claude to send SMS messages via the SMS.ir API.

🚀 Quick Start

The SMS.ir MCP Server allows AI assistants to interact with the SMS.ir API, facilitating various SMS - sending operations.

✨ Features

• Send individual SMS messages to a single recipient.
• Send bulk SMS messages to multiple recipients.
• Send verification code SMS using templates.
• Check account balance.

📦 Installation

Prerequisites

• Node.js v18 or higher.
• An API key from SMS.ir.

Installation Methods

Method 1: Install from npm (Recommended)

You can install directly from npm using npx:

# No need to install; npx can run on - demand

This method is more recommended as it allows you to use the server without manual downloading and is easy to update.

Method 2: Manual Installation

If you prefer to install and customize the server manually:

1. Clone this repository:

git clone https://github.com/your - username/mcp - sms - ir.git
cd mcp - sms - ir

2. Install dependencies:

bun install
# or
npm install

3. Build the project:

npm run build

4. Launch the server:

npm start

📚 Documentation

Please visit the [official documentation](https://modelcontextprotocol.io/tools/mcp - sms - ir) for detailed information.

💻 Usage Examples

Basic Usage

Send an SMS

Run the following command in the terminal:

npx mcp - sms - ir send_sms --mobile=09121234567 --message="Hello from Claude"

Send Bulk SMS

Run the following command in the terminal:

npx mcp - sms - ir send_bulk_sms --mobiles=09121234567,09123456789 --messageText="Hello from Claude"

Send Verification Code

Run the following command in the terminal:

npx mcp - sms - ir send_verification_code --mobile=09121234567 --templateId=100000 --parameters='[{"name":"CODE","value":"123456"}]'

Check Account Balance

Run the following command in the terminal:

npx mcp - sms - ir check_credit

📄 License

MIT

Acknowledgments

• SMS.ir for providing the messaging API.
• Model Context Protocol for implementing this integration.