# 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