How to Use the eSputnik MCP in Claude Code

Q: Can I automate eSputnik contact updates in a shell script with Claude Code?

Yes, Claude Code uses createcontact to add new users to eSputnik via simple terminal commands. This allows Claude Code to automate your eSputnik batch-processing updates.

Q: How does Claude Code check eSputnik delivery statistics?

Claude Code queries getmessagestatus to output the exact state of your sent eSputnik campaigns. This lets you run Claude Code inside cron jobs to monitor eSputnik delivery rates.

Q: Can Claude Code manage my eSputnik marketing groups?

Yes, Claude Code uses the listgroups tool to display all your active eSputnik segments directly in your terminal. This allows Claude Code to verify your eSputnik group IDs before running update scripts.

Q: How do I configure the eSputnik MCP Server in Claude Code?

You configure the eSputnik MCP Server by running the claude mcp add command in your terminal. This command registers the eSputnik tools directly inside your Claude Code configuration.

Drive your eSputnik marketing campaigns directly from the command line with Claude Code, automating syncs and triggers in your shell.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect eSputnik MCP to Claude Code

Create your Vinkius account to connect eSputnik to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup eSputnik with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Event Triggering

The `trigger_event` tool lets you fire eSputnik marketing workflows directly from your shell using Claude Code. You can script Claude Code to trigger transactional eSputnik campaigns the moment your backend services deploy. This eliminates the need for complex middleware between Claude Code and your eSputnik account. Claude Code pipes the eSputnik output directly to your terminal logs. This makes it simple to debug eSputnik event payloads inside your existing Claude Code workflows.

Terminal-Based Contact Auditing with this MCP Server

The `search_contacts` tool allows Claude Code to look up eSputnik user records directly from your shell. You can quickly check an eSputnik user's status during a live Claude Code debugging session. Claude Code returns clean eSputnik JSON payloads that you can easily grep or pipe. You can also use `get_contact` inside Claude Code to pull deep profile metadata for specific users. This gives you instant visibility into your eSputnik marketing data right from your Claude Code session.

Automated List Pruning and Management

The `list_unsubscribed` tool enables Claude Code to fetch eSputnik opt-out lists during scheduled cron jobs. You can automate your data hygiene routines by piping this eSputnik output directly into Claude Code scripts. It ensures your eSputnik records stay compliant with privacy laws via Claude Code automation. To update your groups, Claude Code uses `detach_from_group` to remove those unsubscribed users from active campaigns. This keeps your eSputnik delivery metrics high and prevents spam complaints in Claude Code.

Setup guide

Set up eSputnik MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see esputnik-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest eSputnik transactions." It will automatically discover and invoke the available eSputnik tools.

Terminal

claude mcp add --transport http esputnik-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the eSputnik MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "esputnik-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by eSputnik. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect eSputnik now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about eSputnik MCP in Claude Code

Yes, Claude Code uses `create_contact` to add new users to eSputnik via simple terminal commands. This allows Claude Code to automate your eSputnik batch-processing updates.

Claude Code queries `get_message_status` to output the exact state of your sent eSputnik campaigns. This lets you run Claude Code inside cron jobs to monitor eSputnik delivery rates.

Yes, Claude Code uses the `list_groups` tool to display all your active eSputnik segments directly in your terminal. This allows Claude Code to verify your eSputnik group IDs before running update scripts.

You configure the eSputnik MCP Server by running the `claude mcp add` command in your terminal. This command registers the eSputnik tools directly inside your Claude Code configuration.

Your eSputnik contact emails, phone numbers, and unsubscribed addresses are handled in memory and never written to disk by Claude Code. Vinkius secures the eSputnik connection using a single-token endpoint, ensuring Claude Code never leaks your credentials.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript