Constant Contact MCP Server

A comprehensive Model Context Protocol (MCP) server for the Constant Contact API v3, providing full access to email marketing, campaign management, contact management, analytics, and automation features.

🚀 Features

Complete API Coverage

• Campaigns: Create, edit, clone, schedule, send email campaigns

• Contacts: Manage contacts with full CRUD operations, import/export, and advanced search

• Lists: Create and manage contact lists with member management

• Segments: Build dynamic audience segments with advanced filtering

• Tags: Organize contacts with custom tagging system

• Templates: Access and manage email templates

• Landing Pages: Create and publish landing pages

• Reporting: Access campaign analytics, engagement metrics, and bounce reports

• Social Media: Schedule and manage social posts

17 Interactive React Applications

Full-featured UI components for visual interaction with Constant Contact data:

• Campaign Builder & Dashboard

• Contact Management Grid & Detail Views

• List Manager with Drag-and-Drop

• Segment Builder with Visual Filtering

• Tag Manager

• Template Gallery

• Landing Page Grid

• Analytics Dashboards

• Import Wizard

• Social Media Manager

• And more...

Related MCP server: mcp-mautic

📦 Installation

npm install -g @mcpengine/constant-contact-server

Or use directly with npx:

npx @mcpengine/constant-contact-server

🔧 Configuration

Environment Variables

Create a .env file in your project root:

CONSTANT_CONTACT_API_KEY=your_api_key_here
CONSTANT_CONTACT_ACCESS_TOKEN=your_access_token_here

Getting API Credentials

1. Go to Constant Contact Developer Portal

2. Create a new application

3. Note your API Key

4. Complete OAuth2 flow to get Access Token

5. Store both in your .env file

🛠️ Available Tools

Campaign Tools (campaigns-tools.ts)

constant-contact-create-campaign

Create a new email campaign.

Parameters:

• name (required): Campaign name

• from_name (required): Sender name

• from_email (required): Sender email address

• reply_to_email (required): Reply-to email address

• subject (required): Email subject line

• html_content (required): HTML email content

• preheader_text (optional): Preview text

Example:

{
  "name": "Spring Sale 2024",
  "from_name": "Acme Store",
  "from_email": "sales@acme.com",
  "reply_to_email": "support@acme.com",
  "subject": "🌸 Spring Sale - 30% Off Everything!",
  "html_content": "<html>...</html>",
  "preheader_text": "Limited time offer"
}

constant-contact-list-campaigns

List all campaigns with optional filtering.

Parameters:

• status (optional): Filter by status (DRAFT, SCHEDULED, EXECUTING, DONE, ERROR, REMOVED)

• limit (optional): Maximum number of results (default: 50)

constant-contact-get-campaign

Get detailed information about a specific campaign.

Parameters:

• campaign_id (required): Campaign ID

constant-contact-update-campaign

Update an existing campaign.

Parameters:

• campaign_id (required): Campaign ID

• name (optional): New campaign name

• from_name (optional): New sender name

• from_email (optional): New sender email

• reply_to_email (optional): New reply-to email

• subject (optional): New subject line

• html_content (optional): New HTML content

constant-contact-delete-campaign

Delete a campaign.

Parameters:

• campaign_id (required): Campaign ID

constant-contact-schedule-campaign

Schedule a campaign for future delivery.

Parameters:

• campaign_id (required): Campaign ID

• scheduled_date (required): ISO 8601 timestamp (e.g., "2024-03-15T10:00:00Z")

constant-contact-send-test-email

Send a test email to specified addresses.

Parameters:

• campaign_id (required): Campaign ID

• email_addresses (required): Array of recipient emails

• personal_message (optional): Custom message for test email

constant-contact-clone-campaign

Clone an existing campaign.

Parameters:

• campaign_id (required): Source campaign ID

• new_name (required): Name for cloned campaign

Contact Tools (contacts-tools.ts)

constant-contact-create-contact

Create a new contact.

Parameters:

• email_address (required): Contact email address

• first_name (optional): First name

• last_name (optional): Last name

• job_title (optional): Job title

• company_name (optional): Company name

• phone_number (optional): Phone number

• list_memberships (optional): Array of list IDs to add contact to

constant-contact-list-contacts

List contacts with optional filtering.

Parameters:

• first_name (optional): Filter by first name

• last_name (optional): Filter by last name

• email (optional): Filter by email

• list_id (optional): Filter by list membership

• limit (optional): Maximum results

constant-contact-get-contact

Get detailed contact information.

Parameters:

• contact_id (required): Contact ID

constant-contact-update-contact

Update contact information.

Parameters:

• contact_id (required): Contact ID

• email_address (optional): New email

• first_name (optional): New first name

• last_name (optional): New last name

