Skip to main content

Adobe Experience Platform MCP Server

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

About Adobe Experience Platform API​

Adobe Experience Platform is the most powerful customer experience management platform, helping organizations create and deliver personalized experiences across every channel. The API provides comprehensive access to:

  • Real-time Customer Profiles: Unified view of each customer across all touchpoints
  • Data Ingestion: Batch and streaming data import capabilities
  • Segmentation Engine: Create and manage audience segments
  • Journey Orchestration: Design and automate customer journeys
  • Identity Service: Resolve customer identities across devices
  • Data Governance: Privacy and compliance management
  • Query Service: SQL access to platform data
  • Machine Learning: AI/ML capabilities for predictions

Key Features​

  • REST APIs: Comprehensive API coverage
  • Real-time Processing: Stream data ingestion
  • Batch Operations: Large-scale data processing
  • GraphQL Support: Flexible data queries
  • Rate Limiting: Varies by service and tier
  • Data Lake: Centralized data storage
  • GDPR Compliance: Built-in privacy controls
  • Adobe Sensei: AI-powered insights

What You Can Do with Adobe Experience Platform MCP Server​

The MCP server transforms Adobe Experience Platform's API into a natural language interface, enabling AI agents to:

Customer Profile Management​

  • Profile Operations

    • "Show unified profile for customer john@example.com"
    • "Update customer preferences across all systems"
    • "Merge duplicate profiles for the same person"
    • "Find high-value customers in the northeast region"

  • Identity Resolution

    • "Link customer identities across web, mobile, and email"
    • "Find all touchpoints for a specific customer"
    • "Resolve anonymous visitors to known profiles"
    • "Track cross-device customer journeys"

  • Consent Management

    • "Update privacy preferences for EU customers"
    • "Check consent status before marketing campaigns"
    • "Apply right-to-be-forgotten requests"
    • "Manage communication preferences by channel"

Audience Segmentation​

  • Segment Creation

    • "Create segment of customers who abandoned cart in last 7 days"
    • "Build lookalike audience from high-value customers"
    • "Define segment for dormant users to re-engage"
    • "Segment by predicted lifetime value"

  • Dynamic Segmentation

    • "Update segments based on real-time behavior"
    • "Create progressive profiling segments"
    • "Build multi-condition complex segments"
    • "Apply machine learning to segment qualification"

  • Audience Activation

    • "Export segment to marketing channels"
    • "Activate audience for personalization"
    • "Schedule segment updates for campaigns"
    • "Sync audiences to advertising platforms"

Data Management​

  • Data Ingestion

    • "Import customer data from CRM system"
    • "Stream real-time events from website"
    • "Batch upload transaction history"
    • "Ingest data from multiple sources"

  • Data Quality

    • "Validate incoming data against schemas"
    • "Identify and fix data quality issues"
    • "Monitor data freshness and completeness"
    • "Apply data transformation rules"

  • Data Governance

    • "Apply data usage labels and policies"
    • "Track data lineage across systems"
    • "Enforce retention policies"
    • "Manage sensitive data access"

Journey Orchestration​

  • Journey Design

    • "Create welcome journey for new customers"
    • "Design re-engagement campaign for inactive users"
    • "Build cart abandonment recovery flow"
    • "Orchestrate cross-channel experiences"

  • Real-time Triggers

    • "Trigger journey on specific customer actions"
    • "React to real-time events and behaviors"
    • "Adjust journey based on customer response"
    • "Implement dynamic wait conditions"

  • Personalization

    • "Deliver personalized content at each touchpoint"
    • "Customize journey paths by segment"
    • "A/B test different journey variations"
    • "Optimize timing based on engagement"

Analytics & Insights​

  • Customer Analytics

    • "Analyze customer lifetime value trends"
    • "Track engagement metrics across channels"
    • "Identify churn risk indicators"
    • "Measure campaign attribution"

  • Predictive Analytics

    • "Predict next best action for customers"
    • "Forecast customer churn probability"
    • "Score leads based on conversion likelihood"
    • "Identify upsell opportunities"

  • Query Service

    • "Run SQL queries on platform data"
    • "Create custom reports and dashboards"
    • "Export analytical results"
    • "Schedule recurring queries"

Integration & Activation​

  • Destination Management

    • "Configure connections to marketing tools"
    • "Set up real-time streaming destinations"
    • "Map platform data to external systems"
    • "Monitor destination health"

  • Source Connections

    • "Connect to Adobe Creative Cloud"
    • "Integrate with Adobe Analytics"
    • "Sync with third-party systems"
    • "Configure data collection rules"

