Jake Shore 04f254c40b constant-contact: Complete production MCP server rebuild

- Deleted single-file stub, rebuilt from scratch
- API client with OAuth2, pagination, rate limiting, error handling
- 50+ tools across 9 domains:
  * 12 contact tools (list, get, create, update, delete, search, tags, import/export, activity)
  * 11 campaign tools (list, get, create, update, delete, schedule, send, stats, activities, clone, test)
  * 9 list tools (list, get, create, update, delete, add/remove contacts, membership, stats)
  * 6 segment tools (list, get, create, update, delete, get contacts)
  * 2 template tools (list, get)
  * 11 reporting tools (campaign stats, contact stats, bounces, clicks, opens, forwards, optouts, sends, links)
  * 7 landing page tools (list, get, create, update, delete, publish, stats)
  * 6 social tools (list, get, create, update, delete, publish)
  * 6 tag tools (list, get, create, update, delete, usage)
- 17 React apps (dark theme, standalone Vite, client-side state):
  * contact-dashboard, contact-detail, contact-grid
  * campaign-dashboard, campaign-detail, campaign-builder
  * list-manager, segment-builder, template-gallery
  * report-dashboard, report-detail, bounce-report, engagement-chart
  * landing-page-grid, social-manager, tag-manager, import-wizard
- Full TypeScript types for Constant Contact API v3
- Production-ready: server.ts, main.ts (stdio), comprehensive README
- .env.example, .gitignore, package.json with MCP SDK 1.0.4

2026-02-12 17:22:25 -05:00

6.5 KiB

Raw Blame History

Constant Contact MCP Server

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

Features

🎯 Contact Management (12 tools)

List, get, create, update, delete contacts
Search contacts by various criteria
Manage contact tags (list, add, remove)
Import/export contacts in bulk
Track contact activity and engagement

📧 Campaign Management (11 tools)

Create, update, delete email campaigns
Schedule and send campaigns
Test send campaigns
Clone existing campaigns
Get campaign statistics and performance metrics
List campaign activities

📋 List Management (9 tools)

Create and manage contact lists
Add/remove contacts from lists
Get list membership and statistics
Update list properties

🎯 Segmentation (6 tools)

Create dynamic contact segments
Update segment criteria
Get segment contacts
Delete segments

🎨 Templates (2 tools)

List email templates
Get template details

📊 Reporting & Analytics (11 tools)

Campaign statistics (opens, clicks, bounces)
Contact-level activity stats
Bounce, click, and open reports
Forward and optout tracking
Campaign link analysis

🌐 Landing Pages (7 tools)

Create, update, delete landing pages
Publish landing pages
Get landing page statistics

Create and schedule social posts
Manage posts across multiple platforms
Publish posts immediately

🏷️ Tags (6 tools)

Create and manage contact tags
Get tag usage statistics
Delete tags

Total: 50+ MCP tools

Installation

npm install
npm run build

Configuration

Create a .env file:

CONSTANT_CONTACT_ACCESS_TOKEN=your_access_token_here

Getting an Access Token

Go to Constant Contact Developer Portal
Create an application
Generate OAuth2 access token
Add token to .env file

Usage

As MCP Server (stdio)

npm start

In Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "constant-contact": {
      "command": "node",
      "args": [
        "/path/to/constant-contact/dist/main.js"
      ],
      "env": {
        "CONSTANT_CONTACT_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Example MCP Tool Calls

List contacts:

{
  "tool": "contacts_list",
  "arguments": {
    "limit": 50,
    "status": "active"
  }
}

Create campaign:

{
  "tool": "campaigns_create",
  "arguments": {
    "name": "Summer Newsletter",
    "subject": "Check out our summer deals!",
    "from_name": "Marketing Team",
    "from_email": "marketing@example.com",
    "reply_to_email": "support@example.com",
    "html_content": "<html><body><h1>Summer Deals</h1></body></html>"
  }
}

Get campaign stats:

{
  "tool": "campaigns_get_stats",
  "arguments": {
    "campaign_activity_id": "campaign_123"
  }
}

React Apps

The server includes 17 pre-built React applications for managing Constant Contact data:

Contact Management

contact-dashboard (port 3000) - Overview of all contacts
contact-detail (port 3002) - Individual contact details
contact-grid (port 3003) - Grid view of contacts

Campaign Management

campaign-dashboard (port 3001) - Campaign overview
campaign-detail (port 3004) - Individual campaign details
campaign-builder (port 3005) - Campaign creation wizard

List & Segment Management

list-manager (port 3006) - Manage contact lists
segment-builder (port 3007) - Create and manage segments

Templates & Content

template-gallery (port 3008) - Browse email templates

Reporting & Analytics

report-dashboard (port 3009) - Overall analytics dashboard
report-detail (port 3010) - Detailed report view
bounce-report (port 3015) - Bounce analysis
engagement-chart (port 3016) - Engagement visualization

Other Tools

landing-page-grid (port 3011) - Manage landing pages
social-manager (port 3012) - Social media post management
tag-manager (port 3013) - Contact tag management
import-wizard (port 3014) - Contact import tool

Running React Apps

Each app is standalone with Vite:

cd src/ui/react-app/contact-dashboard
npm install
npm run dev

All apps use dark theme and client-side state management.

API Reference

Constant Contact API v3

Base URL: https://api.cc.email/v3
Authentication: OAuth2 Bearer token
Rate Limits: 10,000 requests per day (automatically handled)
Documentation: Constant Contact API Docs

Architecture

constant-contact/
├── src/
│   ├── clients/
│   │   └── constant-contact.ts    # API client with rate limiting
│   ├── tools/
│   │   ├── contacts-tools.ts      # 12 contact tools
│   │   ├── campaigns-tools.ts     # 11 campaign tools
│   │   ├── lists-tools.ts         # 9 list tools
│   │   ├── segments-tools.ts      # 6 segment tools
│   │   ├── templates-tools.ts     # 2 template tools
│   │   ├── reporting-tools.ts     # 11 reporting tools
│   │   ├── landing-pages-tools.ts # 7 landing page tools
│   │   ├── social-tools.ts        # 6 social tools
│   │   └── tags-tools.ts          # 6 tag tools
│   ├── types/
│   │   └── index.ts               # TypeScript definitions
│   ├── ui/
│   │   └── react-app/             # 17 React applications
│   ├── server.ts                  # MCP server setup
│   └── main.ts                    # Entry point
├── package.json
├── tsconfig.json
└── README.md

Features

✅ Automatic pagination - Handles paginated responses automatically
✅ Rate limiting - Respects API rate limits with automatic retry
✅ Error handling - Comprehensive error messages
✅ Type safety - Full TypeScript support
✅ Production ready - Tested with Constant Contact API v3

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Support

For issues or questions:

Constant Contact API: https://v3.developer.constantcontact.com/
MCP Protocol: https://modelcontextprotocol.io/

Part of MCP Engine - https://github.com/BusyBee3333/mcpengine

6.5 KiB Raw Blame History

Constant Contact MCP Server

Features

🎯 Contact Management (12 tools)

📧 Campaign Management (11 tools)

📋 List Management (9 tools)

🎯 Segmentation (6 tools)

🎨 Templates (2 tools)

📊 Reporting & Analytics (11 tools)

🌐 Landing Pages (7 tools)

📱 Social Media (6 tools)

🏷️ Tags (6 tools)

Installation

Configuration

Getting an Access Token

Usage

As MCP Server (stdio)

In Claude Desktop

Example MCP Tool Calls

React Apps

Contact Management

Campaign Management

List & Segment Management

Templates & Content

Reporting & Analytics

Other Tools

Running React Apps

API Reference

Constant Contact API v3

Architecture

Features

Development

License

Support

6.5 KiB

Raw Blame History