How to Use the Maropost MCP in Claude Code

Q: How do I find a specific Maropost list ID via CLI?

Ask Claude Code to search your lists. It executes listlists and filters the output for your target name. You get the exact ID back in your terminal window instantly.

Run Maropost contact syncs and campaign reporting directly from your terminal using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Maropost MCP to Claude Code

Create your Vinkius account to connect Maropost 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 Maropost with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Maropost MCP Server for CLI

The `list_campaigns` tool lets you dump active marketing deployments straight to standard output. You trigger Claude Code from your terminal to grab the latest send metrics via `get_campaign_details`. It parses the JSON response and pipes the exact failure rates into your monitoring scripts. When you need automated weekly summaries, Claude Code chains `list_reports` with `get_report_details`. You run a single headless command via cron, and the agent fetches the specific report IDs, extracts the data, and writes a clean CSV to your local disk. No dashboard logins required.

Script Contact Management

The `create_contact` tool gives your shell scripts the ability to upsert subscribers during database migrations. You pipe a list of new user emails to Claude Code, and it loops through the payload, pushing each record to Maropost. It validates the insertion by running `get_contact` on the output. If you need to audit a specific segment, Claude Code fires `list_lists` to grab the internal directory. It then executes `list_contacts_in_list` to pull the specific audience members. You can pipe this output directly into grep or jq for fast terminal-based filtering.

Debug Marketing Workflows

The `list_workflows` tool outputs your active Maropost journeys directly to the command line. You check which automations are currently running without leaving your SSH session. This helps you verify that your backend events match the live marketing triggers. If a customer complains about missing a drip email, you tell the agent to run `get_workflow_details`. Claude Code pulls the exact node criteria for that specific journey. You compare the workflow requirements against your server logs to isolate the exact point of failure.

Setup guide

Set up Maropost 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 maropost-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http maropost-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 Maropost 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": {
    "maropost-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 Maropost. 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 Maropost 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 Maropost MCP in Claude Code

Run claude mcp add --transport http maropost-mcp -- in your terminal. Ensure all flags precede the server name. Verify the connection by running claude mcp list.

You can write a shell script that uses Claude Code to iterate over a file. The agent will call create_contact for each record. For massive lists, a native CSV upload is faster than sequential API calls.

Ask Claude Code to search your lists. It executes list_lists and filters the output for your target name. You get the exact ID back in your terminal window instantly.

No. The server provides read-only access to journeys. You use list_workflows and get_workflow_details to inspect the trigger logic, but modifications require the web interface.

The tools access personally identifiable information like emails and campaign engagement metrics. Vinkius handles the authorization externally. Your terminal only holds a single endpoint token, and the API requests execute in an isolated environment that discards all state after the command exits.

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