AWS Serverless Plugin
AI-assisted serverless development with AWS Lambda, SAM, CDK, API Gateway, EventBridge, and Step Functions.
Overview
This plugin provides comprehensive serverless development guidance with AWS best practices built-in. It integrates with the AWS Serverless MCP Server to give you access to the complete serverless development lifecycle.
Built as a Claude Code plugin, but the skill content follows the Agent Skills open standard and works with any compatible tool — Cursor, VS Code, Gemini CLI, OpenAI Codex, Roo Code, Amp, and many more. See Using with Other Tools below.
Features
Serverless Application Lifecycle
- Project Initialization: Create new SAM or CDK projects with templates and best practices
- Local Development: Test Lambda functions locally with Docker containers
- Build and Deploy: Compile, package, and deploy to AWS with CloudFormation
- Monitoring: Retrieve logs and metrics for debugging and optimization
Web Application Deployment
- Full-Stack Apps: Deploy complete applications with Lambda Web Adapter
- Response Streaming: Stream responses from Lambda for LLM output, large payloads, and long-running operations
- Frontend Assets: Manage S3 hosting with CloudFront distribution
- Custom Domains: Configure Route 53 DNS and ACM certificates
Event-Driven Architecture
- Event Source Mappings: Configure Lambda triggers for S3, SNS, DynamoDB, Kinesis, SQS, Kafka, MQ, DocumentDB
- EventBridge Integration: Event bus design, routing rules, Pipes, archive and replay
- Schema Registry: Type-safe event handling with schema discovery
Orchestration and Workflows
- Lambda Durable Functions: Multi-step workflows with checkpointing for Python 3.14+ and Node.js 22+
- Step Functions: Visual orchestration with 220+ AWS service integrations
- Patterns: Sequential, parallel, human-in-the-loop, and saga patterns
Observability
- Structured Logging: JSON logging with Powertools Logger, log level strategy, decorator stacking order
- Distributed Tracing: X-Ray with Powertools Tracer, annotations, subsegments, cold start filtering
- CloudWatch Application Signals: APM with ADOT, service maps, SLO tracking, anomaly detection
- Custom Metrics: Embedded Metric Format (EMF), business KPI vs technical metrics
- Dashboards and Alarms: Two-tier dashboard strategy, p90/p99 latency alarms, composite alarms
Optimization
- Performance Tuning: Memory right-sizing, Lambda Power Tuning, cold start optimization, SnapStart, Managed Instances
- Cost Optimization: Right-sizing, reserved concurrency, architecture recommendations
- Troubleshooting: Symptom-based diagnosis for common serverless issues
Hooks
- SAM Template Validation: Automatically runs
sam validate after Claude edits template.yaml or template.yml, catching syntax and configuration errors immediately
Installation
Prerequisites
- AWS CLI configured with credentials
- AWS SAM CLI installed
- Docker Desktop (for local testing)
- Python 3.10+ with uv package manager
Security Note
This plugin's MCP server is configured with two flags that grant elevated access:
--allow-write: Enables write operations such as creating SAM projects, deploying stacks, and modifying AWS resources. Without this flag, the server operates in read-only mode.--allow-sensitive-data-access: Enables access to Lambda function logs and API Gateway logs, which may contain sensitive application data.
To restrict these capabilities, edit .mcp.json and remove the corresponding flags from the args array.
Hook Configuration
The plugin includes a hook that runs sam validate after Claude edits SAM template files. This requires SAM CLI to be installed. If SAM CLI is not found, the hook silently skips validation.
To disable the hook, run /hooks in Claude Code and toggle it off. If the hook doesn't run after cloning, ensure the script is executable: chmod +x scripts/validate-template.sh.
Install via Marketplace
-
Add the marketplace in Claude Code:
/plugin marketplace add gunnargrosch/gunnargrosch-plugins
-
Install the plugin:
/plugin install aws-serverless@gunnargrosch-plugins
What's Included
This plugin bundles two things:
aws