Optimizely DXP

Optimizely DXP MCP Server

🎉 What's New in v3.46

Major improvements since September 2024:

• ⚡ 3-10x Faster Operations: PowerShell fully removed, direct REST API with HMAC-SHA256 authentication
• 🔷 TypeScript Migration: Complete codebase conversion with strict mode compliance (479 errors fixed)
• 📊 Streaming Log Analysis: New analyze_logs_streaming tool - 2x faster than download+analyze
• 🔄 45 Tools: Expanded from 38 tools with unified naming and complete automation support
• 🤖 24 Tools with structuredContent: Perfect for automation platforms (n8n, Zapier, Make.com)
• 🔴 Redis Integration: Optional caching with circuit breaker and reconnection logic
• 📡 MCP Resources: Real-time deployment monitoring via event subscription
• 🔀 Dual Transport Modes: stdio for Claude Desktop, HTTP for automation platforms (n8n, Zapier, Docker)
• 🎯 Zero Dependencies: No PowerShell, no Python, no external tools - just npm install

🤔 The Problem

You invested in enterprise DXP, but you're only using 10% of its power.

You chose Optimizely to deliver exceptional digital experiences, but:

• Your team spends more time on DevOps tasks than building features
• Critical issues hide in logs until customers complain
• Deployments are scary, manual, multi-step processes
• Setting up dev environments takes hours or days
• You can't move fast enough to beat competitors embracing AI

Meanwhile, AI is revolutionizing how software gets built and managed. Companies using AI-powered automation are shipping 10x faster, finding issues before customers do, and freeing their teams to focus on innovation.

✨ The Solution

Your infinite DevOps workforce - AI that never sleeps, never breaks, always delivers.

This MCP server transforms your Optimizely DXP into an AI-powered platform that goes far beyond replacing Google searches. Just as Optimizely Opal provides an infinite workforce for marketing, this MCP creates your infinite workforce for DXP operations:

• AI Specialists that understand your infrastructure, deployments, and data
• Intelligent Agents that handle complex multi-step workflows autonomously
• 24/7 Operations that scale infinitely without adding headcount
• Your team elevated from operators to innovators

Finally get the ROI your DXP investment promised - ship faster, break less, sleep better.

🚀 The Transformation

From DXP operator to digital experience innovator:

• Ship 10x faster - What took hours now takes seconds
• Zero-downtime deployments - AI handles the complexity
• Proactive issue resolution - Fix problems before customers notice
• Instant dev environments - Full production replicas in minutes
• Competitive advantage - Move at AI speed while others click through portals
• Maximum DXP ROI - Finally use all those powerful features you're paying for

🔌 What is MCP?

Model Context Protocol (MCP) is the bridge between AI's intelligence and your DXP's capabilities.

While others use AI just to search documentation or write code snippets, MCP enables something revolutionary: AI that takes action. This isn't about better search results - it's about AI that can:

• Execute complex operations autonomously
• Orchestrate multi-step workflows across environments
• Monitor systems and self-heal issues
• Learn from your infrastructure to make smarter decisions
• Scale infinitely without human bottlenecks

Think of it as evolving from "AI as advisor" to "AI as workforce" - the difference between asking for directions and having a chauffeur.

🌟 Key Features & Capabilities

Zero Dependencies Architecture

Direct REST API - No External Tools Required

• HMAC-SHA256 authentication: Secure, standards-based API access
• No PowerShell: Completely removed in v3.44 - never needed again
• No Python: All JavaScript/TypeScript with Node.js runtime
• Cross-platform: Identical behavior on macOS, Linux, and Windows
• Dual transport modes: stdio for Claude Desktop, HTTP for automation platforms
• Single install: Just npm install - that's it!

Performance Improvements:

• Deployment operations: 3-10x faster vs PowerShell
• Database exports: 5x faster
• Log downloads: 3x faster

AI-Powered Operations (45 Tools)

Comprehensive DXP Management:

1. Deployment Management

• Autonomous deployment with health monitoring
• Rollback and reset capabilities
• Content sync between environments
• Real-time progress tracking with ETAs
• MCP Resources subscription for live events

2. Log Analysis & Intelligence

• Streaming analysis (2x faster than download+analyze)
• Compare logs tool for deployment decisions
• AI agent detection and pattern recognition
• Performance metrics and error analysis
• Structured output for automation workflows

3. Database Operations

• Interactive export workflow with smart monitoring
• Automated backup downloads
• Export status tracking
• Background downloads with progress updates