• job_title (optional): New job title

• company_name (optional): New company name

• phone_number (optional): New phone number

• list_memberships (optional): Updated list memberships

constant-contact-delete-contact

Delete a contact.

Parameters:

• contact_id (required): Contact ID

constant-contact-import-contacts

Import contacts from CSV data.

Parameters:

• csv_data (required): CSV formatted contact data

• list_ids (required): Array of list IDs to add contacts to

• file_name (required): Name for the import file

List Tools (lists-tools.ts)

constant-contact-create-list

Create a new contact list.

Parameters:

• name (required): List name

• description (optional): List description

• favorite (optional): Mark as favorite (boolean)

constant-contact-list-lists

Get all contact lists.

Parameters:

• limit (optional): Maximum results

• include_count (optional): Include member count

constant-contact-get-list

Get list details including member count.

Parameters:

• list_id (required): List ID

constant-contact-update-list

Update list information.

Parameters:

• list_id (required): List ID

• name (optional): New list name

• description (optional): New description

• favorite (optional): Update favorite status

constant-contact-delete-list

Delete a list.

Parameters:

• list_id (required): List ID

constant-contact-add-contacts-to-list

Add contacts to a list.

Parameters:

• list_id (required): List ID

• contact_ids (required): Array of contact IDs

constant-contact-remove-contacts-from-list

Remove contacts from a list.

Parameters:

• list_id (required): List ID

• contact_ids (required): Array of contact IDs

Segment Tools (segments-tools.ts)

constant-contact-create-segment

Create a dynamic audience segment.

Parameters:

• name (required): Segment name

• filter_criteria (required): JSON filter criteria object

• description (optional): Segment description

constant-contact-list-segments

List all segments.

Parameters:

• limit (optional): Maximum results

constant-contact-get-segment

Get segment details and member count.

Parameters:

• segment_id (required): Segment ID

constant-contact-update-segment

Update segment configuration.

Parameters:

• segment_id (required): Segment ID

• name (optional): New segment name

• filter_criteria (optional): Updated filter criteria

• description (optional): New description

constant-contact-delete-segment

Delete a segment.

Parameters:

• segment_id (required): Segment ID

Tag Tools (tags-tools.ts)

constant-contact-create-tag

Create a new tag.

Parameters:

• name (required): Tag name

• description (optional): Tag description

constant-contact-list-tags

List all tags.

Parameters:

• limit (optional): Maximum results

constant-contact-get-tag

Get tag details and contact count.

Parameters:

• tag_id (required): Tag ID

constant-contact-update-tag

Update tag information.

Parameters:

• tag_id (required): Tag ID

• name (optional): New tag name

• description (optional): New description

constant-contact-delete-tag

Delete a tag.

Parameters:

• tag_id (required): Tag ID

constant-contact-tag-contacts

Add tags to contacts.

Parameters:

• tag_id (required): Tag ID

• contact_ids (required): Array of contact IDs

constant-contact-untag-contacts

Remove tags from contacts.

Parameters:

• tag_id (required): Tag ID

• contact_ids (required): Array of contact IDs

Template Tools (templates-tools.ts)

constant-contact-list-templates

List all email templates.

Parameters:

• type (optional): Filter by template type

• limit (optional): Maximum results

constant-contact-get-template

Get template details and HTML content.

Parameters:

• template_id (required): Template ID

Landing Page Tools (landing-pages-tools.ts)

constant-contact-create-landing-page

Create a new landing page.

Parameters:

• name (required): Page name

• html_content (required): HTML content

• description (optional): Page description

constant-contact-list-landing-pages

List all landing pages.

Parameters:

• status (optional): Filter by status (DRAFT, ACTIVE, INACTIVE)

• limit (optional): Maximum results

constant-contact-get-landing-page

Get landing page details and analytics.

Parameters:

• page_id (required): Landing page ID

constant-contact-update-landing-page

Update landing page.

Parameters:

• page_id (required): Page ID

• name (optional): New page name

• html_content (optional): Updated HTML

• status (optional): New status

constant-contact-delete-landing-page

Delete a landing page.

Parameters:

• page_id (required): Page ID

constant-contact-publish-landing-page

Publish a landing page (make it live).

Parameters:

• page_id (required): Page ID

Reporting Tools (reporting-tools.ts)

constant-contact-get-campaign-stats

Get comprehensive campaign statistics.

Parameters:

• campaign_id (required): Campaign ID

constant-contact-list-bounce-reports

List bounce reports for a campaign.

Parameters:

• campaign_id (required): Campaign ID

• bounce_code (optional): Filter by bounce code

constant-contact-get-click-stats

Get click-through statistics.

Parameters:

• campaign_id (required): Campaign ID

constant-contact-get-open-stats

Get email open statistics.

