Integration

Octopush integration

Octopush is an SMS and multichannel messaging platform. Send SMS and Voice SMS campaigns to recipients given inline or to your contact lists and tags (prepare, confirm, track, cancel), send multichannel messages (SMS, Voice SMS, RCS, email, live chat), send and validate one-time codes, manage contacts, contact lists and opt-outs, run HLR, number portability, RCS compatibility and email verification lookups, read conversations, agents and virtual numbers, and check balance, credits and monthly consumption. Sub-account management, credit transfers, changes to Automatic Reload and campaign settings, file uploads and the separate email-campaign API are not exposed. Authentication sends two headers on every call: api-login and api-key, the API identifiers of your Octopush account.

Connect Octopush How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Octopush.Built from the 44 Octopush tools below, on the connection you add once.

What you can do with Octopush

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.

Contact list, 4 operations

create_contact_listCreate contact listPOSTCreate a contact list with the given list_name.
delete_contact_listDelete contact listDELETEDelete a contact list. With delete_contacts=true its contacts are also deleted from your account.
empty_contact_listEmpty contact listPOSTRemove every contact from a contact list. With delete_contacts=true the contacts are also deleted from your account.
list_contact_listsList contact listsGETList your contact lists, with each list's name, creation date and number of contacts. Pass a name as list_name to the campaign and contact tools.

Sms list campaign, 4 operations

cancel_sms_list_campaignCancel sms list campaignDELETECancel an SMS campaign to a contact list or tag, by the ticket_number returned by prepare_sms_list_campaign.
confirm_sms_list_campaignConfirm sms list campaignPOSTConfirm and send an SMS campaign prepared with prepare_sms_list_campaign. Returns send_at, when it goes out. Track it with get_sms_list_campaign_status.
get_sms_list_campaign_statusGet sms list campaign statusGETGet the status of an SMS campaign sent to a contact list or tag: status, number of contacts and cost.
prepare_sms_list_campaignPrepare sms list campaignPOSTPrepare an SMS campaign to one of your contact lists or tags. Nothing is sent yet: returns a ticket_number to pass to confirm_sms_list_campaign, which sends it.

Voice sms list campaign, 4 operations

cancel_voice_sms_list_campaignCancel voice sms list campaignDELETECancel a Voice SMS campaign to a contact list or tag, by the ticket_number returned by prepare_voice_sms_list_campaign.
confirm_voice_sms_list_campaignConfirm voice sms list campaignPOSTConfirm and send a Voice SMS campaign prepared with prepare_voice_sms_list_campaign. Returns send_at. Track it with get_voice_sms_list_campaign_status.
get_voice_sms_list_campaign_statusGet voice sms list campaign statusGETGet the status of a Voice SMS campaign sent to a contact list or tag: status, number of contacts, estimated duration and cost.
prepare_voice_sms_list_campaignPrepare voice sms list campaignPOSTPrepare a Voice SMS campaign to one of your contact lists or tags. Nothing is sent yet: returns a ticket_number to pass to confirm_voice_sms_list_campaign.

Contact, 3 operations

add_contactsAdd contactsPOSTAdd contacts to your account and attach them to a contact list or a tag (created if needed). Returns the status of each phone number or email.
delete_contactsDelete contactsDELETERemove contacts, given by phone_numbers or emails, from a contact list or tag, or delete them from your account.
get_contactGet contactGETGet a contact by phone_number or email (one of the two is required): name, custom params 1 to 5, the lists and tags it belongs to, and HLR line information.

Conversation, 3 operations

assign_conversation_agentAssign conversation agentPUTAssign an agent (by email, see list_agents) to a conversation (conversation_id from list_conversations).
create_conversationCreate conversationPOSTStart a new multichannel conversation with a contact on sms, rcs or email. Returns the conversation, including conversation_id.
list_conversationsList conversationsGETList your multichannel conversations (SMS, RCS, email, live chat) with recipient, assigned agent, last message and message count. Paginate with page and per_page (default 100).

Phone number, 3 operations

check_rcs_compatibilityCheck rcs compatibilityPOSTCheck whether 1 to 500 phone numbers can receive RCS messages. Results are POSTed per number to callback_url as {phone_number, is_rcs_compatible}; the answer gives request_id and cost.
hlr_lookupHlr lookupPOSTHLR lookup on phone numbers: whether the line exists and is active, its operator, country and porting status. Billed per number; set simulation_mode=true for a fake result.
mnp_lookupMnp lookupPOSTMobile number portability check: tells whether each phone number moved to another operator, with current and original network. Billed per number; set simulation_mode=true for a fake result.

Sms campaign, 3 operations

cancel_sms_campaignCancel sms campaignDELETECancel a draft or scheduled SMS campaign by ticket_number. Allowed only for campaigns with fewer than 3 recipients and scheduled more than 10 minutes ahead; at most 1000 cancellations per month.
get_sms_campaign_draftGet sms campaign draftGETGet your draft SMS campaign, if you have one: its ticket_number, number of contacts, SMS needed, total cost, status and residual credit.
send_sms_campaignSend sms campaignPOSTSend an SMS campaign to up to 500 recipients given inline, now or at send_at. Returns sms_ticket (pass it to cancel_sms_campaign), the cost and the residual credit. Set simulation_mode=true to test without sending.

Voice sms campaign, 3 operations

cancel_voice_sms_campaignCancel voice sms campaignDELETECancel a draft or scheduled Voice SMS campaign by ticket_number. Allowed only for campaigns with fewer than 3 recipients and scheduled more than 10 minutes ahead; at most 1000 cancellations per month.
get_voice_sms_campaign_draftGet voice sms campaign draftGETGet your draft Voice SMS campaign, if you have one: ticket_number, status, number of contacts, total cost, estimated duration and residual credit.
send_voice_sms_campaignSend voice sms campaignPOSTSend a Voice SMS (text read aloud by a synthetic voice) to up to 500 recipients given inline. Returns ticket_number, cost and estimated duration. Needs the Voice SMS service enabled on the account.

Multichannel message, 2 operations

cancel_multichannel_messageCancel multichannel messageDELETECancel a draft or scheduled multichannel message by channel and ticket_number. Allowed only with fewer than 3 recipients and more than 10 minutes before sending; at most 1000 cancellations per month.
send_multichannel_messageSend multichannel messagePOSTSend a message on one channel (sms, voice_sms, rcs, email or live_chat) to 1 to 500 recipients, now or at send_at. Returns ticket_number (pass it to cancel_multichannel_message) and the cost.

Optout, 2 operations

optout_contactsOptout contactsPOSTAdd phone numbers and/or email addresses (up to 200 of each) to your opt-out list so they stop receiving campaigns. Returns how many were really added.
remove_contacts_from_optoutRemove contacts from optoutPOSTRemove phone numbers and/or email addresses (up to 200 of each) from your opt-out list so they can receive campaigns again. Returns how many were really removed.

Otp, 2 operations

send_otpSend otpPOSTGenerate a one-time code and send it by SMS or Voice SMS to phone_number. Returns otp_request_token: pass it with the code the user typed to validate_otp.
validate_otpValidate otpPUTCheck a one-time code typed by the user, with the otp_request_token returned by send_otp and the phone number. Returns a message and the remaining number of attempts.

Agent, 1 operation

list_agentsList agentsGETList the agents (users) of your account with email, name, role, status and permissions. Use an email as agent_email in assign_conversation_agent.

Attached file, 1 operation

list_attached_filesList attached filesGETList the files you attached to messages as short links, with name, short URL, creation and expiration dates and download count.

Auto reload settings, 1 operation

get_auto_reload_settingsGet auto reload settingsGETGet your Automatic Reload settings: whether it is active, the product and country, the threshold quantity, the amount to order and the monthly budget.

Balance, 1 operation

check_sms_balanceCheck sms balanceGETGet your SMS balance (amount and unit). Optionally narrow to one product and country (give both), or add the detail of every credit pack with with_details=true.

Campaign settings, 1 operation

get_campaign_settingsGet campaign settingsGETGet your default campaign configuration: balance alert parameters, default senders and test phone number, and the callback URLs for inbound messages, delivery reports, opt-outs and visits.

Consumption, 1 operation

get_monthly_consumptionGet monthly consumptionPOSTGet the number of sendings and their cost for one channel and month, with a breakdown per agent.

Conversation message, 1 operation

list_conversation_messagesList conversation messagesGETList the messages of a conversation, found by phone_number, email, facebook_id (fid_<id>) or conversation_id (cid_<uuid>). Paginate with page and per_page (default 50).

Credit, 1 operation

check_credits_per_serviceCheck credits per serviceGETGet how many sends you have left per product (premium_sms, low_cost_sms, voice_sms, hlr) for each country, optionally limited to some country codes. The answer is an object keyed by country code.

Email, 1 operation

verify_emailsVerify emailsPOSTVerify up to 1000 email addresses (valid, invalid or unknown). Returns the request ids, the cost and the number of emails submitted.

Landing page, 1 operation

list_landing_pagesList landing pagesGETList your landing pages with name, short URL, title, status, redirect URL and expiration date, optionally filtered by type.

Virtual number, 1 operation

list_virtual_numbersList virtual numbersGETList your virtual numbers with country, subscription dates, next payment, daily SMS cap and SMS remaining today.

Use Octopush from Claude Code, Cursor or Codex

Connect Octopush in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Octopush 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 Octopush

Create your workspace
Sign up free. Nothing to install.
Connect Octopush once
Add your Octopush 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.