Skip to main content

Adobe Target MCP Server

Create a powerful Model Context Protocol (MCP) server for Adobe Target in minutes with our AI Gateway. This guide walks you through setting up seamless personalization and testing integration with enterprise-grade security and instant OAuth authentication.

About Adobe Target API​

Adobe Target is the personalization engine that enables you to test, optimize, and deliver personalized experiences across web, mobile apps, and other digital channels. The API provides programmatic access to activities, audiences, offers, and reporting.

Key Capabilities​

  • A/B Testing: Simple split testing
  • Multivariate Testing: Test multiple variables
  • Experience Targeting: Audience-based experiences
  • Automated Personalization: AI-driven optimization
  • Auto-Target: Machine learning targeting
  • Recommendations: Product suggestions
  • Mobile App Optimization: In-app experiences
  • Server-Side Delivery: Headless personalization

API Features​

  • Admin APIs: Activity and offer management
  • Delivery API: Experience delivery
  • Reporting API: Performance analytics
  • OAuth 2.0: Secure authentication
  • Profile API: Visitor profiles
  • Batch API: Bulk operations
  • Recommendations API: Catalog management
  • Edge Network: Global delivery

What You Can Do with Adobe Target MCP Server​

The MCP server transforms Adobe Target API into a natural language interface, enabling AI agents to:

A/B Testing​

  • Test Creation

    • "Create A/B test for homepage hero"
    • "Set up 50/50 traffic split"
    • "Test button color variations"
    • "Configure success metrics"

  • Test Management

    • "Start test immediately"
    • "Pause underperforming test"
    • "Extend test duration"
    • "Archive completed tests"

  • Test Analysis

    • "Show test results"
    • "Calculate statistical significance"
    • "Identify winning variation"
    • "Export test report"

Experience Targeting​

  • Audience Creation

    • "Create mobile visitor audience"
    • "Define high-value customer segment"
    • "Build geographic audience"
    • "Set behavior-based targeting"

  • Experience Design

    • "Create personalized banner"
    • "Design targeted offers"
    • "Build dynamic content"
    • "Configure experience rules"

  • Targeting Rules

    • "Target new vs returning visitors"
    • "Show experience by device"
    • "Display by time of day"
    • "Target by traffic source"

AI-Powered Optimization​

  • Auto-Target

    • "Enable machine learning optimization"
    • "Set conversion goal"
    • "Configure learning period"
    • "Monitor model performance"

  • Automated Personalization

    • "Create AP activity"
    • "Upload content variations"
    • "Define success metrics"
    • "Review ML insights"

  • Auto-Allocate

    • "Enable traffic auto-allocation"
    • "Set confidence threshold"
    • "Monitor winner emergence"
    • "Lock winning experience"

Recommendations​

  • Catalog Management

    • "Upload product catalog"
    • "Update item attributes"
    • "Set category mappings"
    • "Configure collections"

  • Algorithm Configuration

    • "Create 'People who viewed' algorithm"
    • "Set up cart-based recommendations"
    • "Configure popularity algorithm"
    • "Build custom algorithm"

  • Design Templates

    • "Create recommendation layout"
    • "Design carousel template"
    • "Build grid display"
    • "Configure responsive design"

Offer Management​

  • Offer Creation

    • "Create HTML offer"
    • "Build JSON offer"
    • "Design image offer"
    • "Configure redirect offer"

  • Offer Library

    • "Organize offers by campaign"
    • "Tag offers for search"
    • "Archive old offers"
    • "Duplicate successful offers"

  • Dynamic Offers

    • "Create profile-based offer"
    • "Build time-sensitive offer"
    • "Configure geo-targeted offer"
    • "Set device-specific offer"

Analytics & Reporting​

  • Performance Metrics

    • "Show conversion lift"
    • "Calculate confidence level"
    • "Track engagement rate"
    • "Measure revenue impact"

  • Visitor Analytics

    • "Analyze audience overlap"
    • "Track visitor segments"
    • "Monitor experience distribution"
    • "Review visitor flow"

  • Custom Reports

    • "Create executive dashboard"
    • "Build performance summary"
    • "Export detailed analytics"
    • "Schedule automated reports"

