matimo-mailchimp 0.1.0__tar.gz

matimo_mailchimp-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+**/node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+**/dist/
+*.tsbuildinfo
+
+# Python compiled / build
+**/__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+**/build/
+**/.eggs/
+**/.venv/
+**/.mypy_cache/
+**/.ruff_cache/
+**/.pytest_cache/
+
+# Test coverage
+**/coverage/
+**/.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+typescript/examples/mcp/matimo-tools/.matimo-approvals.json
+typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
+typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
+typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/matimo-health-check/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/moltbook-identity/SKILL.md
+typescript/packages/cli/.matimo/certs/server.crt
+typescript/packages/cli/.matimo/certs/server.key
+typescript/examples/mcp/.matimo/certs/server.crt
+typescript/examples/mcp/.matimo/certs/server.key

matimo_mailchimp-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: matimo-mailchimp
+Version: 0.1.0
+Summary: Matimo provider — Mailchimp tools (campaigns, lists, members)
+License: MIT
+Keywords: agents,ai,mailchimp,matimo,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Description-Content-Type: text/markdown
+
+# matimo-mailchimp
+
+> Mailchimp tools for [Matimo](https://matimo.dev) — manage campaigns, lists, and subscribers.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-mailchimp)](https://pypi.org/project/matimo-mailchimp/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-mailchimp
+```
+
+---
+
+## Available Tools (7 Total)
+
+| Tool | Description |
+|------|-------------|
+| `mailchimp-get-lists` | List all audiences (lists) in your account |
+| `mailchimp-get-list-members` | Get subscribers in an audience |
+| `mailchimp-add-list-member` | Subscribe an email address to an audience |
+| `mailchimp-update-list-member` | Update subscriber tags, status, or merge fields |
+| `mailchimp-remove-list-member` | Unsubscribe or archive a list member |
+| `mailchimp-create-campaign` | Create a new email campaign |
+| `mailchimp-send-campaign` | Send a campaign to its audience |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_mailchimp import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # List all audiences
+    lists = await matimo.execute('mailchimp-get-lists', {})
+    print(lists)
+
+    # Add a subscriber
+    await matimo.execute('mailchimp-add-list-member', {
+        'list_id': 'abc123def',
+        'email_address': 'new@example.com',
+        'status': 'subscribed',
+        'merge_fields': {'FNAME': 'Jane', 'LNAME': 'Doe'},
+    })
+
+    # Create and send a campaign
+    campaign = await matimo.execute('mailchimp-create-campaign', {
+        'list_id': 'abc123def',
+        'subject_line': 'April Newsletter',
+        'from_name': 'My Company',
+        'reply_to': 'hello@example.com',
+    })
+    await matimo.execute('mailchimp-send-campaign', {
+        'campaign_id': campaign['id'],
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export MAILCHIMP_API_KEY="your-api-key-us1"     # includes datacenter suffix
+export MAILCHIMP_SERVER_PREFIX="us1"             # datacenter prefix from your API key
+```
+
+### Getting Mailchimp API Credentials
+
+1. Log in to [Mailchimp](https://mailchimp.com) → **Profile** → **Extras** → **API keys**
+2. Click **Create A Key**
+3. Copy the API key — the suffix (`us1`, `us6`, etc.) is your server prefix
+
+---
+
+## Documentation
+
+- [Mailchimp Marketing API](https://mailchimp.com/developer/marketing/api/)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/mailchimp)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-mailchimp/
+- **GitHub:** https://github.com/tallclub/matimo
+- **Mailchimp Developer Docs:** https://mailchimp.com/developer/
+

matimo_mailchimp-0.1.0/README.md

@@ -0,0 +1,98 @@
+# matimo-mailchimp
+
+> Mailchimp tools for [Matimo](https://matimo.dev) — manage campaigns, lists, and subscribers.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-mailchimp)](https://pypi.org/project/matimo-mailchimp/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-mailchimp
+```
+
+---
+
+## Available Tools (7 Total)
+
+| Tool | Description |
+|------|-------------|
+| `mailchimp-get-lists` | List all audiences (lists) in your account |
+| `mailchimp-get-list-members` | Get subscribers in an audience |
+| `mailchimp-add-list-member` | Subscribe an email address to an audience |
+| `mailchimp-update-list-member` | Update subscriber tags, status, or merge fields |
+| `mailchimp-remove-list-member` | Unsubscribe or archive a list member |
+| `mailchimp-create-campaign` | Create a new email campaign |
+| `mailchimp-send-campaign` | Send a campaign to its audience |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_mailchimp import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # List all audiences
+    lists = await matimo.execute('mailchimp-get-lists', {})
+    print(lists)
+
+    # Add a subscriber
+    await matimo.execute('mailchimp-add-list-member', {
+        'list_id': 'abc123def',
+        'email_address': 'new@example.com',
+        'status': 'subscribed',
+        'merge_fields': {'FNAME': 'Jane', 'LNAME': 'Doe'},
+    })
+
+    # Create and send a campaign
+    campaign = await matimo.execute('mailchimp-create-campaign', {
+        'list_id': 'abc123def',
+        'subject_line': 'April Newsletter',
+        'from_name': 'My Company',
+        'reply_to': 'hello@example.com',
+    })
+    await matimo.execute('mailchimp-send-campaign', {
+        'campaign_id': campaign['id'],
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export MAILCHIMP_API_KEY="your-api-key-us1"     # includes datacenter suffix
+export MAILCHIMP_SERVER_PREFIX="us1"             # datacenter prefix from your API key
+```
+
+### Getting Mailchimp API Credentials
+
+1. Log in to [Mailchimp](https://mailchimp.com) → **Profile** → **Extras** → **API keys**
+2. Click **Create A Key**
+3. Copy the API key — the suffix (`us1`, `us6`, etc.) is your server prefix
+
+---
+
+## Documentation
+
+- [Mailchimp Marketing API](https://mailchimp.com/developer/marketing/api/)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/mailchimp)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-mailchimp/
+- **GitHub:** https://github.com/tallclub/matimo
+- **Mailchimp Developer Docs:** https://mailchimp.com/developer/
+

matimo_mailchimp-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "matimo-mailchimp"
+version = "0.1.0"
+description = "Matimo provider — Mailchimp tools (campaigns, lists, members)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["ai", "tools", "agents", "matimo", "mailchimp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "matimo-core>=0.1.0,<0.2.0",
+]
+
+[project.entry-points."matimo.providers"]
+mailchimp = "matimo_mailchimp:get_tools_path"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/matimo_mailchimp"]

matimo_mailchimp-0.1.0/src/matimo_mailchimp/__init__.py

@@ -0,0 +1,17 @@
+"""Matimo mailchimp provider — exposes the path to YAML tool definitions."""
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+
+def get_tools_path() -> str:
+    """Return the absolute path to the bundled mailchimp tool definitions."""
+    try:
+        ref = importlib.resources.files("matimo_mailchimp") / "tools"
+        return str(ref)
+    except Exception:
+        return str(Path(__file__).parent / "tools")
+
+
+__all__ = ["get_tools_path"]

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-add-list-member/definition.yaml

@@ -0,0 +1,117 @@
+name: mailchimp-add-list-member
+version: '1.0.0'
+description: >
+  Add a new subscriber to a Mailchimp audience (list). Use this to subscribe
+  a contact to receive email campaigns. Supports setting merge fields (first name, last name)
+  and tags for segmentation.
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  list_id:
+    type: string
+    required: true
+    description: The unique ID of the Mailchimp audience/list to add the member to
+  email_address:
+    type: string
+    required: true
+    description: The email address of the subscriber to add
+  status:
+    type: string
+    required: true
+    description: >
+      Subscriber status: "subscribed" (opted in), "unsubscribed" (opted out),
+      "pending" (requires email confirmation), or "cleaned" (invalid email)
+    enum:
+      - subscribed
+      - unsubscribed
+      - pending
+      - cleaned
+  merge_fields:
+    type: object
+    required: false
+    description: >
+      Key-value pairs for merge fields such as FNAME (first name) and LNAME (last name).
+      Example: {"FNAME": "Jane", "LNAME": "Doe"}
+  tags:
+    type: array
+    required: false
+    description: Array of tag names to apply to the subscriber for segmentation
+
+execution:
+  type: http
+  method: POST
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/lists/{list_id}/members'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  body:
+    email_address: '{email_address}'
+    status: '{status}'
+    merge_fields: '{merge_fields}'
+    tags: '{tags}'
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    data:
+      type: object
+      properties:
+        id:
+          type: string
+          description: MD5 hash of the subscriber email (subscriber_hash)
+        email_address:
+          type: string
+        status:
+          type: string
+        merge_fields:
+          type: object
+        tags:
+          type: array
+        list_id:
+          type: string
+        timestamp_opt:
+          type: string
+        timestamp_signup:
+          type: string
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Subscribe a new contact'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      email_address: jane@example.com
+      status: subscribed
+      merge_fields:
+        FNAME: Jane
+        LNAME: Doe
+    expected_result: 'Returns the new member record with id (subscriber_hash) and status'
+  - name: 'Add pending subscriber with tags'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      email_address: pending@example.com
+      status: pending
+      tags:
+        - newsletter
+        - vip
+    expected_result: 'Returns member record with pending status awaiting confirmation'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-create-campaign/definition.yaml

@@ -0,0 +1,125 @@
+name: mailchimp-create-campaign
+version: '1.0.0'
+description: >
+  Create a new Mailchimp email campaign. Supports regular, plaintext, RSS,
+  and A/B test variate campaign types. After creating, configure the campaign
+  content and use mailchimp-send-campaign to send it.
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  type:
+    type: string
+    required: true
+    description: >
+      Campaign type: "regular" (standard email), "plaintext" (text-only email),
+      "rss" (RSS-driven campaign), or "variate" (A/B test campaign)
+    enum:
+      - regular
+      - plaintext
+      - rss
+      - variate
+  list_id:
+    type: string
+    required: false
+    description: >
+      The unique ID of the Mailchimp audience/list to send this campaign to.
+      Required when type is "regular" or "plaintext".
+  subject_line:
+    type: string
+    required: false
+    description: The subject line for the campaign email
+  preview_text:
+    type: string
+    required: false
+    description: Preview text displayed after the subject line in email clients (max 150 chars)
+  title:
+    type: string
+    required: false
+    description: Internal title for the campaign (used to identify it in Mailchimp dashboard)
+  from_name:
+    type: string
+    required: false
+    description: The "From" name subscribers will see in their inbox
+  reply_to:
+    type: string
+    required: false
+    description: The reply-to email address for the campaign
+
+execution:
+  type: http
+  method: POST
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/campaigns'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  body:
+    type: '{type}'
+    recipients:
+      list_id: '{list_id}'
+    settings:
+      subject_line: '{subject_line}'
+      preview_text: '{preview_text}'
+      title: '{title}'
+      from_name: '{from_name}'
+      reply_to: '{reply_to}'
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    data:
+      type: object
+      properties:
+        id:
+          type: string
+          description: Unique campaign ID (use this with mailchimp-send-campaign)
+        type:
+          type: string
+        status:
+          type: string
+          description: Campaign status (save, paused, schedule, sending, sent)
+        settings:
+          type: object
+        recipients:
+          type: object
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Create a regular campaign'
+    params:
+      server_prefix: us6
+      type: regular
+      list_id: abc123def4
+      subject_line: 'Welcome to our newsletter!'
+      preview_text: 'Check out what we have for you this month'
+      title: 'Monthly Newsletter - March 2026'
+      from_name: 'Acme Marketing'
+      reply_to: marketing@acme.com
+    expected_result: 'Returns campaign record with id for use in mailchimp-send-campaign'
+  - name: 'Create a plaintext campaign'
+    params:
+      server_prefix: us6
+      type: plaintext
+      list_id: abc123def4
+      subject_line: 'Quick update from us'
+      from_name: 'Acme Team'
+      reply_to: hello@acme.com
+    expected_result: 'Returns plaintext campaign record ready to add content and send'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-get-list-members/definition.yaml

@@ -0,0 +1,101 @@
+name: mailchimp-get-list-members
+version: '1.0.0'
+description: >
+  Get all members (subscribers) from a Mailchimp audience/list with optional
+  filtering by subscription status and pagination support.
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  list_id:
+    type: string
+    required: true
+    description: The unique ID of the Mailchimp audience/list to get members from
+  status:
+    type: string
+    required: false
+    description: >
+      Filter members by subscription status. Options: "subscribed", "unsubscribed",
+      "pending", "cleaned", "transactional", "archived". Omit to get all members.
+    enum:
+      - subscribed
+      - unsubscribed
+      - pending
+      - cleaned
+      - transactional
+      - archived
+  count:
+    type: number
+    required: false
+    description: Number of members to return per page (default 10, max 1000)
+    default: 10
+    min: 1
+    max: 1000
+  offset:
+    type: number
+    required: false
+    description: Number of records to skip for pagination (default 0)
+    default: 0
+    min: 0
+
+execution:
+  type: http
+  method: GET
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/lists/{list_id}/members'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  query_params:
+    status: '{status}'
+    count: '{count}'
+    offset: '{offset}'
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    data:
+      type: object
+      properties:
+        members:
+          type: array
+          description: Array of member objects with email, status, and merge fields
+        list_id:
+          type: string
+        total_items:
+          type: number
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get all subscribed members'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      status: subscribed
+      count: 100
+      offset: 0
+    expected_result: 'Returns array of subscribed members with total_items count'
+  - name: 'Get first page of all members'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      count: 10
+      offset: 0
+    expected_result: 'Returns first 10 members across all statuses'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-get-lists/definition.yaml

@@ -0,0 +1,81 @@
+name: mailchimp-get-lists
+version: '1.0.0'
+description: >
+  Get all Mailchimp audiences (lists) for the authenticated account.
+  Returns a paginated list of all audiences with subscriber counts and settings.
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  count:
+    type: number
+    required: false
+    description: Number of audiences to return (default 10, max 1000)
+    default: 10
+    min: 1
+    max: 1000
+  offset:
+    type: number
+    required: false
+    description: Number of records to skip for pagination (default 0)
+    default: 0
+    min: 0
+
+execution:
+  type: http
+  method: GET
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/lists'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  query_params:
+    count: '{count}'
+    offset: '{offset}'
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    data:
+      type: object
+      properties:
+        lists:
+          type: array
+          description: Array of audience objects
+        total_items:
+          type: number
+          description: Total number of audiences in the account
+        _links:
+          type: array
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Get first 10 audiences'
+    params:
+      server_prefix: us6
+      count: 10
+      offset: 0
+    expected_result: 'Returns a list of audiences with total_items count'
+  - name: 'Get next page of audiences'
+    params:
+      server_prefix: us6
+      count: 10
+      offset: 10
+    expected_result: 'Returns the second page of audiences'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-remove-list-member/definition.yaml

@@ -0,0 +1,64 @@
+name: mailchimp-remove-list-member
+version: '1.0.0'
+description: >
+  Archive (unsubscribe and remove) a subscriber from a Mailchimp audience/list.
+  This action archives the contact so they no longer appear as an active member.
+  Use the MD5 hash of the lowercase email address as the subscriber_hash.
+  ⚠️ This action requires approval — it cannot be undone from this tool.
+
+requires_approval: true
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  list_id:
+    type: string
+    required: true
+    description: The unique ID of the Mailchimp audience/list the member belongs to
+  subscriber_hash:
+    type: string
+    required: true
+    description: >
+      The MD5 hash of the subscriber's lowercase email address. You can generate this
+      using MD5("email@example.com"). Use the id field from list member responses.
+
+execution:
+  type: http
+  method: DELETE
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/lists/{list_id}/members/{subscriber_hash}'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    statusCode:
+      type: number
+
+error_handling:
+  retry: 1
+  backoff_type: linear
+  initial_delay_ms: 1000
+
+examples:
+  - name: 'Remove a subscriber'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      subscriber_hash: b775e3e869bc8eae5fcb23cdc5ec64ff
+    expected_result: 'Returns 204 No Content on success (success: true, statusCode: 204)'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-send-campaign/definition.yaml

@@ -0,0 +1,59 @@
+name: mailchimp-send-campaign
+version: '1.0.0'
+description: >
+  Send a Mailchimp campaign. This triggers the campaign to be delivered
+  to all recipients in the audience. The campaign must have content set
+  and all required settings configured before sending.
+  ⚠️ This action requires approval as it triggers mass email delivery.
+
+requires_approval: true
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  campaign_id:
+    type: string
+    required: true
+    description: >
+      The unique ID of the campaign to send. Obtained from mailchimp-create-campaign
+      response or from the Mailchimp dashboard.
+
+execution:
+  type: http
+  method: POST
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/campaigns/{campaign_id}/actions/send'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    statusCode:
+      type: number
+
+error_handling:
+  retry: 1
+  backoff_type: linear
+  initial_delay_ms: 2000
+
+examples:
+  - name: 'Send a prepared campaign'
+    params:
+      server_prefix: us6
+      campaign_id: a1b2c3d4e5
+    expected_result: 'Returns 204 No Content on success (success: true, statusCode: 204)'

matimo_mailchimp-0.1.0/src/matimo_mailchimp/tools/mailchimp-update-list-member/definition.yaml

@@ -0,0 +1,105 @@
+name: mailchimp-update-list-member
+version: '1.0.0'
+description: >
+  Update an existing subscriber's information in a Mailchimp audience/list.
+  Use the subscriber_hash (MD5 hash of the lowercase email address) to identify the member.
+  Supports updating status, email address, and merge fields.
+
+parameters:
+  server_prefix:
+    type: string
+    required: true
+    description: >
+      Your Mailchimp data center prefix (e.g. "us6"). Found at the end of your API key:
+      "abc123-us6" → server_prefix is "us6".
+  list_id:
+    type: string
+    required: true
+    description: The unique ID of the Mailchimp audience/list the member belongs to
+  subscriber_hash:
+    type: string
+    required: true
+    description: >
+      The MD5 hash of the subscriber's lowercase email address. You can generate this
+      using MD5("email@example.com"). Use the id field from mailchimp-add-list-member response.
+  status:
+    type: string
+    required: false
+    description: >
+      Update subscription status. Options: "subscribed", "unsubscribed", "pending", "cleaned"
+    enum:
+      - subscribed
+      - unsubscribed
+      - pending
+      - cleaned
+  email_address:
+    type: string
+    required: false
+    description: New email address for the subscriber (updates the email)
+  merge_fields:
+    type: object
+    required: false
+    description: >
+      Key-value pairs for merge fields to update. Example: {"FNAME": "Jane", "LNAME": "Smith"}
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://{server_prefix}.api.mailchimp.com/3.0/lists/{list_id}/members/{subscriber_hash}'
+  headers:
+    Authorization: 'apikey {MAILCHIMP_API_KEY}'
+    Content-Type: application/json
+  body:
+    status: '{status}'
+    email_address: '{email_address}'
+    merge_fields: '{merge_fields}'
+  timeout: 30000
+
+authentication:
+  type: api_key
+  location: header
+  name: Authorization
+  notes:
+    env: MAILCHIMP_API_KEY
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+    data:
+      type: object
+      properties:
+        id:
+          type: string
+        email_address:
+          type: string
+        status:
+          type: string
+        merge_fields:
+          type: object
+        list_id:
+          type: string
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: 'Unsubscribe a member'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      subscriber_hash: b775e3e869bc8eae5fcb23cdc5ec64ff
+      status: unsubscribed
+    expected_result: 'Returns updated member record with unsubscribed status'
+  - name: 'Update subscriber name'
+    params:
+      server_prefix: us6
+      list_id: abc123def4
+      subscriber_hash: b775e3e869bc8eae5fcb23cdc5ec64ff
+      merge_fields:
+        FNAME: Jane
+        LNAME: Smith
+    expected_result: 'Returns updated member record with new merge fields'