Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.localstack/localstack-mcp-server

NPM · @LOCALSTACK/LOCALSTACK-MCP-SERVER · SCANNED AUG 7

A LocalStack MCP Server providing essential tools for local cloud development & testing

+57 this week 63 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security80
  • No malware found by supply-chain analysis.Pass
  • CVE check failed: a known high-severity CVE affects uuid 10.0.0, reached via dockerode > uuid. A fixed version is available. View diagnostics → Fail
  • No install/post-install scripts declared.Pass
  • Dependency health was assessed across the 246 of 253 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability74
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 2540 tokens (~181/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @localstack/localstack-mcp-server

# add to Claude Code
claude mcp add localstack-localstack-mcp-server -- npx -y @localstack/localstack-mcp-server
# add to Codex CLI
codex mcp add localstack-localstack-mcp-server -- npx -y @localstack/localstack-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "localstack-localstack-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@localstack/localstack-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add localstack-localstack-mcp-server --command npx --arg -y --arg @localstack/localstack-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  localstack-localstack-mcp-server:
    command: "npx"
    args: ["-y", "@localstack/localstack-mcp-server"]
// mcp.json
{
  "mcpServers": {
    "localstack-localstack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@localstack/localstack-mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 6 Aug 26 +30
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Schema quality: unverified → 100 functional
    • Tool coverage: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • First check of Schema quality: good functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: fail functional
    • First check of Tool coverage: 100 functional
  • 2 Aug 26 +28
    • CVE-2026-41907 affects this package: high security
    • Provenance: unverified → fail security
    • Known CVEs: unverified → fail security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: our sandbox run of this package did not complete, so we have no schema to compare. security
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • Capabilities: Protocol version not yet verified: our sandbox run of this package did not complete, so we never saw its MCP handshake. functional
    • Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
    • Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
    • Licence: Apache-2.0 functional
  • 1 Aug 26 −1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 −18
    • Malware scan: pass → unverified security
  • 27 Jul 26 24

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 7 Aug 2026 · Analysed npm/@localstack/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm
Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-w5hq-g745-h8pq CVE-2026-41907 high CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:H/A:N yes
Dependencies 246 packages
Packages resolved 246
Deprecated 216
Stale 70
Tree resolution Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools · 14 exposed · ~2,540 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
localstack-app-inspector ~553

Query and manage App Inspector traces, spans, and events to review deployed LocalStack applications

NameTypeReqDescription
account_idstringFilter traces or spans by LocalStack AWS account ID.
actionstringyesThe 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 fo…
arnstringFilter traces or spans by resource ARN. This value is not sent to analytics.
end_time_unix_nanonumberFilter traces or spans by end timestamp in Unix nanoseconds.
event_idstringEvent ID. Required for get-event.
event_namestringFilter events by event name.
event_typestringFilter events by event type, e.g. iam.policy_evaluation.
limitnumberMaximum number of results to return (1-1000)
operation_namestringFilter by operation name (e.g., 'CreateBucket')
pagination_tokenstringPagination cursor from a previous response
parent_span_idstringFilter traces or spans by parent span ID.
regionstringFilter by AWS region (e.g., 'us-east-1')
resource_namestringFilter by resource name
service_namestringFilter traces or spans by AWS service name, e.g. lambda, s3, sqs.
span_idstringSpan 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.
span_idsarraySpan IDs to delete for delete-spans. Omit to delete all spans in the trace scope.
start_time_unix_nanonumberFilter traces or spans by start timestamp in Unix nanoseconds.
statusstringStatus to set. Required for set-status. Use enabled before running a workload you want to inspect.
status_codenumberFilter traces or spans by status code.
trace_idstringTrace 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.
trace_idsarrayTrace IDs to delete for delete-traces. Omit to delete all traces.
versionnumberFilter traces or spans by App Inspector schema version.

No output schema declared.

No examples provided.

localstack-aws-client ~71

Executes an AWS CLI command against the running LocalStack container using the 'awslocal' wrapper.

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

No output schema declared.

No examples provided.

localstack-aws-replicator ~334

Replicate external AWS resources into a running LocalStack instance using the AWS Replicator HTTP API.

NameTypeReqDescription
actionstringyesThe AWS Replicator action to perform: start a job, check job status, list jobs, or list supported resource types.
job_idstringReplication job id. Required for the status action.
replication_typestringReplication job type. Use SINGLE_RESOURCE for one resource, or BATCH for supported batch jobs such as SSM parameters under a path prefix.
resource_arnstringFull ARN of the resource to replicate. Only supported for SINGLE_RESOURCE jobs and mutually exclusive with resource_type/resource_identifier.
resource_identifierstringCloudControl 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…
resource_typestringCloudFormation resource type to replicate, e.g. AWS::EC2::VPC or AWS::SSM::Parameter. Use this with resource_identifier, or provide resource_arn instead.
target_account_idstringOptional LocalStack target AWS account id override. LocalStack defaults to account 000000000000, so this is only needed when replicating into a non-default account namespace.
target_region_namestringOptional LocalStack target AWS region override. Defaults to the source region.

No output schema declared.

No examples provided.

localstack-chaos-injector ~105

Injects, manages, and clears chaos faults and network effects in LocalStack to test system resilience.

NameTypeReqDescription
actionstringyesThe specific chaos engineering action to perform.
latency_msnumberNetwork latency in milliseconds. Required for the 'inject-latency' action.
rulesarrayAn array of fault rules. Required for 'inject-faults', 'add-fault-rule', and 'remove-fault-rule' actions.

No output schema declared.

No examples provided.

localstack-cloud-pods ~71

Manages remote LocalStack Cloud Pods with following actions: save, load, delete

NameTypeReqDescription
actionstringyesThe Cloud Pods action to perform.
pod_namestringThe name of the Cloud Pod. This is required for 'save', 'load', and 'delete' actions.

No output schema declared.

No examples provided.

localstack-deployer ~320

Deploys or destroys AWS infrastructure on LocalStack using CDK, Terraform, or SAM.

NameTypeReqDescription
actionstringyesThe action to perform: 'deploy'/'destroy' for CDK/Terraform, or 'create-stack'/'delete-stack' for CloudFormation.
directorystringThe required path to the project directory containing your infrastructure-as-code files.
projectTypestringThe type of project. 'auto' (default) infers from files. Specify 'cdk', 'terraform', 'cloudformation', or 'sam' to override.
resolveS3booleanFor SAM deployments, whether to use --resolve-s3 when no s3Bucket is provided.
s3BucketstringS3 bucket name used by SAM deployments. If omitted, SAM can use --resolve-s3.
saveParamsbooleanFor SAM deployments, whether to persist resolved parameters to samconfig.toml using --save-params.
stackNamestringThe stack name used by CloudFormation and SAM. Required for 'create-stack'/'delete-stack' actions, and optional for SAM deploy/destroy (defaults can be inferred).
templatePathstringThe 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.
variablesobjectKey-value pairs for parameterization. Used for Terraform variables (-var) or CDK context (-c).

No output schema declared.

No examples provided.

localstack-docs ~49

Search the LocalStack documentation to find guides, API references, and configuration details

NameTypeReqDescription
limitnumberMaximum number of results to return.
querystringyesThe search query.

No output schema declared.

No examples provided.

localstack-ephemeral-instances ~168

Manage cloud-hosted LocalStack Ephemeral Instances: create, list, fetch logs, and delete.

NameTypeReqDescription
actionstringyesThe Ephemeral Instances action to perform.
cloudPodstringOptional Cloud Pod name to initialize state for create action. This is passed as CLOUD_POD_NAME.
envVarsobjectAdditional environment variables to pass to the ephemeral instance (create action only), translated to repeated --env KEY=VALUE flags.
extensionstringOptional extension package to preload for create action. This is passed as EXTENSION_AUTO_INSTALL.
lifetimenumberLifetime in minutes for create action. Defaults to CLI default when omitted.
namestringInstance name. Required for create, logs, and delete actions.

No output schema declared.

No examples provided.

localstack-extensions ~137

Install, uninstall, list, and discover LocalStack Extensions from the marketplace

NameTypeReqDescription
actionstringyeslist = installed extensions; install = install an extension; uninstall = remove an extension; available = browse the marketplace/extensions library
namestringExtension package name (e.g. 'localstack-extension-typedb' or 'localstack-extension-typedb==1.0.0'). Required for install and uninstall actions.
sourcestringGit URL to install from (e.g. 'git+https://github.com/org/repo.git'). Use this instead of name when installing from a repository.

No output schema declared.

No examples provided.

localstack-iam-policy-analyzer ~97

Configures LocalStack's IAM enforcement and analyzes logs to automatically generate missing IAM policies.

NameTypeReqDescription
actionstringyesThe action to perform: 'set-mode' to configure enforcement, 'analyze-policies' to generate a policy from logs, or 'get-status' to check the current mode.
modestringThe enforcement mode to set. This is required only when the action is 'set-mode'.

No output schema declared.

No examples provided.

localstack-logs-analysis ~157

LocalStack log analyzer that helps developers quickly diagnose issues and understand their LocalStack interactions

NameTypeReqDescription
analysisTypestringThe analysis to perform: 'summary' (default), 'errors', 'requests', or 'logs' for raw output.
filterstringRaw keyword filter. Only used with 'logs' mode.
linesnumberNumber of recent log lines to fetch and analyze.
operationstringFilter by a specific API operation (e.g., 'CreateBucket'). Requires 'service'. Used with 'requests' mode.
servicestringFilter by AWS service (e.g., 's3', 'lambda'). Used with 'errors' and 'requests' modes.

No output schema declared.

No examples provided.

localstack-management ~93

Manage LocalStack lifecycle: start, stop, restart, or check status

NameTypeReqDescription
actionstringyesThe LocalStack management action to perform
envVarsobjectAdditional environment variables as key-value pairs (only for start action)
servicestringThe LocalStack stack/service to manage. Use 'aws' for the default AWS emulator, or 'snowflake' for the Snowflake emulator.

No output schema declared.

No examples provided.

localstack-snowflake-client ~221

Execute SQL queries and commands against the LocalStack Snowflake emulator using the Snowflake CLI (snow). Use this to run SELECT queries, DDL (CREATE/DROP), DML (INSERT/UPDATE/DELETE), SHOW DATABASES/SCHEMAS/TABLES, DESCRIBE TABLE, and any other Snowflake SQL.

NameTypeReqDescription
actionstringyesAction to perform
databasestringSnowflake database context for this query.
file_pathstringAbsolute path to a .sql file to execute. Required when action is 'execute' and query is not provided.
querystringSQL query to execute (e.g. 'SELECT * FROM mytable', 'SHOW DATABASES', 'CREATE TABLE ...'). Required when action is 'execute' and file_path is not provided.
rolestringSnowflake role to use for this query.
schemastringSnowflake schema context for this query.
warehousestringSnowflake warehouse to use for this query.

No output schema declared.

No examples provided.

localstack-state-management ~164

Export, import, reset, and inspect LocalStack state using local file-based workflows on disk.

NameTypeReqDescription
actionstringyesThe 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 remo…
file_pathstringLocal 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.
servicesOptional 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.

No output schema declared.

No examples provided.