3.2 KiB
3.2 KiB
ActiveCampaign MCP Server
Complete ActiveCampaign integration for Model Context Protocol with 60+ tools and 16 interactive apps.
Features
🛠️ 60+ Tools Across 12 Categories
- Contacts (8 tools): List, get, create, update, delete, search, tag management
- Deals (6 tools): Full pipeline management, stage transitions
- Lists (7 tools): List management and contact subscriptions
- Campaigns (5 tools): Email campaign management and analytics
- Automations (5 tools): Automation workflows and contact enrollment
- Forms (4 tools): Form creation and management
- Tags (5 tools): Tag organization and assignment
- Tasks (6 tools): Deal and contact task management
- Notes (5 tools): Notes for contacts and deals
- Pipelines (9 tools): Pipeline and stage configuration
- Accounts (5 tools): Company/account management
- Webhooks (5 tools): Webhook configuration and monitoring
📊 16 Interactive Apps
- Contact Manager - Manage and organize contacts
- Deal Pipeline - Visual pipeline management
- List Builder - Create and manage contact lists
- Campaign Dashboard - Track email campaign performance
- Automation Builder - Create and manage automations
- Form Manager - Manage signup and lead capture forms
- Tag Organizer - Organize and manage contact tags
- Task Center - Manage deal and contact tasks
- Notes Viewer - View and manage notes
- Pipeline Settings - Configure deal pipelines and stages
- Account Directory - Manage company accounts
- Webhook Manager - Configure and monitor webhooks
- Email Analytics - Track email performance metrics
- Segment Viewer - View and analyze contact segments
- Site Tracking - Monitor contact website activity
- Score Dashboard - View lead and contact scoring
Installation
npm install
Configuration
Set the following environment variables:
export ACTIVECAMPAIGN_ACCOUNT="your-account-name"
export ACTIVECAMPAIGN_API_KEY="your-api-key"
Usage
As MCP Server
Add to your MCP client configuration:
{
"mcpServers": {
"activecampaign": {
"command": "node",
"args": ["/path/to/dist/index.js"],
"env": {
"ACTIVECAMPAIGN_ACCOUNT": "your-account",
"ACTIVECAMPAIGN_API_KEY": "your-key"
}
}
}
}
Running the Server
npm run build
npm start
Development
# Type checking
npm run typecheck
# Build
npm run build
# Watch mode
npm run dev
API Rate Limiting
The server automatically handles ActiveCampaign's rate limit of 5 requests per second with built-in throttling.
Architecture
- Client: Centralized API client with rate limiting and pagination
- Types: Full TypeScript type definitions for all ActiveCampaign entities
- Tools: 12 tool modules organized by resource type
- Apps: 16 React-based UI apps with SSR for visualization
Tools Reference
All tools follow the ac_verb_noun naming convention:
ac_list_contacts- List all contactsac_get_contact- Get contact by IDac_create_deal- Create new dealac_update_pipeline- Update pipeline settings- ... and 56 more!
License
MIT