Esputnik MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Esputnik MCP or direct API to send campaigns, automate email and SMS workflows, segment audiences, and monitor engagement through natural language.

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

Try Esputnik now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Esputnik
Try asking
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.

SETUP GUIDE

Connect Esputnik MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["esputnik"],
  mcp: true,
});
Create a session scoped to Esputnik and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Send SMS campaign to new contacts",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Esputnik request
SETUP GUIDE

Connect Esputnik API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["esputnik"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Esputnik
3

Run Esputnik tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Send SMS campaign to new contacts" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Esputnik tool calls through the session, and print the final answer

Why Use Composio?

AI Native Esputnik Integration

  • Supports both Esputnik MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Esputnik data

Managed Auth

  • Built-in API key handling with secure credential storage
  • Central place to manage, scope, and revoke Esputnik access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Esputnik
  • Scoped, least privilege access to Esputnik resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
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