How to connect Esputnik to Grok Bot

Connect Grok Bot to Esputnik MCP. Bulk add 500 new email contacts, delete sms message template with id 123, and more using natural language, with authentication handled for you.

Esputnik logoEsputnik
Api Key

eSputnik is a marketing automation platform for managing emails, SMS, and push notifications. It helps businesses streamline customer communications across multiple channels.

89 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect Esputnik to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Esputnik in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Esputnik with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting Esputnik to Grok Bot

Once Grok Bot is set up, you connect Esputnik entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect Esputnik

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your Esputnik account

Back in the chat, ask your bot to connect to Esputnik or give it any Esputnik task.

For example, ask it to:

  • "Bulk add 500 new email contacts"
  • "Delete SMS message template with ID 123"
  • "Get status of yesterday's contact import"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Esputnik account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like Esputnik through MCP without you sharing account credentials directly with the agent.

What is the Esputnik MCP server, and what's possible with it?

The Esputnik MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Esputnik account. It provides structured and secure access to your marketing automation tools, so your agent can perform actions like sending broadcasts, managing contacts, importing data, and handling push notifications on your behalf.

  • Bulk contact import and management: Quickly add or update thousands of contacts at once, check import status, and keep your lists up to date with minimal effort.
  • Broadcast and message control: Retrieve, review, and manage your marketing broadcasts and app inbox messages, ensuring your campaigns run smoothly.
  • Order and transactional data automation: Import and synchronize large batches of order data, keeping your marketing segmentation and triggers accurate and relevant.
  • Push and SMS notification management: Activate or deactivate push tokens, delete outdated SMS templates, and fine-tune your notification workflows directly through your agent.
  • Domain and integration setup: Register domains for web tracking or widgets, helping you expand and customize your communication reach seamlessly.

Way Forward

Now that Esputnik is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every Esputnik action and event your agent gets out of the box.

Add Contact

Add or update a single eSputnik contact, matching existing contacts by channel; new contacts are treated as confirmed.

Add Domain

Register a domain with eSputnik for web tracking, widgets, or web push notifications.

Add Orders Bulk

Tool to transfer orders in bulk to eSputnik.

Add Unsubscribed Emails

Add email addresses to the unsubscribed list.

Add Web Push Domain

Tool to add a domain for web push notifications in eSputnik.

Attach Contacts to Segment

Tool to attach contacts to a static segment (group) by contact IDs or external customer IDs.

Bulk Add or Update Contacts

Bulk add or update up to 3,000 contacts asynchronously, matching on the selected deduplication channel; new contacts are treated as confirmed.

Change Mobile Push Token Activity

Activate or deactivate a registered eSputnik mobile push token for an application to control whether a device can receive push notifications.

Create API Token

Generate an eSputnik API token using the configured credentials.

Create App Inbox Message

Tool to create a basic App Inbox message in eSputnik.

Create Contacts from File

Import or update contacts from an external file in eSputnik.

Create Email Message

Tool to create or update an email message in eSputnik.

Create Mobile Push Message

Tool to create a new mobile push notification message in eSputnik.

Create SMS Message

Tool to create a basic SMS message template in eSputnik.

Create Telegram Message

Create a basic Telegram bot message in eSputnik.

Delete App Inbox Message

Tool to delete an App Inbox message by its ID from eSputnik.

Delete App Inbox Translation

Delete a language translation of an App Inbox message from eSputnik.

Delete Broadcast

Tool to cancel a scheduled broadcast campaign.

Delete Contact

Tool to delete a contact by its Yespo ID.

Delete Contact by External ID

Delete a contact from eSputnik using their external customer ID.

Delete Email Message

Delete a basic email message by its ID from eSputnik.

Delete Email Translation

Delete a translation of a base email message from eSputnik.

Delete Mobile Push Message

Delete a base Mobile Push message by its ID from eSputnik.

Delete Mobile Push Translation

Delete a language version of a base Mobile Push message from eSputnik.

Delete Orders

Tool to schedule asynchronous deletion of orders in eSputnik.

Delete SMS Message

Delete a base SMS message template by its ID from eSputnik.

Delete SMS Translation

Delete a language version of a base SMS message from eSputnik.

Delete Telegram Message

Delete a base Telegram bot message by its ID from eSputnik.

Delete Telegram Translation

Delete a language version of a Telegram bot message from eSputnik.

Detach Contacts from Segment

Remove contacts from a static segment by internal contact IDs or external customer IDs, with at most 500 entries per ID list.

Generate Event V2

Tool to send backend events from websites and mobile apps to eSputnik.

Generate Event V3

Tool to generate events in eSputnik v3 API.

Generate Past Events V2

Tool to transfer past event data from your CRM or data store to eSputnik using v2 API.

Generate Past Events V3

Tool to generate past events in eSputnik v3 API.

Get Account Info

Retrieve basic eSputnik account information.

