localstack/localstack-mcp-server

The App Inspector action to perform. Typical debugging flow: get-status, set-status to enabled if needed, run AWS workload, list-traces, list-spans for a trace, then list-events or list-iam-events for a span.

Status to set. Required for set-status. Use enabled before running a workload you want to inspect.

Trace ID. Required for get-trace, list-spans, get-span, delete-spans, list-events, get-event, and list-iam-events. For list-spans/list-events/list-iam-events, use '*' to query across all traces.

Span ID. Required for get-span, list-events, get-event, and list-iam-events. For list-events/list-iam-events, use '*' to query across all spans.

Event ID. Required for get-event.

Trace IDs to delete for delete-traces. Omit to delete all traces.

Span IDs to delete for delete-spans. Omit to delete all spans in the trace scope.

Maximum number of results to return (1-1000)

Pagination cursor from a previous response

Filter traces or spans by AWS service name, e.g. lambda, s3, sqs.

Filter by AWS region (e.g., 'us-east-1')

Filter traces or spans by LocalStack AWS account ID.

Filter by operation name (e.g., 'CreateBucket')

Filter by resource name

Filter traces or spans by resource ARN. This value is not sent to analytics.

Filter traces or spans by parent span ID.

Filter traces or spans by status code.

Filter traces or spans by start timestamp in Unix nanoseconds.

Filter traces or spans by end timestamp in Unix nanoseconds.

Filter traces or spans by App Inspector schema version.

Filter events by event name.

Filter events by event type, e.g. iam.policy_evaluation.

The AWS CLI command to execute (e.g., 's3 ls', 'dynamodb list-tables'). Do not include 'awslocal' or 'aws'.

The AWS Replicator action to perform: start a job, check job status, list jobs, or list supported resource types.

Replication job type. Use SINGLE_RESOURCE for one resource, or BATCH for supported batch jobs such as SSM parameters under a path prefix.

CloudFormation resource type to replicate, e.g. AWS::EC2::VPC or AWS::SSM::Parameter. Use this with resource_identifier, or provide resource_arn instead.

CloudControl identifier for the resource to replicate, such as a VPC ID (vpc-...), SSM parameter name, IAM role name, or ECR repository name. Required when using resource_type and mutually exclusive with resource_arn. For BATCH SSM parameter replication, this must be a path prefix such as /dev/.

Full ARN of the resource to replicate. Only supported for SINGLE_RESOURCE jobs and mutually exclusive with resource_type/resource_identifier.

Replication job id. Required for the status action.

Optional LocalStack target AWS account id override. LocalStack defaults to account 000000000000, so this is only needed when replicating into a non-default account namespace.

Optional LocalStack target AWS region override. Defaults to the source region.

The specific chaos engineering action to perform.

An array of fault rules. Required for 'inject-faults', 'add-fault-rule', and 'remove-fault-rule' actions.

Network latency in milliseconds. Required for the 'inject-latency' action.

The Cloud Pods action to perform.

The name of the Cloud Pod. This is required for 'save', 'load', and 'delete' actions.

The action to perform: 'deploy'/'destroy' for CDK/Terraform, or 'create-stack'/'delete-stack' for CloudFormation.

The type of project. 'auto' (default) infers from files. Specify 'cdk', 'terraform', 'cloudformation', or 'sam' to override.

The required path to the project directory containing your infrastructure-as-code files.

Key-value pairs for parameterization. Used for Terraform variables (-var) or CDK context (-c).

The stack name used by CloudFormation and SAM. Required for 'create-stack'/'delete-stack' actions, and optional for SAM deploy/destroy (defaults can be inferred).

The local template file path used by CloudFormation and SAM. Required for 'create-stack' if not discoverable from 'directory', and optional for SAM as a template override.

S3 bucket name used by SAM deployments. If omitted, SAM can use --resolve-s3.

For SAM deployments, whether to use --resolve-s3 when no s3Bucket is provided.

For SAM deployments, whether to persist resolved parameters to samconfig.toml using --save-params.

The search query.

Maximum number of results to return.

The Ephemeral Instances action to perform.

Instance name. Required for create, logs, and delete actions.

Lifetime in minutes for create action. Defaults to CLI default when omitted.

Optional extension package to preload for create action. This is passed as EXTENSION_AUTO_INSTALL.

Optional Cloud Pod name to initialize state for create action. This is passed as CLOUD_POD_NAME.

Additional environment variables to pass to the ephemeral instance (create action only), translated to repeated --env KEY=VALUE flags.

list = installed extensions; install = install an extension; uninstall = remove an extension; available = browse the marketplace/extensions library

Extension package name (e.g. 'localstack-extension-typedb' or 'localstack-extension-typedb==1.0.0'). Required for install and uninstall actions.

Git URL to install from (e.g. 'git+https://github.com/org/repo.git'). Use this instead of name when installing from a repository.

The action to perform: 'set-mode' to configure enforcement, 'analyze-policies' to generate a policy from logs, or 'get-status' to check the current mode.

The enforcement mode to set. This is required only when the action is 'set-mode'.

The analysis to perform: 'summary' (default), 'errors', 'requests', or 'logs' for raw output.

Number of recent log lines to fetch and analyze.

Filter by AWS service (e.g., 's3', 'lambda'). Used with 'errors' and 'requests' modes.

Filter by a specific API operation (e.g., 'CreateBucket'). Requires 'service'. Used with 'requests' mode.

Raw keyword filter. Only used with 'logs' mode.

The LocalStack management action to perform

The LocalStack stack/service to manage. Use 'aws' for the default AWS emulator, or 'snowflake' for the Snowflake emulator.

Additional environment variables as key-value pairs (only for start action)

Action to perform

SQL query to execute (e.g. 'SELECT * FROM mytable', 'SHOW DATABASES', 'CREATE TABLE ...'). Required when action is 'execute' and file_path is not provided.

Absolute path to a .sql file to execute. Required when action is 'execute' and query is not provided.

Snowflake database context for this query.

Snowflake schema context for this query.

Snowflake warehouse to use for this query.

Snowflake role to use for this query.

The local LocalStack state action to perform through the LocalStack State REST API. Use this tool for file-based state export/import workflows on disk. Use Cloud Pods instead when the user wants remote cloud-backed state snapshots.

Local file path for state export or import. Required for import. For export, defaults to ls-state-export in the MCP server working directory if omitted.

Optional AWS service names for service-level granularity, such as ['s3', 'lambda'] or 's3,lambda'. Supported for export, reset, and inspect. Import restores the services contained in the state file.