# smsmode MCP by usefulapi

> smsmode MCP by usefulapi is an MCP server. Read smsmode balance, messages, replies, campaigns and usage; send SMS to up to 10 numbers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/smsmode/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smsmode
- **MCP Registry name:** io.usefulapi/smsmode
- **Listing updated:** 2026-11-13

## About

Read smsmode balance, messages, replies, campaigns and usage; send SMS to up to 10 numbers.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http smsmode https://smsmode.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://smsmode.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "smsmode": {
      "url": "https://smsmode.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "smsmode": {
      "type": "http",
      "url": "https://smsmode.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "smsmode": {
      "serverUrl": "https://smsmode.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "smsmode": {
      "type": "http",
      "url": "https://smsmode.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `smsmode_get_balance`: The credit balance of the connected smsmode account (and sub-organisations an administrator key can see): amount and currency (negative = owed on a POST_PAY account), payment type (PRE_PAY / POST_PAY), state, monthly consumption and its limit. Good first call; check it before sending SMS. GET /commons/v1/organisations.
- `smsmode_get_organisation`: Full details of one organisation: contacts, addresses, company information, balance, monthly limit and consumption. GET /commons/v1/organisations/{id}.
- `smsmode_list_channels`: List messaging channels (SMS or RCS; flow TRANSACTIONAL / MARKETING / OTP) with default sender, daily and monthly limits and consumption. A channel id is needed to scope messages or consumption to one channel. GET /commons/v1/channels.
- `smsmode_get_channel`: Details of one channel: type, flow, default sender ID and authorized sender IDs, limits and consumption. GET /commons/v1/channels/{id}.
- `smsmode_list_consumptions`: Sent-message counts and money spent per month or per day (price amount and currency), optionally for one channel. Default: monthly, the last 3 months. GET /commons/v1/consumptions.
- `smsmode_get_consumption`: One consumption record broken down by country (mcc) or network (mccMnc) with quantity and price per sub-item, optionally with delivery statuses. GET /commons/v1/consumptions/{id}.
- `smsmode_lookup_number`: Country and mobile network (mcc/mnc, operator) of a phone number. Only for customers with a premium smsmode subscription and, for now, only French numbers (403 otherwise). GET /commons/v1/lookup/{msisdn}.
- `smsmode_list_messages`: Messages with delivery status (SCHEDULED, ENROUTE, DELIVERED, UNDELIVERABLE, UNDELIVERED; status.detail names the cause), recipient, sender, text, parts and price. Default window: the last 10 days. Filter by direction (MT = sent, MO = replies received), recipient, your reference, channel or campaign. Paged: pass next_page as page. GET /sms/v1/messages.
- `smsmode_get_message`: One message: delivery status and detail, delivery date, recipient network, text, parts and price. GET /sms/v1/messages/{id}.
- `smsmode_list_campaigns`: Existing SMS campaigns (grouped sends) with status SCHEDULED / ONGOING / ENDED, quantity, price and per-status delivery counts. Read only: this server does not send campaigns. GET /sms/v1/campaigns.
- `smsmode_get_campaign`: One campaign: state, period, recipients count, text, price and delivery counts per status. Use smsmode_list_messages with campaign_id for its individual messages. GET /sms/v1/campaigns/{id}.
- `smsmode_send_sms`: WRITE, SPENDS CREDIT: sends one SMS text to 1 to 10 recipients (one message each, a batch of unit messages) and texts REAL people immediately, or at send_at. Cost: every message is charged to the account at its destination's price per SMS part (GSM7: 160 characters for 1 part, 306 for 2, 459 for 3...; UNICODE: 70, 134, 201...); the accept reply returns each message's id and status (the price may o
- `smsmode_cancel_scheduled_message`: WRITE: cancels ONE message that is still scheduled (status SCHEDULED, sent with send_at) so it is not sent; smsmode refuses messages already sent. Cannot be undone. DELETE /sms/v1/messages/{id}.

## FAQ

### How do I add smsmode MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http smsmode https://smsmode.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/smsmode-mcp-by-usefulapi
