121 lines
3.2 KiB
Markdown
121 lines
3.2 KiB
Markdown
# 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
|
|
|
|
1. **Contact Manager** - Manage and organize contacts
|
|
2. **Deal Pipeline** - Visual pipeline management
|
|
3. **List Builder** - Create and manage contact lists
|
|
4. **Campaign Dashboard** - Track email campaign performance
|
|
5. **Automation Builder** - Create and manage automations
|
|
6. **Form Manager** - Manage signup and lead capture forms
|
|
7. **Tag Organizer** - Organize and manage contact tags
|
|
8. **Task Center** - Manage deal and contact tasks
|
|
9. **Notes Viewer** - View and manage notes
|
|
10. **Pipeline Settings** - Configure deal pipelines and stages
|
|
11. **Account Directory** - Manage company accounts
|
|
12. **Webhook Manager** - Configure and monitor webhooks
|
|
13. **Email Analytics** - Track email performance metrics
|
|
14. **Segment Viewer** - View and analyze contact segments
|
|
15. **Site Tracking** - Monitor contact website activity
|
|
16. **Score Dashboard** - View lead and contact scoring
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Set the following environment variables:
|
|
|
|
```bash
|
|
export ACTIVECAMPAIGN_ACCOUNT="your-account-name"
|
|
export ACTIVECAMPAIGN_API_KEY="your-api-key"
|
|
```
|
|
|
|
## Usage
|
|
|
|
### As MCP Server
|
|
|
|
Add to your MCP client configuration:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"activecampaign": {
|
|
"command": "node",
|
|
"args": ["/path/to/dist/index.js"],
|
|
"env": {
|
|
"ACTIVECAMPAIGN_ACCOUNT": "your-account",
|
|
"ACTIVECAMPAIGN_API_KEY": "your-key"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Running the Server
|
|
|
|
```bash
|
|
npm run build
|
|
npm start
|
|
```
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# 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 contacts
|
|
- `ac_get_contact` - Get contact by ID
|
|
- `ac_create_deal` - Create new deal
|
|
- `ac_update_pipeline` - Update pipeline settings
|
|
- ... and 56 more!
|
|
|
|
## License
|
|
|
|
MIT
|