v0.4.0 — Landing page CRUD, member notes, template metadata

This release rounds out three areas of the Mailchimp Marketing API coverage:
full landing page lifecycle management, CRM-style internal notes on members,
and a metadata-only template lookup. The server now exposes 97 tools (up
from 87) and continues to ship with read-only and dry-run safety modes.

Fully backwards-compatible — no existing tool signatures changed.

Highlights

Landing page lifecycle

Five new tools that extend landing pages beyond read-only. You can now build
the complete create → edit → publish loop from your MCP client.

# Create a draft page from an existing template
create_landing_page(
    name="Spring Promo",
    title="Spring sale: 20% off",
    list_id="abc123",
    template_id="42",
)

# Make it live
publish_landing_page(page_id="page_xyz")

# Take it offline (reversible) or delete (permanent)
unpublish_landing_page(page_id="page_xyz")
delete_landing_page(page_id="page_xyz")

The full set: create_landing_page, update_landing_page,
delete_landing_page, publish_landing_page, unpublish_landing_page.

Member notes (CRM-style)

Four new tools for internal annotations on contacts — notes that are never
sent to the contact, only visible to the team in the Mailchimp dashboard.
Useful for sales/support context: "Asked about annual plan discount", "VIP
customer", "Do not contact until Q3".

# Attach a note
add_member_note(
    list_id="abc123",
    email_address="[email protected]",
    note="VIP customer — flagged by support on May 16",
)

# List, update, delete
list_member_notes(list_id="abc123", email_address="[email protected]")
update_member_note(list_id="abc123", email_address="[email protected]", note_id="7", note="Updated context")
delete_member_note(list_id="abc123", email_address="[email protected]", note_id="7")

Template metadata lookup

get_template returns template metadata (name, type, dates, thumbnail, share
URL, folder) without fetching the full HTML body. Pair it with the existing
get_template_default_content when you need both metadata and content.

What's in this release

Added

• Landing page write tools (closes #11):
  • create_landing_page
  • update_landing_page
  • delete_landing_page
  • publish_landing_page
  • unpublish_landing_page
• Member notes CRUD (closes #8):
  • list_member_notes
  • add_member_note
  • update_member_note
  • delete_member_note
• get_template for metadata-only template lookup (closes #10)
• 10 new smoke tests covering subscriber-hash routing on notes, the JSON-shape
  contracts on landing page actions, and the template metadata response

Changed

• Tool count bumped to 97 (was 87) across README.md, glama.json, and
  the pyproject.toml description
• Version bumped to 0.4.0

Install

Recommended (no install):

uvx mailchimp-mcp

Via pip:

pip install --upgrade mailchimp-mcp

Configure your MCP client to launch uvx mailchimp-mcp with
MAILCHIMP_API_KEY in the environment. See the
README for the
full configuration block.

Safety modes

All new write tools respect the existing safety modes:

• MAILCHIMP_READ_ONLY=true — blocks all writes (including landing page
  publish/unpublish and member note creation/edits/deletes)
• MAILCHIMP_DRY_RUN=true — returns a preview of the action without calling
  the API

Feedback

Bug reports, feature requests, and PRs are welcome — see
CONTRIBUTING.md.

Full Changelog: https://github.com/damientilman/mailchimp-mcp-server/compare/v0.3.0...v0.4.0