Skip to content
MCP server

smsmode MCP by usefulapi

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

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About smsmode MCP by usefulapi

smsmode MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://smsmode.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "smsmode": {
      "url": "https://smsmode.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Read directly from the server.

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}.

smsmode MCP by usefulapi 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