omnis-aep-mcp

Claude Desktop MCP server for Omnis.ai — connects Claude to Adobe Experience Platform (AEP) via the Omnis AEP Agent.

Setup

1. Get your API key

1. Open Omnis.ai
2. Click Profile (person icon in sidebar)
3. Go to the Claude Desktop tab
4. Add your AEP org in the Organizations tab first, then click ★ to set it as default
5. Click Generate Key — copy the key immediately (shown only once)

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "omnis-aep": {
      "command": "npx",
      "args": ["-y", "omnis-aep-mcp"],
      "env": {
        "OMNIS_API_KEY": "omnis_your_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

Quit (Cmd+Q) and reopen. You'll see omnis-aep in the tools picker (🔨).

Usage

Just talk to Claude naturally:

"What AEP schemas do I have?" "Create a B2B Account schema with email and company fields" "Generate 500 test records for my Customer Profile schema"

Claude handles the multi-step flow (interview → plan → approval → execute) automatically.

Available tools

| Tool | Description | |---|---| | omnis_execute_task | Submit any AEP task — returns a task_id | | omnis_get_result | Poll task status until complete | | omnis_search_aep_spec | Search AEP OpenAPI spec index | | omnis_ask_fluffy | AEP knowledge Q&A | | omnis_generate_synthetic_data | Generate XDM-aligned synthetic data |

Environment variables

| Variable | Required | Description | |---|---|---| | OMNIS_API_KEY | ✅ | Personal API key from Omnis profile | | OMNIS_API_URL | Optional | Override endpoint (for testing/staging) |

Requirements

• Node.js 16+ (no additional dependencies — uses built-in https and readline)