Audience Management​

  • Audience Building

    • "Import CRM segments"
    • "Create behavioral audience"
    • "Build lookalike audience"
    • "Define custom attributes"

  • Audience Combination

    • "Combine multiple audiences"
    • "Create exclusion rules"
    • "Build nested audiences"
    • "Set priority ordering"

  • Real-time Segments

    • "Create session-based audience"
    • "Build engagement segment"
    • "Define intent signals"
    • "Track micro-conversions"

Integration Management​

  • Analytics Integration

    • "Connect Adobe Analytics"
    • "Map success events"
    • "Configure data sharing"
    • "Enable A4T reporting"

  • Platform Connections

    • "Sync with Experience Cloud"
    • "Connect to CRM"
    • "Integrate with CDP"
    • "Link to tag manager"

  • API Webhooks

    • "Set activity notifications"
    • "Configure change alerts"
    • "Enable performance triggers"
    • "Create custom webhooks"

Prerequisites​

  • Access to Cequence AI Gateway
  • Adobe Target license
  • Adobe Developer Console access
  • Target admin permissions

Step 1: Create Adobe Target Integration​

1.1 Access Adobe Developer Console​

  1. Go to console.adobe.io
  2. Select your organization
  3. Create new project

1.2 Add Target API​

  1. Click Add API
  2. Select Adobe Target
  3. Choose authentication:
    • OAuth for UI operations
    • Service Account (JWT) for server-side

1.3 Configure OAuth​

  1. OAuth Configuration:

    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback
    • Select required scopes

  2. Service Account:

    • Generate key pair
    • Download private key

1.4 Get Credentials​

  1. Copy Client ID
  2. Copy Client Secret
  3. Note Technical Account ID
  4. Save Organization ID

Step 2-4: Standard Setup​

Follow standard steps to access AI Gateway, find Adobe Target API, and create MCP server.

Step 5: Configure API Endpoints​

  1. Base URL: https://mc.adobe.io/
  2. Select Target endpoints:
    • Activities endpoints
    • Audiences endpoints
    • Offers endpoints
    • Reports endpoints
  3. Click Next

Step 6: MCP Server Configuration​

  1. Name: "Adobe Target"
  2. Description: "Personalization and testing platform"
  3. Configure production mode
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: OAuth 2.0
  2. Authorization URL: 
    https://ims-na1.adobelogin.com/ims/authorize/v2
  3. Token URL: 
    https://ims-na1.adobelogin.com/ims/token/v3
  4. Enter Client ID and Secret
  5. Configure Target-specific settings

Available Adobe Target OAuth Scopes​

Core Target Scopes​

  • openid

    • Basic authentication
    • Required for OAuth

  • AdobeID

    • Adobe ID profile
    • User information

  • target_sdk

    • Target API access
    • Activity management
    • Reporting access

Additional Permissions​

  • Activity Permissions

    • Create/edit activities
    • Manage experiences
    • Configure targeting
    • View reports

  • Administrative Access

    • User management
    • Property configuration
    • Integration setup
    • Global settings

For Activity Management:

openid
AdobeID
target_sdk
read_organizations

For Full Access:

openid
AdobeID
target_sdk
read_organizations
additional_info

Step 8-10: Complete Setup​

Configure security, choose deployment, and deploy.

Using Your Adobe Target MCP Server​

With Claude Desktop​

{
  "servers": {
    "adobe-target": {
      "url": "your-mcp-server-url",
      "auth": {
        "type": "oauth2",
        "client_id": "your-client-id"
      }
    }
  }
}

Natural Language Commands​

  • "Create A/B test for checkout page"
  • "Show performance of hero banner test"
  • "Build audience for mobile app users"
  • "Enable AI optimization for homepage"
  • "Create product recommendations"

API Integration Example​

// Initialize MCP client
const mcpClient = new MCPClient({
  serverUrl: 'your-mcp-server-url',
  auth: {
    type: 'oauth2',
    token: 'access-token'
  }
});