Prerequisites​

  • Access to Cequence AI Gateway
  • Adobe Experience Platform access
  • Adobe Admin Console permissions
  • IMS Organization ID
  • API credentials creation ability

Step 1: Create Adobe API Credentials​

Before setting up the MCP server, you need to create API credentials in Adobe Developer Console.

1.1 Access Adobe Developer Console​

  1. Navigate to console.adobe.io
  2. Sign in with your Adobe ID
  3. Select your organization from the dropdown
  4. Click Create new project

1.2 Add API to Project​

  1. In your project, click Add API
  2. Select Adobe Experience Platform API
  3. Choose authentication method:
    • OAuth Server-to-Server (recommended)
    • Service Account (JWT) (legacy)

1.3 Configure OAuth Server-to-Server​

  1. Set credential details:

    • Name: "AI Gateway AEP Integration"
    • Description: "MCP server for Experience Platform"

  2. Select product profiles:

    • Choose profiles with necessary permissions
    • Common profiles:
      • AEP Platform Admin
      • AEP Data Manager
      • AEP Profile Manager

  3. Generate credentials

1.4 Save Credentials​

Note down the following:

  • Client ID (API Key)
  • Client Secret
  • Organization ID
  • Technical Account ID
  • Scopes (auto-configured based on profiles)

Step 2: Access AI Gateway Apps​

  1. Log in to your Cequence AI Gateway dashboard
  2. Navigate to Apps in the left sidebar
  3. You'll see the list of available third-party applications

Step 3: Find and Select Adobe Experience Platform API​

  1. In the Apps section, browse through the Third-party category
  2. Look for Adobe Experience Platform or use the search function
  3. Click on the Adobe Experience Platform API card to view details

The Adobe Experience Platform API card shows:

  • Number of available endpoints
  • Integration capabilities
  • Quick description of functionality

Step 4: Create MCP Server​

  1. Click the Create MCP Server button on the Adobe Experience Platform API card
  2. You'll be redirected to the MCP Server creation wizard

Step 5: Configure API Endpoints​

In the App Configuration step:

  1. Base URL is pre-filled: https://platform.adobe.io
  2. Select API endpoints to expose to your MCP server based on your needs
  3. Click Next to proceed

Step 6: MCP Server Basic Setup​

Configure your MCP server details:

  1. MCP Server Name: Enter a descriptive name

    • Example: "Adobe Experience Platform CDP"
    • This name will identify your server in the dashboard

  2. Description (Optional): Add details about the server's purpose

    • Example: "Customer data platform integration for personalization"

  3. Production Mode: Toggle based on your needs

    • ON for production environments
    • OFF for development/testing

  4. Click Next to continue

Step 7: Configure Authentication​

This is where you'll use your Adobe API credentials:

  1. Authentication Type: Select OAuth 2.0

  2. Fill in the OAuth configuration:

    • Authorization URL: 
      https://ims-na1.adobelogin.com/ims/authorize/v2
    • Token URL: 
      https://ims-na1.adobelogin.com/ims/token/v3
    • Client ID: Paste from Adobe Developer Console
    • Client Secret: Paste from Adobe Developer Console
    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Scopes: Select from the available Adobe scopes (see next section)

Available Adobe Experience Platform OAuth Scopes​

Configure the appropriate scopes based on your application needs:

Core Platform Access​

  • openid

    • Required for authentication
    • Basic identity verification
    • Access to user profile

  • AdobeID

    • Adobe identity management
    • User account access
    • Profile information

  • read_organizations

    • View organization details
    • Access org structure
    • Read configuration

Platform Services​

  • aep_read

    • Read access to Experience Platform
    • View profiles and segments
    • Access datasets
    • Query platform data

  • aep_write

    • Write access to Experience Platform
    • Create and update profiles
    • Manage segments
    • Ingest data

Additional Scopes​

  • additional_info.projectedProductContext

    • Product context information
    • Enhanced profile data
    • Usage analytics

  • additional_info.job_function

    • Job role information
    • Function-based access
    • Role-specific features

For Read-Only Analytics:

openid
AdobeID
read_organizations
aep_read

For Full Platform Access:

openid
AdobeID
read_organizations
aep_read
aep_write

For Data Management:

openid
AdobeID
read_organizations
aep_read
aep_write
additional_info.projectedProductContext

Step 8: Configure Security​

Set up API protection features:

  1. API Protection: Toggle ON to enable

    • Protects against bot attacks, DDoS, and threats
    • Monitors for suspicious activity
    • Rate limiting and anomaly detection

  2. Protection Features (when enabled):

    • Auto-scaling protection
    • Managed infrastructure
    • Built-in monitoring
    • Zero maintenance required

  3. Click Next to continue

