SMSPM MCP Server

What SMSPM MCP Server MCP server does

SMSPM MCP Server MCP server connects MCP clients to the SMSPM SMS API for sending transactional text messages. It is intended for clients such as Claude Desktop, Cursor, Windsurf, Cline, and other MCP-compatible applications. After configuration, an agent can call the provided send_sms tool instead of requiring a separate SMS workflow.

The server supports a required destination number and message body, plus an optional sender value. Recipient numbers should use international format. If no sender is supplied, the documented default is smspm.com.

How it works

The process runs locally under Node.js 18 or later. MCP client configuration starts the server and passes credentials through environment variables. When the client invokes send_sms, the server uses the configured SMSPM credentials to send the request to api.smspm.com.

The required credentials are an SMSPM Hash and API Token. These values are obtained from the SMSPM account's Settings → API page. According to the project documentation, the credentials remain in the local client configuration and are sent only to SMSPM's API, not to Anthropic or Claude.

Setup and configuration

The documented source-based setup requires cloning the repository, installing its Node.js dependencies, and running the build command:

git clone https://github.com/alesav/smspm-mcp.git
cd smspm-mcp
npm install
npm run build

The resulting dist/index.js file is then used as the Node.js process in an MCP client configuration. The configuration supplies these variables:

• SMSPM_HASH: the Hash from the SMSPM API settings
• SMSPM_TOKEN: the SMSPM API Token

The README also documents an npm installation option using the smspm-mcp package once that package is published. After changing the client configuration, restart Claude Desktop. The documented Claude Desktop configuration locations are the application support path on macOS and the %APPDATA% path on Windows.

Tools and capabilities

SMSPM MCP Server MCP server documents one tool:

• send_sms: sends an SMS through SMSPM.
  • toNumber — required recipient phone number in international format
  • text — required message content
  • fromNumber — optional sender name or number displayed to the recipient; defaults to smspm.com

Example agent requests include sending a greeting to a specified international number or notifying a recipient that an order has shipped. The material does not document tools for reading messages, checking delivery status, managing contacts, or retrieving account data.

Limitations and notes

An SMSPM account, Hash, and API Token are required. The documentation does not state SMS pricing, rate limits, delivery guarantees, or supported sender policies, so those details should be confirmed with SMSPM. The recipient number must be supplied in international format, and the server depends on Node.js 18 or newer.

Keep the Hash and Token out of source control. They are placed in the local MCP client configuration, which should not be committed to a repository. SMSPM MCP Server MCP server is released under the MIT license.