4. Storage Management

• Incremental blob downloads (only changed files)
• Manifest tracking for efficiency
• Pattern-based filtering (*.pdf, *.jpg, etc.)
• 5x faster with parallel downloads

5. Real-Time Monitoring

• MCP Resources subscription for deployment events
• Webhook notifications for external automation
• Health checks and connection testing
• Environment access verification

Enterprise-Ready Architecture

Built for Scale and Reliability:

• Redis Integration (Optional)

  • Circuit breaker pattern for automatic fallback
  • Reconnection logic with exponential backoff
  • Caching layer for repeated queries
  • 12 integration tests covering all scenarios

• Rate Limiting & Retry

  • Automatic retry with exponential backoff
  • HTTP 429 (rate limit) handling
  • Respects Retry-After headers

• Event System

  • MCP Resources for real-time updates
  • Webhook-ready for external integration
  • Event streaming without polling

• Type Safety

  • Full TypeScript with strict mode
  • 479 type errors fixed across codebase
  • Better IDE support and auto-completion

Automation Platform Support

Native Integration with Workflow Tools:

• HTTP Transport Mode: Dual-mode operation (stdio for Claude, HTTP for automation)
• 24 Tools with structuredContent: Native MCP field for structured data
• Direct Property Access: No JSON.parse() needed - response.structuredContent.data.deploymentId
• Platform Support: n8n, Zapier, Make.com, custom workflows
• Webhook-Ready: Event system for external automation

See N8N_INTEGRATION.md for automation platform setup.

🔀 Transport Modes

The MCP server supports two transport modes for different deployment scenarios:

stdio Mode (Default)

Best for: Claude Desktop, local AI clients, single-user development

Characteristics:

• Process-to-process communication via stdin/stdout
• No network ports required
• Automatically started by Claude Desktop
• Lowest latency and most secure (no network exposure)
• Ideal for local development and desktop AI applications

Setup:

{
  "mcpServers": {
    "optimizely-dxp": {
      "command": "npx",
      "args": ["-y", "@jaxon-digital/optimizely-dxp-mcp"],
      "env": {
        "OPTIMIZELY_PROJECT_ID": "your-id",
        "OPTIMIZELY_PROJECT_KEY": "your-key",
        "OPTIMIZELY_PROJECT_SECRET": "your-secret"
      }
    }
  }
}

No additional configuration needed - stdio is the default mode.

---

HTTP Mode

Best for: n8n, Zapier, Make.com, Docker, remote access, multi-tenant platforms

Characteristics:

• RESTful HTTP server with JSON-RPC 2.0
• MCP endpoint: POST /mcp
• Health check: GET /health
• Supports concurrent remote connections
• Production-ready with graceful shutdown

Setup:

# Start HTTP server
DXP_MCP_MODE=http DXP_MCP_PORT=3001 npm start

# Or with Docker
docker run -p 3001:3001 \
  -e DXP_MCP_MODE=http \
  -e OPTIMIZELY_PROJECT_ID=your-id \
  -e OPTIMIZELY_PROJECT_KEY=your-key \
  -e OPTIMIZELY_PROJECT_SECRET=your-secret \
  jaxon-digital/optimizely-dxp-mcp

Configuration:

Variable	Default	Description
DXP_MCP_MODE	stdio	Set to http to enable HTTP mode
DXP_MCP_PORT	3001	HTTP server port (1-65535)
DXP_MCP_HOST	0.0.0.0	Bind address (localhost for local only, 0.0.0.0 for Docker/remote)

Health Check:

curl http://localhost:3001/health
# Returns: {"status":"ok","service":"optimizely-dxp-mcp","version":"3.46.0"}

---

Decision Guide

Scenario	Mode	Why
Claude Desktop usage	stdio	Default, fastest, most secure
n8n workflow automation	http	REST API, remote access
Zapier/Make.com integration	http	Webhook support, structured data
Docker deployment	http	Network connectivity, multiple clients
Local development (single user)	stdio	Simplest setup, no ports needed
Multi-tenant SaaS platform	http	Concurrent connections, load balancing
Remote server deployment	http	Network accessibility required

All 45 tools work identically in both modes - only the transport layer changes.

📋 Complete Tool Reference (45 Tools)

Permission & Access Management (4 tools)

• test_connection - Validate setup and show capabilities
• check_permissions - Detailed environment access brea

---

README truncated. View full README on GitHub.