// Create A/B test activity
const abTest = await mcpClient.adobeTarget.activities.create({
  name: 'Homepage Hero Test',
  type: 'ab',
  state: 'approved',
  priority: 0,
  locations: {
    mboxes: [
      {
        name: 'homepage-hero',
        audienceIds: []
      }
    ]
  },
  experiences: [
    {
      name: 'Control',
      offerLocations: [
        {
          locationLocalId: 0,
          offerId: 'offer-control'
        }
      ]
    },
    {
      name: 'Variant A',
      offerLocations: [
        {
          locationLocalId: 0,
          offerId: 'offer-variant-a'
        }
      ]
    }
  ],
  metrics: [
    {
      name: 'Conversion',
      metricLocalId: 0,
      ordinal: null,
      element: {
        type: 'mbox',
        value: 'orderConfirmPage'
      }
    }
  ]
});

// Create audience
const audience = await mcpClient.adobeTarget.audiences.create({
  name: 'High-Value Mobile Users',
  description: 'Mobile users with high engagement',
  targetRuleLogicalCondition: 'and',
  targetRules: [
    {
      attribute: 'device.mobile',
      operator: 'equals',
      value: 'true'
    },
    {
      attribute: 'user.categoryAffinity',
      operator: 'contains',
      value: 'premium'
    }
  ]
});

// Create offer
const offer = await mcpClient.adobeTarget.offers.create({
  name: 'Summer Sale Banner',
  type: 'html',
  workspace: '1234567',
  content: '<div class="summer-sale">50% Off Everything!</div>'
});

// Create recommendation activity
const recommendations = await mcpClient.adobeTarget.recommendations.create({
  name: 'Product Page Recommendations',
  algorithm: 'most-viewed',
  criteria: {
    name: 'Most Viewed Products',
    algorithmType: 'POPULARITY',
    lookbackWindow: 14,
    includedCategories: ['electronics', 'accessories']
  },
  design: {
    name: 'Carousel Layout',
    template: '<div class="rec-carousel">{{products}}</div>'
  },
  placement: {
    name: 'product-page-recs',
    location: 'below-product-details'
  }
});

// Create Auto-Target activity
const autoTarget = await mcpClient.adobeTarget.activities.create({
  name: 'Homepage Personalization',
  type: 'auto_target',
  state: 'approved',
  locations: {
    mboxes: [
      {
        name: 'homepage-hero',
        audienceIds: []
      }
    ]
  },
  experiences: [
    // Multiple content variations
    { name: 'Tech Focus', offerId: 'tech-offer' },
    { name: 'Fashion Focus', offerId: 'fashion-offer' },
    { name: 'Sports Focus', offerId: 'sports-offer' },
    { name: 'Generic', offerId: 'generic-offer' }
  ],
  trafficAllocation: {
    type: 'auto_target',
    trainingPercent: 20
  }
});

// Get activity performance
const performance = await mcpClient.adobeTarget.reports.getPerformance({
  activityId: abTest.id,
  reportType: 'ab_performance',
  metrics: ['conversion', 'revenue', 'engagement'],
  startDate: '2025-01-01',
  endDate: '2025-01-31'
});

// Update audience
await mcpClient.adobeTarget.audiences.update({
  id: audience.id,
  targetRules: [
    ...audience.targetRules,
    {
      attribute: 'user.purchaseHistory',
      operator: 'greaterThan',
      value: '1000'
    }
  ]
});

Common Use Cases​

Website Optimization​

  • Homepage personalization
  • Product page testing
  • Checkout optimization
  • Navigation improvements

Campaign Testing​

  • Landing page variants
  • Email campaign optimization
  • Ad creative testing
  • Messaging experiments

Personalization​

  • Content recommendations
  • Dynamic experiences
  • Behavioral targeting
  • Segment-based delivery

Mobile Optimization​

  • App experience testing
  • Feature flag management
  • In-app messaging
  • User flow optimization

Security Best Practices​

  1. OAuth Security:

    • Use minimal scopes
    • Rotate credentials
    • Monitor API usage
    • Implement IP filtering

  2. Data Protection:

    • Anonymize PII
    • Implement consent
    • Audit data access
    • Secure transmissions

  3. Access Control:

    • Role-based permissions
    • Activity approvals
    • Change tracking
    • User auditing

Troubleshooting​

Common Issues​

  1. Authentication Errors

    • Verify credentials
    • Check organization ID
    • Validate permissions
    • Review token expiry

  2. Activity Errors

    • Check mbox names
    • Verify offer IDs
    • Validate audiences
    • Review metrics

  3. Performance Issues

    • Monitor API limits
    • Optimize queries
    • Use caching
    • Batch operations

Getting Help​