Migration Accelerator MCP Server

An MCP (Model Context Protocol) server that exposes the Migration Accelerator platform's full capabilities to AI assistants like Claude.

Features

• 40+ Migration Tools: Access all agent tools including snapshots, page creation, publishing, and AI-powered mapping
• Site Configuration: Configure sites and CMS platform connections via MCP
• Secure Authentication: API key-based auth with scopes and rate limiting
• Dual Transport: Supports both stdio (Claude Desktop) and HTTP/SSE (web integrations)

Installation

npm install @noice-work/migration-accelerator-mcp
# or
pnpm add @noice-work/migration-accelerator-mcp

Quick Start

1. Generate an API Key

Generate an API key from the Migration Accelerator dashboard:

1. Go to Organization Settings > API Keys
2. Click Create MCP API Key
3. Configure scopes and save the key securely

2. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "migration-accelerator": {
      "command": "npx",
      "args": ["@noice-work/migration-accelerator-mcp"],
      "env": {
        "MCP_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

3. Start Using

Ask Claude to:

• "List my migration sites"
• "Snapshot the homepage of my site"
• "Create a new page with the hero component"
• "Publish all approved pages"

CLI Usage

# stdio transport (default - for Claude Desktop)
MCP_API_KEY=mcp_xxx npx @noice-work/migration-accelerator-mcp

# HTTP/SSE transport (for web integrations)
MCP_API_KEY=mcp_xxx npx @noice-work/migration-accelerator-mcp --transport http --port 3001

# With custom API URL
MCP_API_KEY=mcp_xxx npx @noice-work/migration-accelerator-mcp --api-url https://api.mycompany.com

# Debug mode
MCP_API_KEY=mcp_xxx npx @noice-work/migration-accelerator-mcp --debug

Available Tools

Snapshot Tools

• agents_createSnapshot - Capture page snapshot with screenshot
• agents_listSnapshots - Browse captured snapshots
• mcp_snapshotAnyUrl - Snapshot URLs outside configured sites

Page Lifecycle

• agents_createPage - Create new page with metadata
• agents_editPage - Modify page content
• agents_readPage - Read current page structure
• agents_listPageVersions - View page history
• agents_restorePageVersion - Restore previous version
• agents_bulkCreatePages - Create multiple pages
• agents_bulkEditPages - Batch edit pages

Publishing

• agents_publishPage - Publish single page
• agents_publishApprovedPages - Publish all approved pages
• agents_managePageTool - Approve/delete pages

Discovery

• agents_startPageDiscovery - Start crawling a site
• agents_getDiscoveryStatus - Check crawl progress
• agents_waitForPageDiscovery - Wait for completion

Search

• agents_searchPages - Search pages by content/metadata
• agents_searchAssets - Search DAM assets
• agents_listDiscoveredPages - List discovered URLs

AI/RAG

• agents_retrieveKnowledge - Query knowledge base
• agents_createIrMapping - Generate component mappings
• agents_generateImage - AI image generation
• agents_deepResearch - Research-grade analysis

Configuration (MCP Native)

• mcp_configureSite - Create/update site config
• mcp_configurePlatform - Configure CMS connection
• mcp_testPlatformConnection - Test CMS connectivity
• mcp_syncDefinitions - Sync component definitions
• mcp_listSites - List accessible sites
• mcp_getSite - Get site details

Permission Scopes

| Scope | Description | |-------|-------------| | read | Read sites, pages, snapshots | | write | Create/edit pages, snapshots | | write:publish | Publish approved pages | | admin:config | Modify site/platform configuration | | execute:discovery | Run page discovery | | execute:ai | Use AI tools (consumes credits) |

MCP Resources

The server exposes sites as MCP resources:

| URI Pattern | Description | |-------------|-------------| | site://{siteId} | Site overview | | site://{siteId}/pages | Page snapshots | | site://{siteId}/templates | Available templates |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | MCP_API_KEY | API key for authentication | Required | | MA_API_URL | Migration Accelerator API URL | http://localhost:3000 |

HTTP/SSE Transport

For web integrations, the HTTP transport exposes:

• GET /health - Health check
• GET /sse - SSE connection for MCP messages
• POST /message - Send messages to the server

Include the API key in the Authorization: Bearer mcp_xxx header.

Development

# Clone and install
git clone https://github.com/noicework/migration-accelerator.git
cd migration-accelerator/mcp-server
pnpm install

# Build
pnpm build

# Run locally
pnpm start

# Watch mode
pnpm dev

License

MIT - Noicework Labs