Get App Inbox Message

Retrieves an App Inbox message by its unique identifier from eSputnik.

Get Broadcasts

Retrieve a paginated list of broadcast campaigns from eSputnik.

Get Contact

Retrieve a contact by its internal eSputnik ID, including available profile details, supported communication channels, and custom fields.

Get Contact Emails

Tool to retrieve email addresses of contacts by their contact IDs.

Get Contact Import Status

Retrieve the status of an asynchronous contact import session using its session ID.

Get Contact Message History

Retrieve a contact's message history across multiple channels from eSputnik.

Get Contacts

Search for contacts in eSputnik using various filter criteria.

Get Contact Subscriptions

Retrieve all subscription categories a contact is enrolled in.

Get Email Interfaces

Tool to retrieve all configured email interfaces (sender names) from eSputnik.

Get Email Message

Retrieves an eSputnik email message by ID, returning available content, subject, sender details, and CSS fields.

Get Email View Link

Get a link to view an email message in browser from eSputnik.

Get Message Status

Retrieve delivery status for single messages sent through the eSputnik API using comma-separated request IDs returned by send operations.

Get Mobile Push Message

Retrieves an eSputnik mobile push message by ID, returning available message fields such as title, text, time-to-live and sound settings.

Get Organization Balance

Retrieve the authenticated eSputnik organization's balance and currency, along with credit limit and bonus email and SMS resources when available.

Get Organization Billing History

Retrieve the organization's billing history from eSputnik, broken down by day and media channel.

Get Preprocessor File Status

Retrieve the status of an asynchronous preprocessor file upload session using its session ID.

Get Product Feeds Configuration

Retrieve eSputnik product feed configuration to inspect the account's feed settings.

Get Promocodes Count

Get the number of available promotional codes in eSputnik.

Get Site Domain

Retrieve the authenticated organization's eSputnik domain configuration to check its configured site domain.

Get Site Tracking Script

Retrieve the site tracking script for your eSputnik account.

Get SMS Interfaces

Retrieve all SMS interfaces (alpha names) configured for the organization.

Get Subscription Categories

Retrieve all subscription categories for the organization.

Get Telegram Message

Retrieve a Telegram bot message by its unique identifier from eSputnik.

List Promotional Codes

Retrieve a list of promotional codes from eSputnik.

List Web Push Domains

Retrieve the list of domains registered for web push notifications.

Remove From Unsubscribed

Tool to remove email addresses from the unsubscribed contacts list in eSputnik.

Search App Inbox Messages

Search for mobile App Inbox messages using a part of the name or a tag.

Search Contacts

Search for all contacts in a segment (group).

Search Email Messages

Search for email messages using a part of their name or a tag.

Search Mobile Push Messages

Search for mobile push messages using part of the name or a tag.

Search Segments

Search for and retrieve available segments (groups) in eSputnik.

Search SMS Messages

Search eSputnik SMS message templates by name or tag, with pagination and up to 500 requested per page.

Search Telegram Messages

Search eSputnik Telegram bot messages by name or tag, with pagination and up to 500 requested per page.

Search Viber Messages

Search for Viber messages using part of the name or a tag.

Search Workflows

Search for and retrieve available workflows from eSputnik.

Send Email

Send an email to one or more addresses via eSputnik, with HTML and optional plain text, AMP content, and URL tracking; missing recipient contacts are automatically created.

Send Prepared Message

Tool to send a prepared message to one or many contacts.

Subscribe Contact

Tool to subscribe a contact for double opt-in implementation.

Update App Inbox Message

Update an existing eSputnik base App Inbox message by ID.

Update App Inbox Translation

Tool to update or add a language version for an App Inbox message in eSputnik.

Update Contact

Tool to update contact information by contact ID.

Update Contact Subscriptions

Tool to update the subscription categories a contact is enrolled in.

Update Email Message

Tool to update an existing email message in eSputnik.

Update Email Translation

Tool to update or add a language version for a base email message in eSputnik.

Update Interaction Status

Tool to update the status of a message interaction using interaction_id.

Update Mobile Push Message

Tool to update an existing mobile push notification message in eSputnik.

Update Mobile Push Translation

Tool to update or add a language version for a mobile push message in eSputnik.

Update Preprocessor File By ID

Tool to update a preprocessor file's data by providing a new external link.

Update SMS Message

Tool to update an existing base SMS message template in eSputnik.

Update SMS Translation

Tool to update a language version of an SMS message in eSputnik.

Update Telegram Message

Update a base Telegram bot message in eSputnik.

Update Telegram Translation

Update a translated telegram bot message in eSputnik.

Upload Preprocessor File

Upload a preprocessor data file from an external URL with an optional TTL.

Upload Promotional Codes

Tool to upload promotional codes to eSputnik in bulk.

FAQ

Frequently asked questions

Start with Esputnik.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Esputnik tool your agent needs.Free to start.

Start building