Listmonk MCP Server for Pydantic AIGive Pydantic AI instant access to 28 tools to Create Campaign, Create List, Create Public Subscription, and more

Name: Listmonk
Price: 29 USD
Availability: InStock
Rating: 5.0 (1 reviews)
Author: Vinkius

GDPR Free for Subscribers

Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Listmonk through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.

Ask AI about this MCP Server for Pydantic AI

Open in ChatGPT Open in Claude Open in Perplexity

The Listmonk MCP Server for Pydantic AI is a standout in the Marketing Automation category — giving your AI agent 28 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

python

import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

    agent = Agent(
        model="openai:gpt-4o",
        mcp_servers=[server],
        system_prompt=(
            "You are an assistant with access to Listmonk "
            "(28 tools)."
        ),
    )

    result = await agent.run(
        "What tools are available in Listmonk?"
    )
    print(result.data)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Listmonk MCP Server

Connect your Listmonk instance to any AI agent and take full control of your email marketing workflows through natural conversation.

Pydantic AI validates every Listmonk tool response against typed schemas, catching data inconsistencies at build time. Connect 28 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.

What you can do

Subscriber Management — List, create, update, or delete subscribers using SQL-like queries for precise filtering via list_subscribers and create_subscriber.
List Organization — Manage your mailing lists and public subscriptions to keep your audience segmented using list_lists and create_list.
Campaign Control — Create, monitor, and update the status of your email campaigns from draft to sent with create_campaign and update_campaign_status.
Transactional Emails — Send high-priority transactional messages instantly via the send_transactional tool.
Media & Templates — Manage your asset library and email templates without leaving your chat interface using list_templates and list_media.

The Listmonk MCP Server exposes 28 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 28 Listmonk tools available for Pydantic AI

When Pydantic AI connects to Listmonk through Vinkius, your AI agent gets direct access to every tool listed below — spanning newsletter-management, mailing-lists, subscriber-management, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

create

Create campaign on Listmonk

Create a new campaign

create

Create list on Listmonk

Create a new list

create

Create public subscription on Listmonk

Create a public subscription

create

Create subscriber on Listmonk

Create a new subscriber

create

Create template on Listmonk

Create a template

delete

Delete bounces on Listmonk

Delete multiple bounce records

delete

Delete campaign on Listmonk

Delete a campaign

delete

Delete list on Listmonk

Delete a list

delete

Delete media on Listmonk

Delete a media file

delete

Delete subscriber on Listmonk

Delete a specific subscriber

delete

Delete template on Listmonk

Delete a template

get

Get campaign on Listmonk

Retrieve a specific campaign

get

Get import status on Listmonk

Retrieve import status

get

Get subscriber on Listmonk

Retrieve a specific subscriber

list

List bounces on Listmonk

Retrieve bounce records

list

List campaigns on Listmonk

Retrieve all campaigns

list

List lists on Listmonk

Retrieve all lists

list

List media on Listmonk

Get uploaded media files

list

List public lists on Listmonk

Retrieve public lists

list

List subscribers on Listmonk

Supports pagination, list filtering, and SQL expression search. Query and retrieve subscribers

list

List templates on Listmonk

Retrieve all templates

patch

Patch subscriber on Listmonk

Partially update a subscriber

send

Send transactional message on Listmonk

Send transactional messages to one or more subscribers using a template

stop

Stop import on Listmonk

Stop an ongoing import

update

Update campaign status on Listmonk

Change campaign status

update

Update list on Listmonk

Update a list

update

Update subscriber on Listmonk

Update a specific subscriber

update

Update template on Listmonk

Update a template

Connect Listmonk to Pydantic AI via MCP

Follow these steps to wire Listmonk into Pydantic AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

Install Pydantic AI

Run pip install pydantic-ai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.py and run: python agent.py

Explore tools

The agent discovers 28 tools from Listmonk with type-safe schemas

Why Use Pydantic AI with the Listmonk MCP Server

Pydantic AI provides unique advantages when paired with Listmonk through the Model Context Protocol.

Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application

Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Listmonk integration code

Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors

Dependency injection system cleanly separates your Listmonk connection logic from agent behavior for testable, maintainable code

Listmonk + Pydantic AI Use Cases

Practical scenarios where Pydantic AI combined with the Listmonk MCP Server delivers measurable value.

Type-safe data pipelines: query Listmonk with guaranteed response schemas, feeding validated data into downstream processing

API orchestration: chain multiple Listmonk tool calls with Pydantic validation at each step to ensure data integrity end-to-end

Production monitoring: build validated alert agents that query Listmonk and output structured, schema-compliant notifications

Testing and QA: use Pydantic AI's dependency injection to mock Listmonk responses and write comprehensive agent tests

Example Prompts for Listmonk in Pydantic AI

Ready-to-use prompts you can give your Pydantic AI agent to start working with Listmonk immediately.

"List all subscribers who are currently enabled in list 2."

"Create a new campaign named 'Monthly Newsletter' with the subject 'Our latest updates'."

"Show me all available email templates."

Troubleshooting Listmonk MCP Server with Pydantic AI

Common issues when connecting Listmonk to Pydantic AI through Vinkius, and how to resolve them.

MCPServerHTTP not found

Update: pip install --upgrade pydantic-ai

Listmonk + Pydantic AI FAQ

Common questions about integrating Listmonk MCP Server with Pydantic AI.

How does Pydantic AI discover MCP tools?

Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.

Does Pydantic AI validate MCP tool responses?

Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.

Can I switch LLM providers without changing MCP code?

Absolutely. Pydantic AI abstracts the model layer. your Listmonk MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.

Explore More MCP Servers

View all →

Commerce Layer

12 tools

Add headless commerce capabilities to any website or app with APIs for orders, SKUs, prices, and inventory management.

MOBIDI

12 tools

Manage your mobile advertising campaigns with real-time bidding, audience targeting, and performance analytics for app installs.

Travelport

21 tools

Access Travelport's Global Distribution System to search and book flights, hotels, and manage travel reservations directly through AI.

Drata

10 tools

Automate compliance and security via Drata — monitor controls, track personnel onboarding, audit policies, and verify cloud asset security directly from any AI agent.