Skip to main content
Glama
Sceptre

sceptre-mcp-server

Official
by Sceptre
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

sceptre-mcp-server

A Model Context Protocol (MCP) server that exposes Sceptre CloudFormation management operations as tools for AI agents.

What it does

AI agents (Claude, Kiro, etc.) can connect to this server and manage AWS CloudFormation stacks through Sceptre's Python API. The server exposes 22 tools covering the full stack lifecycle:

  • Stack lifecycle — create, update, delete, launch

  • Querying — status, describe, outputs, resources, events

  • Templates — generate, validate

  • Diff & drift — diff against deployed state, detect and show drift

  • Change sets — create, describe, list, execute, delete

  • Discovery — list stacks, dump resolved config

Related MCP server: quads-mcp

Requirements

  • Python 3.10+

  • A configured Sceptre project with config/ and templates/ directories

Installation

pip install sceptre-mcp-server

Or run directly without installing:

uvx sceptre-mcp-server

MCP Client Configuration

Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "sceptre": {
      "command": "uvx",
      "args": ["sceptre-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sceptre": {
      "command": "uvx",
      "args": ["sceptre-mcp-server"]
    }
  }
}

Tools Reference

Every tool requires a sceptre_project_dir parameter pointing to your Sceptre project root. Stack-specific tools also require a stack_path relative to the config/ directory.

Stack Lifecycle

Tool

Parameters

Description

create_stack

sceptre_project_dir, stack_path

Create a new CloudFormation stack

update_stack

sceptre_project_dir, stack_path

Update an existing stack

delete_stack

sceptre_project_dir, stack_path

Delete a stack

launch_stack

sceptre_project_dir, stack_path

Create or update a stack as needed

Querying

Tool

Parameters

Description

get_stack_status

sceptre_project_dir, stack_path

Get current stack status

describe_stack

sceptre_project_dir, stack_path

Get full stack details

describe_stack_outputs

sceptre_project_dir, stack_path

Get stack output values

describe_stack_resources

sceptre_project_dir, stack_path

List stack resources

describe_stack_events

sceptre_project_dir, stack_path

Get stack event history

Templates

Tool

Parameters

Description

generate_template

sceptre_project_dir, stack_path

Render the CloudFormation template

validate_template

sceptre_project_dir, stack_path

Validate template with CloudFormation

Diff & Drift

Tool

Parameters

Description

diff_stack

sceptre_project_dir, stack_path, diff_type

Diff local template vs deployed (deepdiff or difflib)

drift_detect

sceptre_project_dir, stack_path

Detect configuration drift

drift_show

sceptre_project_dir, stack_path, drifted_only

Show drift details

Change Sets

Tool

Parameters

Description

create_change_set

sceptre_project_dir, stack_path, change_set_name

Create a change set

describe_change_set

sceptre_project_dir, stack_path, change_set_name

Describe a change set

list_change_sets

sceptre_project_dir, stack_path

List all change sets

execute_change_set

sceptre_project_dir, stack_path, change_set_name

Execute a change set

delete_change_set

sceptre_project_dir, stack_path, change_set_name

Delete a change set

Discovery & Configuration

Tool

Parameters

Description

list_stacks

sceptre_project_dir, stack_path (optional)

List stacks in the project

dump_config

sceptre_project_dir, stack_path

Dump resolved stack configuration

Example Usage

Once connected, an AI agent can invoke tools like:

> List all stacks in my project at /home/user/infra

Calls: list_stacks(sceptre_project_dir="/home/user/infra")

> What's the status of the dev VPC stack?

Calls: get_stack_status(sceptre_project_dir="/home/user/infra", stack_path="dev/vpc.yaml")

> Show me what would change if I deploy the prod API stack

Calls: diff_stack(sceptre_project_dir="/home/user/infra", stack_path="prod/api.yaml")

AWS Configuration

Sceptre uses the standard AWS credential chain. To specify a profile or region, pass environment variables through your MCP client config:

{
  "mcpServers": {
    "sceptre": {
      "command": "uvx",
      "args": ["sceptre-mcp-server"],
      "env": {
        "AWS_PROFILE": "my-profile",
        "AWS_DEFAULT_REGION": "us-west-2"
      }
    }
  }
}

Contributing

See CONTRIBUTING.md for development setup, testing, pre-commit hooks, and type checking.

License

Apache-2.0

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-cli-catalog

    abcpro1
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that publishes CLI tools on your machine for discoverability by LLMs
    7
    1
    MIT

  • quads-mcp

    grafuls
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for interacting with QUADS infrastructure systems via API, enabling resource management and automation through LLM applications.
    MIT