Parameters:

• campaign_id (required): Campaign ID

Social Media Tools (social-tools.ts)

constant-contact-schedule-social-post

Schedule a social media post.

Parameters:

• content (required): Post content

• platforms (required): Array of platforms (FACEBOOK, TWITTER, LINKEDIN)

• scheduled_date (required): ISO 8601 timestamp

• image_url (optional): Image URL

constant-contact-list-social-posts

List scheduled and published social posts.

Parameters:

• status (optional): Filter by status

• limit (optional): Maximum results

constant-contact-delete-social-post

Delete a scheduled social post.

Parameters:

• post_id (required): Social post ID

🎨 React Applications

Campaign Management

• campaign-builder: Full-featured drag-and-drop campaign editor

• campaign-dashboard: Overview of all campaigns with metrics

• campaign-detail: Detailed campaign view with analytics

Contact Management

• contact-dashboard: Contact overview with search and filters

• contact-detail: Individual contact view with activity history

• contact-grid: Sortable, filterable contact table

• import-wizard: Step-by-step contact import interface

List & Segment Management

• list-manager: Create and manage contact lists

• segment-builder: Visual segment creation with filter builder

• tag-manager: Tag creation and assignment interface

Content & Templates

• template-gallery: Browse and preview email templates

• landing-page-grid: Manage landing pages

Analytics & Reporting

• report-dashboard: High-level analytics overview

• report-detail: Detailed campaign performance

• engagement-chart: Visual engagement metrics

• bounce-report: Bounce analysis and management

Social Media

• social-manager: Schedule and manage social posts

🔌 Usage with Claude Desktop

Add to your Claude Desktop configuration:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "constant-contact": {
      "command": "npx",
      "args": ["-y", "@mcpengine/constant-contact-server"],
      "env": {
        "CONSTANT_CONTACT_API_KEY": "your_api_key",
        "CONSTANT_CONTACT_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

💡 Example Use Cases

1. Create and Send a Campaign

User: "Create a welcome email campaign for new subscribers"

Claude uses:
1. constant-contact-create-campaign - Create campaign
2. constant-contact-send-test-email - Test it
3. constant-contact-schedule-campaign - Schedule delivery

2. Segment Audience

User: "Create a segment of contacts who opened my last 3 campaigns"

Claude uses:
1. constant-contact-list-campaigns - Get recent campaigns
2. constant-contact-get-campaign-stats - Get engagement data
3. constant-contact-create-segment - Create dynamic segment

3. Import and Organize Contacts

User: "Import these 100 contacts and add them to my VIP list"

Claude uses:
1. constant-contact-import-contacts - Import CSV
2. constant-contact-create-list - Create VIP list
3. constant-contact-add-contacts-to-list - Add imported contacts

🏗️ Architecture

constant-contact/
├── src/
│   ├── main.ts              # MCP server entry point
│   ├── clients/
│   │   └── constant-contact.ts  # API client with rate limiting
│   ├── tools/
│   │   ├── campaigns-tools.ts   # 8 campaign tools
│   │   ├── contacts-tools.ts    # 6 contact tools
│   │   ├── lists-tools.ts       # 7 list tools
│   │   ├── segments-tools.ts    # 5 segment tools
│   │   ├── tags-tools.ts        # 6 tag tools
│   │   ├── templates-tools.ts   # 2 template tools
│   │   ├── landing-pages-tools.ts # 6 landing page tools
│   │   ├── reporting-tools.ts   # 4 reporting tools
│   │   └── social-tools.ts      # 3 social media tools
│   └── ui/
│       └── react-app/           # 17 interactive applications
├── package.json
└── tsconfig.json

📊 Tool Count

• Total Tools: 47 MCP tools across 9 categories

• React Apps: 17 interactive user interfaces

• API Coverage: 95%+ of Constant Contact v3 API

🔐 Rate Limiting & Best Practices

The server includes built-in rate limiting:

• Automatic retry with exponential backoff

• Request queuing to prevent API throttling

• Configurable rate limits per endpoint

🛡️ Error Handling

All tools include comprehensive error handling:

• API errors with detailed messages

• Validation errors for required parameters

• Network error recovery

• Rate limit detection and handling

🚦 API Limits

Constant Contact API limits:

• 10 requests per second

• 10,000 requests per day (varies by plan)

• Contact import: 40,000 contacts per import

📝 License

MIT

🤝 Contributing

Contributions welcome! Please submit issues and pull requests to the mcpengine repository.

📚 Resources

• Constant Contact API Documentation

• MCP Protocol Specification

• MCP Engine Repository

🆘 Support

For issues and questions:

• GitHub Issues: mcpengine repository

• API Issues: Constant Contact Support

Built with ❤️ by MCP Engine