# io.github.localstack/localstack-mcp-server (npm · @localstack/localstack-mcp-server) A LocalStack MCP Server providing essential tools for local cloud development & testing - Trust score: 63/100 (medium) - Change this week: +57 - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-08-07 ## Components - npm · `@localstack/localstack-mcp-server`: 63/100 (this document), [markdown](https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server.md), [page](https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server) ## Channel facts - Registry: `npm` - Package: `@localstack/localstack-mcp-server` - Version: `0.5.0` - Transport: `stdio` ## Trust breakdown 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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-08-07. - **Supply Chain Security**: 80/100 - No malware found by supply-chain analysis. - CVE check failed: a known high-severity CVE affects uuid 10.0.0, reached via dockerode > uuid. A fixed version is available. - No install/post-install scripts declared. - Dependency health was assessed across the 246 of 253 dependencies we could resolve, so this covers what we could see, not the whole tree. - **Provenance & Transparency**: 45/100 - Source repository is publicly reachable at the declared URL. - Provenance check failed: no build-provenance attestation is published. - Clear OSI-approved license (Apache-2.0). - Actively maintained (last published 13 days ago). - Disclosure check failed: no security disclosure policy was found in the source repository. - **Schema Quality & AI Usability**: 74/100 - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name). - AI-judged instruction clarity (good). - 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. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 0/100 - Stability not yet verified: not enough scan history yet (needs a 30-day window). - **Tool Coverage**: 100/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 100% of tool parameters carry a description. - **Capabilities**: 100/100 - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28. **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 ### Claude ```bash claude mcp add localstack-localstack-mcp-server -- npx -y @localstack/localstack-mcp-server ``` ### Codex ```bash 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 } } } ``` ### OpenClaw ```bash openclaw mcp add localstack-localstack-mcp-server --command npx --arg -y --arg @localstack/localstack-mcp-server ``` ### Hermes ```yaml mcp_servers: localstack-localstack-mcp-server: command: "npx" args: ["-y", "@localstack/localstack-mcp-server"] ``` ### Other ```json { "mcpServers": { "localstack-localstack-mcp-server": { "command": "npx", "args": [ "-y", "@localstack/localstack-mcp-server" ] } } } ``` ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-08-06 (score 63, +30) - [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). - [functional improvement] Schema quality: unverified → 100 - [functional improvement] Tool coverage: unverified → 100 - [functional improvement] 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 ### 2026-08-02 (score 33, +28) - [security regression] CVE-2026-41907 affects this package: high - [security regression] Provenance: unverified → fail - [security regression] Known CVEs: unverified → fail - [security improvement] Install scripts: unverified → pass - [security improvement] 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. - [functional improvement] License: unverified → pass - [functional improvement] Dependency health: unverified → partial - [functional improvement] 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 ### 2026-08-01 (score 5, −1) - [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server ### 2026-07-31 (score 6, −18) - [security regression] Malware scan: pass → unverified ### 2026-07-27 (score 24) First indexed and scored. ## MCP tools (14) ### `localstack-app-inspector` (~553 tokens) LocalStack App Inspector Query and manage App Inspector traces, spans, and events to review deployed LocalStack applications Input parameters: - `account_id` (string): Filter traces or spans by LocalStack AWS account ID. - `action` (string, required): 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 fo… - `arn` (string): Filter traces or spans by resource ARN. This value is not sent to analytics. - `end_time_unix_nano` (number): Filter traces or spans by end timestamp in Unix nanoseconds. - `event_id` (string): Event ID. Required for get-event. - `event_name` (string): Filter events by event name. - `event_type` (string): Filter events by event type, e.g. iam.policy_evaluation. - `limit` (number): Maximum number of results to return (1-1000) - `operation_name` (string): Filter by operation name (e.g., 'CreateBucket') - `pagination_token` (string): Pagination cursor from a previous response - `parent_span_id` (string): Filter traces or spans by parent span ID. - `region` (string): Filter by AWS region (e.g., 'us-east-1') - `resource_name` (string): Filter by resource name - `service_name` (string): Filter traces or spans by AWS service name, e.g. lambda, s3, sqs. - `span_id` (string): 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. - `span_ids` (array): Span IDs to delete for delete-spans. Omit to delete all spans in the trace scope. - `start_time_unix_nano` (number): Filter traces or spans by start timestamp in Unix nanoseconds. - `status` (string): Status to set. Required for set-status. Use enabled before running a workload you want to inspect. - `status_code` (number): Filter traces or spans by status code. - `trace_id` (string): 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. - `trace_ids` (array): Trace IDs to delete for delete-traces. Omit to delete all traces. - `version` (number): Filter traces or spans by App Inspector schema version. ### `localstack-aws-client` (~71 tokens) LocalStack AWS Client Executes an AWS CLI command against the running LocalStack container using the 'awslocal' wrapper. Input parameters: - `command` (string, required): The AWS CLI command to execute (e.g., 's3 ls', 'dynamodb list-tables'). Do not include 'awslocal' or 'aws'. ### `localstack-aws-replicator` (~334 tokens) LocalStack AWS Replicator Replicate external AWS resources into a running LocalStack instance using the AWS Replicator HTTP API. Input parameters: - `action` (string, required): The AWS Replicator action to perform: start a job, check job status, list jobs, or list supported resource types. - `job_id` (string): Replication job id. Required for the status action. - `replication_type` (string): Replication job type. Use SINGLE_RESOURCE for one resource, or BATCH for supported batch jobs such as SSM parameters under a path prefix. - `resource_arn` (string): Full ARN of the resource to replicate. Only supported for SINGLE_RESOURCE jobs and mutually exclusive with resource_type/resource_identifier. - `resource_identifier` (string): 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… - `resource_type` (string): CloudFormation 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_id` (string): 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. - `target_region_name` (string): Optional LocalStack target AWS region override. Defaults to the source region. ### `localstack-chaos-injector` (~105 tokens) LocalStack Chaos Injector Injects, manages, and clears chaos faults and network effects in LocalStack to test system resilience. Input parameters: - `action` (string, required): The specific chaos engineering action to perform. - `latency_ms` (number): Network latency in milliseconds. Required for the 'inject-latency' action. - `rules` (array): An array of fault rules. Required for 'inject-faults', 'add-fault-rule', and 'remove-fault-rule' actions. ### `localstack-cloud-pods` (~71 tokens) LocalStack Cloud Pods Manages remote LocalStack Cloud Pods with following actions: save, load, delete Input parameters: - `action` (string, required): The Cloud Pods action to perform. - `pod_name` (string): The name of the Cloud Pod. This is required for 'save', 'load', and 'delete' actions. ### `localstack-deployer` (~320 tokens) LocalStack Deployer Deploys or destroys AWS infrastructure on LocalStack using CDK, Terraform, or SAM. Input parameters: - `action` (string, required): The action to perform: 'deploy'/'destroy' for CDK/Terraform, or 'create-stack'/'delete-stack' for CloudFormation. - `directory` (string): The required path to the project directory containing your infrastructure-as-code files. - `projectType` (string): The type of project. 'auto' (default) infers from files. Specify 'cdk', 'terraform', 'cloudformation', or 'sam' to override. - `resolveS3` (boolean): For SAM deployments, whether to use --resolve-s3 when no s3Bucket is provided. - `s3Bucket` (string): S3 bucket name used by SAM deployments. If omitted, SAM can use --resolve-s3. - `saveParams` (boolean): For SAM deployments, whether to persist resolved parameters to samconfig.toml using --save-params. - `stackName` (string): 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). - `templatePath` (string): 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. - `variables` (object): Key-value pairs for parameterization. Used for Terraform variables (-var) or CDK context (-c). ### `localstack-docs` (~49 tokens) LocalStack Docs Search Search the LocalStack documentation to find guides, API references, and configuration details Input parameters: - `limit` (number): Maximum number of results to return. - `query` (string, required): The search query. ### `localstack-ephemeral-instances` (~168 tokens) LocalStack Ephemeral Instances Manage cloud-hosted LocalStack Ephemeral Instances: create, list, fetch logs, and delete. Input parameters: - `action` (string, required): The Ephemeral Instances action to perform. - `cloudPod` (string): Optional Cloud Pod name to initialize state for create action. This is passed as CLOUD_POD_NAME. - `envVars` (object): Additional environment variables to pass to the ephemeral instance (create action only), translated to repeated --env KEY=VALUE flags. - `extension` (string): Optional extension package to preload for create action. This is passed as EXTENSION_AUTO_INSTALL. - `lifetime` (number): Lifetime in minutes for create action. Defaults to CLI default when omitted. - `name` (string): Instance name. Required for create, logs, and delete actions. ### `localstack-extensions` (~137 tokens) LocalStack Extensions Install, uninstall, list, and discover LocalStack Extensions from the marketplace Input parameters: - `action` (string, required): list = installed extensions; install = install an extension; uninstall = remove an extension; available = browse the marketplace/extensions library - `name` (string): Extension package name (e.g. 'localstack-extension-typedb' or 'localstack-extension-typedb==1.0.0'). Required for install and uninstall actions. - `source` (string): Git URL to install from (e.g. 'git+https://github.com/org/repo.git'). Use this instead of name when installing from a repository. ### `localstack-iam-policy-analyzer` (~97 tokens) LocalStack IAM Policy Analyzer Configures LocalStack's IAM enforcement and analyzes logs to automatically generate missing IAM policies. Input parameters: - `action` (string, required): 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. - `mode` (string): The enforcement mode to set. This is required only when the action is 'set-mode'. ### `localstack-logs-analysis` (~157 tokens) LocalStack Logs Analysis LocalStack log analyzer that helps developers quickly diagnose issues and understand their LocalStack interactions Input parameters: - `analysisType` (string): The analysis to perform: 'summary' (default), 'errors', 'requests', or 'logs' for raw output. - `filter` (string): Raw keyword filter. Only used with 'logs' mode. - `lines` (number): Number of recent log lines to fetch and analyze. - `operation` (string): Filter by a specific API operation (e.g., 'CreateBucket'). Requires 'service'. Used with 'requests' mode. - `service` (string): Filter by AWS service (e.g., 's3', 'lambda'). Used with 'errors' and 'requests' modes. ### `localstack-management` (~93 tokens) LocalStack Management Manage LocalStack lifecycle: start, stop, restart, or check status Input parameters: - `action` (string, required): The LocalStack management action to perform - `envVars` (object): Additional environment variables as key-value pairs (only for start action) - `service` (string): The LocalStack stack/service to manage. Use 'aws' for the default AWS emulator, or 'snowflake' for the Snowflake emulator. ### `localstack-snowflake-client` (~221 tokens) LocalStack Snowflake Client 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. Input parameters: - `action` (string, required): Action to perform - `database` (string): Snowflake database context for this query. - `file_path` (string): Absolute path to a .sql file to execute. Required when action is 'execute' and query is not provided. - `query` (string): SQL query to execute (e.g. 'SELECT * FROM mytable', 'SHOW DATABASES', 'CREATE TABLE ...'). Required when action is 'execute' and file_path is not provided. - `role` (string): Snowflake role to use for this query. - `schema` (string): Snowflake schema context for this query. - `warehouse` (string): Snowflake warehouse to use for this query. ### `localstack-state-management` (~164 tokens) LocalStack State Management Export, import, reset, and inspect LocalStack state using local file-based workflows on disk. Input parameters: - `action` (string, required): 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 remo… - `file_path` (string): 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. - `services`: 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. ## Diagnostics Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server#diagnostics ## Score history - 2026-08-07: 63 - 2026-08-06: 63 - 2026-08-05: 33 - 2026-08-04: 33 - 2026-08-03: 33 - 2026-08-02: 33 - 2026-08-01: 5 - 2026-07-31: 6 - 2026-07-30: 24 - 2026-07-28: 24 - 2026-07-27: 24 ## Links - npm package: https://www.npmjs.com/package/@localstack/localstack-mcp-server - Socket report: https://socket.dev/npm/package/@localstack/localstack-mcp-server - Repository: https://github.com/localstack/localstack-mcp-server - Changelog RSS feed: https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server.xml - Changelog JSON feed: https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server.json - HTML version of this page: https://verifymcp.io/servers/localstack-localstack-mcp-server/localstack-localstack-mcp-server