
AWS Serverless MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude and Cursor build, test and deploy AWS Lambda and SAM apps, read-only until you switch on writes.
This is an AWS Labs server for serverless work. It runs on your computer with your own AWS credentials. It can start and build SAM projects, test Lambda functions locally, read logs and metrics, and deploy web apps to Lambda.
It starts read-only. You add one flag to allow deploys and another to allow log access. You also need the AWS SAM CLI, the AWS CLI, and Docker for local tests.
Good for
- Developers building Lambda and SAM apps
- Teams who want the assistant to deploy a web app to AWS Lambda
- Engineers debugging a failing Lambda with logs and metrics
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install AWS Serverless MCP
Claude Code
- 1
Copy this prompt.
Add the AWS Serverless MCP server to Claude Code. Run this command: claude mcp add aws-serverless -- uvx awslabs.aws-serverless-mcp-server Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Creates a new SAM project
Starts a serverless project with the AWS SAM command line tool, with a template, runtime and folder layout.
Try: “Create a Python SAM project called my-todo-app.”
Write ·
sam_initBuilds a SAM app
Compiles the Lambda code and prepares deployment files for a SAM project. It can build inside a container.
Try: “Build the SAM app in this folder.”
Runs code ·
sam_buildDeploys a SAM app to AWS
Deploys the app to your AWS account through CloudFormation. It needs the write flag to be switched on.
Try: “Deploy my-todo-app to us-east-1.”
Write ·
sam_deployFetches CloudWatch logs
Returns logs for the resources in a SAM app to help debug failures. It is off until you allow sensitive data access.
Try: “Show the last 30 minutes of logs for the API function.”
Network ·
sam_logsRuns a Lambda function locally
Runs a function in a local Docker container that mimics Lambda, so you can test before deploying.
Try: “Invoke the hello function locally with this event.”
Runs code ·
sam_local_invokeHelps choose SAM, CDK or CloudFormation
Explains how to pick an infrastructure-as-code tool for a serverless deployment, with examples.
Try: “Should I use SAM or CDK for this project?”
Read ·
get_iac_guidanceSays whether Lambda fits your use case
Returns a guide on when to choose Lambda, with pros, cons and decision criteria for your use case.
Try: “Is Lambda a good fit for a nightly batch job?”
Read ·
get_lambda_guidanceGets Lambda event types by source and language
Returns the event schema for a source such as S3, SQS or API Gateway, with types for your language.
Try: “Give me the Python event type for an S3 trigger.”
Read ·
get_lambda_event_schemasGets example SAM templates
Returns example SAM templates from the Serverless Land GitHub repo.
Try: “Show a SAM template for an SQS-triggered Lambda.”
Network ·
get_serverless_templatesExplains how to deploy a Lambda app
Gives the steps for deploying a Lambda application: templates, build, package and deploy.
Try: “How do I deploy this Lambda app?”
Read ·
deploy_serverless_app_helpDeploys a web app on Lambda
Deploys a frontend, backend or full-stack web app on Lambda, API Gateway and CloudFront. It can create public resources and DNS records, and needs the write flag.
Try: “Deploy my Node.js app as a full-stack site on AWS.”
Write ·
deploy_webappUploads new frontend files
Uploads built frontend files to S3 and can clear the CloudFront cache. It needs the write flag.
Try: “Push the new build to my deployed web app.”
Write ·
update_webapp_frontendSets up a custom domain
Creates the Route 53 records and ACM certificate for a custom domain and ties it to the app's CloudFront. It needs the write flag.
Try: “Point shop.example.com at my deployed app.”
Write ·
configure_domainExplains web app deployment
Returns help on using the web app deployment tool for each deployment type.
Try: “How do I deploy a backend-only web app?”
Read ·
webapp_deployment_helpReads CloudWatch metrics for a deployed app
Returns error rates, latency and concurrency for the Lambda and API Gateway parts of a deployed web app.
Try: “What is the error rate for my-web-app this week?”
Network ·
get_metricsLists EventBridge schema registries
Lists the schema registries in your AWS account.
Try: “List my EventBridge schema registries.”
Network ·
list_registriesSearches EventBridge schemas
Searches a registry for event schemas by keyword.
Try: “Find the autoscaling event schema in aws.events.”
Network ·
search_schemaGets an EventBridge schema definition
Returns the full definition of one schema version, so code can be generated against it.
Try: “Describe that autoscaling schema.”
Network ·
describe_schemaGuides event source mapping setup
Gives step-by-step help for setting up and troubleshooting event source mappings, and can write IAM policies and SAM templates. The README says it asks you to confirm before any deployment.
Try: “Set up a Lambda consumer for my Kafka cluster in my VPC.”
Write ·
esm_guidanceDiagnoses Kafka event source problems
Diagnoses connection, sign-in and performance problems with a Kafka event source mapping and writes fix templates.
Try: “Why is my Kafka trigger not firing?”
Write ·
esm_kafka_troubleshootTunes event source mappings
Writes SAM templates that improve how an event source mapping is configured. It asks you to confirm before deploying.
Try: “Optimize my SQS event source mapping.”
Write ·
esm_optimizeMakes an IAM policy for Kafka triggers
Fills a fixed AWS-approved IAM policy template for a Lambda function reading from an MSK cluster. It writes no policy of its own and needs the write flag.
Try: “Create the IAM policy for my Lambda to read the orders MSK cluster.”
Read ·
secure_esm_msk_policyMakes an IAM policy for SQS triggers
Fills a fixed AWS-approved IAM policy template for a Lambda function reading from an SQS queue. It needs the write flag.
Try: “Create the IAM policy for my Lambda to read the jobs queue.”
Read ·
secure_esm_sqs_policyMakes an IAM policy for Kinesis triggers
Fills a fixed AWS-approved IAM policy template for a Lambda function reading from a Kinesis stream. It needs the write flag.
Try: “Create the IAM policy for my Lambda to read the clickstream stream.”
Read ·
secure_esm_kinesis_policyMakes an IAM policy for DynamoDB Streams triggers
Fills a fixed AWS-approved IAM policy template for a Lambda function reading from a DynamoDB stream. It needs the write flag.
Try: “Create the IAM policy for my Lambda to read the orders table stream.”
Read ·
secure_esm_dynamodb_policy
From the official docs
Permissions
medium risk · 4 things to watch
Medium risk
With the write flag on, it can deploy stacks, create public resources such as CloudFront and DNS records, and run up AWS costs. Leave the flag off until you need it, and use an AWS role limited to what the task needs.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Write mode can deploy and create public resources
Deploys go through CloudFormation and can create CloudFront distributions and Route 53 records. Switch the write flag on only for a task, and review each deploy. raw.githubusercontent.com
Default mode still runs local commands and reads your AWS account
Without the write flag the server cannot deploy, but sam_init writes project files, sam_build and sam_local_invoke run on your machine (local invoke uses Docker), and the schema and metrics tools read from your AWS account. raw.githubusercontent.com
It uses your AWS credentials
Anything your profile can do, the deploy tools can attempt. The README advises a dedicated least-privilege role, tagging and CloudTrail. raw.githubusercontent.com
Logs can contain sensitive data
The log tool is off by default and returns your Lambda and API Gateway logs when allowed. The server says it scrubs credentials and personal data, but check what you share. raw.githubusercontent.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | Read-only is the default. Add --allow-write to allow deploys and the ESM tools, and --allow-sensitive-data-access to allow logs. Both flags are in the README and the server source. |
|---|---|
| Talks to | Your AWS account. Serverless Land (templates) |
| Sign-in and keys | Your AWS credentials from a profile, or temporary keys, set as environment variables on your machine. |
Questions
Is the AWS Serverless MCP server official?
Yes. It is published by AWS Labs, in the awslabs/mcp repository.
Can it run read-only?
Yes, and it does by default. It only changes AWS resources if you add the write flag, and only reads logs if you add the sensitive data flag.
What do I need installed?
An AWS account with credentials, uv, Python 3.10 or newer, the SAM CLI and the AWS CLI. Local function tests also need Docker. The install box covers the server itself.
Which AWS credentials does it use?
The default AWS profile, unless you set a profile name or temporary keys in the config. You can also set the AWS region, which defaults to us-east-1.
Can it deploy to production?
It can, with the write flag on. AWS says it can be used in production with read-only default, separate roles for read and write, and a human approving each tool call.
How many tools does it have?
25. The README documents 21 of them. The source also registers four IAM policy tools (secure_esm_msk_policy, secure_esm_sqs_policy, secure_esm_kinesis_policy, secure_esm_dynamodb_policy). The README also names esm_validate_configs and two other helpers, but those are actions inside esm_optimize, not separate tools.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
awslabs.aws-serverless-mcp-server- Registry
- PyPI
- Transport
- stdio
- Auth
- token in env
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
Other AWS MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- raw.githubusercontent.com · raw.githubusercontent.com
- github.com · github.com
- github.com · github.com