Integration

The SMS Works integration

The SMS Works is a UK SMS gateway. Send single, flash, binary and scheduled text messages, send one message to many recipients or a batch of personalised messages, cancel scheduled sends, look up delivery reports, search sent, failed and incoming messages, send and verify one-time passcodes, check credit balance and per-country cost, and manage contacts and subscriber lists. The sample-error utility is not exposed. Authentication is a JSON Web Token generated once in the API Key section of your SMS Works account (it does not expire), sent as the Authorization header exactly as the account shows it.

Connect The SMS Works How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in The SMS Works.Built from the 33 The SMS Works tools below, on the connection you add once.

What you can do with The SMS Works

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Schedule, 5 operations

cancel_scheduled_batchCancel scheduled batchDELETECancels a batch of scheduled messages using the supplied batch ID
cancel_scheduled_messageCancel scheduled messageDELETECancels a scheduled SMS message matching the provided messageid
list_scheduled_messagesList scheduled messagesGETLists the messages and batches scheduled from your account in the last 3 months or due in the future, each with its status (SCHEDULED, PROCESSED or CANCELLED).
schedule_batchSchedule batchPOSTSchedules the same SMS to be sent to several recipients at the date and time given in schedule. Returns a batchid; cancel_scheduled_batch cancels it before it is sent.
schedule_messageSchedule messagePOSTSchedules one SMS to be sent to one recipient at the date and time given in schedule. Returns the messageid; cancel_scheduled_message cancels it before it is sent.

Send, 4 operations

send_batchSend batchPOSTSends the same SMS to up to 5000 recipients in one call. Returns a batchid; get_batch lists the messages of the batch and their delivery status.
send_binary_messageSend binary messagePOSTSends an SMS Message in Binary format. This can be used to send files and data to devices that process binary content. Especially useful for Internet of Things (IoT).
send_messageSend messagePOSTSends one SMS immediately to one recipient. Messages up to 160 characters use 1 credit; longer ones (up to 1280) are split in 153-character parts. Returns the messageid to look up its delivery report with get_message.
send_otpSend otpPOSTGenerates a numeric one-time passcode and texts it to a number. Optional: passcode length, message template with a {{passcode}} placeholder, validity in seconds (default 600) and metadata. Returns the messageid to match on verification.

Message, 3 operations

delete_messageDelete messageDELETEDeletes the message record (its delivery report) with the given messageid from your account.
get_messageGet messageGETReturns the delivery report of one message: status (SENT, DELIVERED, EXPIRED, UNDELIVERABLE, REJECTED...), destination, sender, content, tag, timestamps and failure reason.
search_messagesSearch messagesPOSTSearches your messages (up to 1000 per call) by status, destination, sender, keyword, metadata and date range, with limit and skip for paging. Returns the matching delivery reports.

Create, 2 operations

create_contactCreate contactPOSTCreates a contact (mobile number plus optional name, email, company, identifier and blacklist flag) in your SMS Works Workshop.
create_listCreate listPOSTCreates a subscriber list with a name, a category and an optional description. Returns the list with its listid.

List, 2 operations

get_listGet listGETReturns a list with its name, category, status and subscribed contacts.
list_listsList listsGETReturns every subscriber list in your account.

Any, 1 operation

send_personalised_batchSend personalised batchPOSTSends a batch of up to 5000 different messages in one call, each with its own sender, destination and content. Returns a batchid; get_batch lists the messages and their delivery status.

Balance, 1 operation

get_credit_balanceGet credit balanceGETReturns the number of SMS credits remaining on your account.

Batch, 1 operation

get_batchGet batchGETReturns every message of a batch with its delivery report: destination, content, status, sender, tag and failure reason.

Clear, 1 operation

clear_listClear listPOSTRemoves every contact from a list; the list itself is kept.

Contact, 1 operation

get_contactGet contactGETReturns a contact by mobile number, with its details, the lists it is subscribed to and its history.

Credit, 1 operation

get_country_credit_costGet country credit costGETReturns how many credits one SMS to the given country costs, with the country name.

Delete, 1 operation

delete_contactDelete contactPOSTDeletes the Workshop contact with the given mobile number.

Failed, 1 operation

search_failed_messagesSearch failed messagesPOSTSearches messages that failed to be delivered, with the same filters as search_messages. Returns the matching delivery reports, each with its failure reason.

Flash, 1 operation

send_flash_messageSend flash messagePOSTSends one SMS to one recipient as a flash message. Same parameters and credit rules as send_message; returns the messageid to look up its delivery report with get_message.

Inbox, 1 operation

get_unread_inbound_messagesGet unread inbound messagesPOSTReturns incoming messages (replies) that have not been retrieved before, matching the filters given. Each returned message is then counted as retrieved.

Otp, 1 operation

get_otpGet otpGETReturns a one-time passcode record by the messageid send_otp returned: destination, status, validity, metadata and timestamps.

Subscribe, 1 operation

subscribe_contact_to_listSubscribe contact to listPOSTSubscribes the contact with the given mobile number to a list.

Test, 1 operation

test_authenticationTest authenticationGETChecks that the API is up and that your token authenticates; returns a message carrying your customer ID.

Unsubscribe, 1 operation

unsubscribe_contact_from_listUnsubscribe contact from listPOSTRemoves the contact with the given mobile number from a list.

Update, 1 operation

update_contactUpdate contactPUTUpdates the Workshop contact with the given mobile number: name, email, company, identifier or blacklist flag.

Verify, 1 operation

verify_otpVerify otpPOSTChecks a passcode a user entered. A match returns status VERIFIED (or EXPIRED when used after its validity), the messageid it was sent with and the metadata stored with it; no match answers 404.

Volume, 1 operation

get_message_volumeGet message volumeGETReturns the number of messages sent from your account since midnight.

Use The SMS Works from Claude Code, Cursor or Codex

Connect The SMS Works in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its The SMS Works operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect The SMS Works

Create your workspace
Sign up free. Nothing to install.
Connect The SMS Works once
Add your The SMS Works connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.