Step 9: Choose Deployment Method​

Select your deployment preference:

  • Fully managed deployment
  • Automatic scaling and monitoring
  • Built-in high availability
  • Features included:
    • Auto-scaling
    • Managed infrastructure
    • Built-in monitoring
    • Zero maintenance

Option B: Deploy with Helm Chart​

  • Self-managed Kubernetes deployment
  • Full control over infrastructure
  • Requires:
    • Kubernetes cluster
    • Helm 3.x installed
    • Container registry access

Click Next after selecting your deployment method.

Step 10: Review and Deploy​

Review your MCP server configuration:

  • MCP Server Name: Your chosen name
  • Base URL: https://platform.adobe.io
  • Selected Endpoints: Number of endpoints selected
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled
  • Deployment: Cequence Cloud or Helm

Click Create & Deploy to finalize the setup.

Step 11: Post-Deployment Setup​

After successful deployment:

  1. Note the MCP Server URL provided

  2. Test the OAuth flow:

    • Click "Test Connection"
    • You'll be redirected to Adobe login
    • Authenticate with your Adobe ID
    • Grant requested permissions
    • Confirm successful connection

  3. Configure AI Agents:

    • The MCP server is now available for AI agent connections
    • Use the provided server URL in your AI agent configuration

Using Your Adobe Experience Platform MCP Server​

With Claude Desktop​

  1. Open Claude Desktop settings

  2. Add your MCP server:

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

  3. Start using natural language commands:

    • "Show profile for customer with email john@example.com"
    • "Create a segment of high-value customers who haven't purchased in 30 days"
    • "Export audience segment to Google Ads"
    • "Analyze customer journey for recent converters"
    • "Update consent preferences for all EU customers"

API Integration Example​

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

// Get unified profile
const profile = await mcpClient.adobe.profile.getProfile({
  entityId: 'customer@example.com',
  entityIdNS: 'email',
  fields: 'person,personalEmail,consents'
});

// Create segment
const segment = await mcpClient.adobe.segmentation.createSegment({
  name: 'High Value Cart Abandoners',
  description: 'Customers with high LTV who abandoned cart',
  expression: {
    type: 'PQL',
    format: 'pql/text',
    value: 'person.lifetimeValue > 1000 AND commerce.abandons.value > 0'
  }
});

// Ingest data
await mcpClient.adobe.ingestion.createBatch({
  datasetId: 'dataset-id',
  inputFormat: {
    format: 'json'
  },
  data: customerData
});

// Run query
const queryResult = await mcpClient.adobe.queryService.createQuery({
  sql: `
    SELECT COUNT(*) as total_customers,
           AVG(person.lifetimeValue) as avg_ltv
    FROM unified_profile_dataset
    WHERE _ACP_YEAR = 2025
  `
});

Common Use Cases​

Customer 360​

  • Unified customer profiles
  • Identity resolution
  • Cross-channel tracking
  • Behavioral analysis
  • Preference management

Personalization​

  • Real-time segmentation
  • Dynamic content delivery
  • Journey orchestration
  • A/B testing
  • Recommendation engines

Data Operations​

  • ETL pipelines
  • Data quality monitoring
  • Schema management
  • Batch processing
  • Stream ingestion

Privacy & Compliance​

  • GDPR compliance
  • Consent management
  • Data retention
  • Access requests
  • Audit trails

Security Best Practices​

  1. OAuth Security:

    • Use OAuth Server-to-Server
    • Rotate credentials regularly
    • Limit scope access
    • Monitor usage patterns

  2. Data Governance:

    • Apply data usage labels
    • Implement access policies
    • Encrypt sensitive data
    • Audit data access

  3. API Management:

    • Monitor rate limits
    • Implement caching
    • Use batch operations
    • Handle errors gracefully

  4. Compliance:

    • Follow data residency rules
    • Implement retention policies
    • Track consent changes
    • Document data flows

Troubleshooting​

Common Issues​

  1. 401 IMS Authorization Failed

    • Verify client credentials
    • Check organization ID
    • Ensure proper scopes
    • Validate token expiry

  2. 403 Forbidden

    • Check product profile permissions
    • Verify dataset access
    • Ensure sandbox access
    • Review data governance policies

  3. 429 Rate Limited

    • Check rate limit headers
    • Implement backoff strategy
    • Use batch endpoints
    • Consider caching

  4. 400 Schema Validation

    • Validate data against XDM
    • Check required fields
    • Verify data types
    • Review field mappings

Getting Help​