Aligo SMS

Model Context Protocol (MCP) server for Aligo SMS API integration https://smartsms.aligo.in/smsapi.html aligo 는 (주)알리는사람들 사의 상표명입니다.

javascript

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hongsw-aligo-sms-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "github:hongsw/aligo-sms-mcp-server",
        "mcp-server"
      ],
      "env": {
        "ALIGO_API_KEY": "YOUR_API_KEY",
        "ALIGO_USER_ID": "YOUR_USER_ID",
        "ALIGO_TEST_MODE": "Y"
      }
    }
  }
}

You can access the Aligo SMS API through a dedicated MCP server, enabling an AI agent to send SMS messages or retrieve related information via the MCP framework. This server encapsulates the Aligo API so your MCP clients can interact with it in a standardized way.

How to use

Find the Tools or Actions you want to perform, then select the Aligo SMS MCP server as your target resource. Use your MCP client to issue high-level actions such as sending an SMS or querying message status. The server translates those actions into Aligo API calls under the hood. Ensure your client passes the required parameters (recipient number, message content, and any necessary identifiers) and your API credentials are configured in the environment.

How to install

Prerequisites: Node.js and npm should be installed on your machine. Ensure you have a working MCP client setup if you plan to connect to the server.

Option 1: Install via Smithery (automatic) to expose the Aligo SMS MCP server to your MCP client.

npx -y @smithery/cli install @hongsw/aligo-sms-mcp-server --client claude

Option 2: Manual installation (local MCP config)

Create an MCP configuration snippet that runs the server locally using npx.

{
  "mcpServers": {
    "aligo_sms_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:hongsw/aligo-sms-mcp-server",
        "mcp-server"
      ],
      "env": [
        {"name": "ALIGO_API_KEY", "value": "YOUR_API_KEY"},
        {"name": "ALIGO_USER_ID", "value": "YOUR_USER_ID"},
        {"name": "ALIGO_TEST_MODE", "value": "Y"}
      ]
    }
  }
}

Configuration and environment

Configure your API credentials and mode in your environment so the server can authorize with Aligo. Use a local environment file or set variables in your MCP client session.

# Example environment setup
export ALIGO_API_KEY=YOUR_API_KEY
export ALIGO_USER_ID=YOUR_USER_ID
export ALIGO_TEST_MODE=Y

Usage tips and examples

After starting the server, your MCP client can request to send a message by providing the destination number and the message body. The server will forward the request to Aligo. - You can query delivery status or fetch related information through the MCP client using the tools exposed by the server.

Available tools

send_sms

Send an SMS message to a specified phone number using the Aligo SMS API through MCP.

query_status

Query the delivery/status information of previously sent SMS messages.

Built by

VeilStrat

AI signals for GTM teams