Amazon Connect MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with Amazon Connect contact centers. Built with FastMCP and boto3.

Features

• 86 Tools covering all major Amazon Connect services
• 91 Configuration Templates - Industry-specific templates for cases, views, routing, and more
• Multi-Region Support - List instances across all AWS regions
• Setup Wizard - Guided setup for new Connect instances
• Infrastructure as Code - Generate CloudFormation templates

Tool Categories

Template Categories

Prerequisites

AWS CLI & Credentials

1. Install the AWS CLI

2. Configure your credentials:

# If you don't have a profile yet, create one
aws configure --profile my-connect-profile

# You'll be prompted for:
# - AWS Access Key ID
# - AWS Secret Access Key  
# - Default region (e.g., us-east-1)
# - Output format (json)

3. Verify your setup:

# List available profiles
aws configure list-profiles

# Test connectivity
aws sts get-caller-identity --profile my-connect-profile

Your profile needs IAM permissions for Amazon Connect. See Amazon Connect required permissions.

Quick Start

Installation

# Clone the repository
git clone https://github.com/mundurragacl/amazon-connect-mcp.git
cd amazon-connect-mcp

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install
pip install -e .

Running the Server

# Local (stdio) - for Claude Desktop, Cursor, etc.
fastmcp run src/amazon_connect_mcp/server.py

# Or as a module
python -m amazon_connect_mcp.server

Cursor

Or manually add to .cursor/mcp.json:

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

Kiro CLI

Add to .kiro/settings/mcp.json (workspace) or ~/.kiro/settings/mcp.json (global):

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

For macOS with virtual environment, use the full path approach:

{
  "mcpServers": {
    "amazon-connect": {
      "command": "sh",
      "args": ["-c", "cd /path/to/amazon-connect-mcp && source .venv/bin/activate && python -m amazon_connect_mcp.server"],
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-connect": {
      "command": "python",
      "args": ["-m", "amazon_connect_mcp.server"],
      "cwd": "/path/to/amazon-connect-mcp",
      "env": {
        "AWS_PROFILE": "your-profile"
      }
    }
  }
}

Usage Examples

List All Connect Instances

# Lists instances across all AWS regions
list_instances()

# Filter by region
list_instances(region="us-west-2")

Get Real-Time Metrics

get_current_metrics(instance_id="your-instance-id")

Create a Case

create_case(
    domain_id="your-domain-id",
    template_id="your-template-id",
    fields={"title": "Customer Issue", "priority": "High"}
)

Use Configuration Templates

# List available templates
template_list()

# Get a specific template
template_get(category="cases", name="general_support")

# Customize a template
template_customize(
    category="cases",
    name="billing_inquiry",
    overrides={"name": "Custom Billing Template"}
)

Setup Wizard

# Start guided setup
wizard_start_setup(
    use_case="ai_enhanced",  # basic, cases_enabled, ai_enhanced, full_enterprise
    instance_name="my-contact-center",
    region="us-east-1"
)

# Generate CloudFormation template
wizard_get_iac_template(
    use_case="basic",
    instance_name="my-cc",
    region="us-east-1"
)

Available Templates

Cases Templates (Industry-Specific)

Cases Layouts

• general_support_layout - Standard Z-formation layout
• healthcare_layout - Patient-focused layout
• financial_services_layout - Account and transaction layout
• retail_ecommerce_layout - Order and shipping layout
• insurance_claims_layout - Policy and claims layout
• telecom_layout - Service and device layout
• travel_hospitality_layout - Reservation and booking layout
• technology_layout - Product and issue layout
• utilities_layout - Service address and meter layout

Agent Views (Industry-Specific)

Data Tables

Routing Templates

Hours of Operation:

• business_hours - M-F 8am-5pm
• 24x7 - 24/7 operation
• healthcare_hours - Healthcare with on-call support
• financial_services_hours - Extended hours with 24/7 fraud line
• ecommerce_hours - Extended hours with peak season config
• utilities_24x7 - 24/7 with emergency prioritization

Queue Configurations:

• general_support - Standard queue config
• healthcare_queues - Healthcare department queues
• financial_queues - Banking queues with fraud priority
• ecommerce_queues - Retail queues with VIP support
• telecom_queues - Telecom service queues

Agent Routing Profiles:

• support_agent - General support agent profile
• healthcare_profiles - Healthcare agent profiles
• financial_profiles - Financial services profiles
• ecommerce_profiles - E-commerce agent profiles

Infrastructure as Code

• basic_instance.yaml - CloudFormation template for basic setup

Architecture

┌─────────────────────────────────────────────────────────┐
│           amazon-connect-mcp (86 Tools)                 │
│                                                         │
│  TIER 1 - Core (Always Available):                     │
│  ├── list_instances (multi-region)                     │
│  ├── describe_instance, list_queues                    │
│  ├── get_current_metrics, search_contacts              │
│  └── create_case, get_case, search_cases              │
│                                                         │
│  TIER 2 - Domain Tools:                                │
│  ├── cases_*      (16 tools)                           │
│  ├── contacts_*   (8 tools)                            │
│  ├── config_*     (17 tools)                           │
│  ├── analytics_*  (5 tools)                            │
│  ├── profiles_*   (8 tools)                            │
│  ├── campaigns_*  (10 tools)                           │
│  └── ai_*         (8 tools)                            │
│                                                         │
│  WIZARD & TEMPLATES:                                   │
│  ├── template_list, template_get, template_customize   │
│  └── wizard_start_setup, wizard_get_iac_template       │
└─────────────────────────────────────────────────────────┘

Documentation

• Amazon Connect API Features
• MCP Architecture Best Practices
• Templates & Views Research
• TODO: Templates Implementation

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Type checking
mypy src/

Requirements

• Python 3.12+
• AWS credentials with Amazon Connect permissions
• FastMCP 2.x
• boto3

License

MIT License - see LICENSE for details.

Contributing

Contributions welcome! Please read the contributing guidelines before submitting PRs.