Catalog›Plugins›Cloud & DevOps›aws-serverlessASaws-serverlessDesign, build, deploy, test, and debug serverless applications with AWS Serverless services. Open site Open in the app JSON README (API)Design, build, deploy, test, and debug serverless applications with AWS Serverless services.READMELoading documentation…# Agent Plugins for AWS _Read this in other languages: [日本語](https://github.com/awslabs/agent-plugins/blob/HEAD/README.jp.md)_ > [!IMPORTANT] > Generative AI can make mistakes. You should consider reviewing all output and costs generated by your chosen AI model and agentic coding assistant. See [AWS Responsible AI Policy](https://aws.amazon.com/ai/responsible-ai/policy/). ## What's new > [!TIP] > The [Agent Toolkit for AWS](https://aws.amazon.com/about-aws/whats-new/2026/05/agent-toolkit/) is now live! The Agent Toolkit for AWS is the successor to the MCP servers, plugins, and skills available on AWS Labs, and was informed by feedback from customers like you. If you're building production software using coding agents or building agents for your own customers, we recommend Agent Toolkit for AWS. It includes IAM condition keys to distinguish agent actions from human ones, CloudWatch and CloudTrail visibility, and skills that have been evaluated for accuracy and effectiveness. This repo continues to work and accept contributions. Over time, the most useful projects here will move into Agent Toolkit for AWS. --- ## Agent Plugins for AWS Agent Plugins for AWS equip AI coding agents with the skills to help you architect, deploy, and operate on AWS. Agent plugins are currently supported by Claude Code, Codex, and Cursor. AI coding agents are increasingly used in software development, helping developers write, review, and deploy code more efficiently. Agent skills and the broader agent plugin packaging model are emerging as best practices for steering coding agents toward reliable outcomes without bloating model context. Instead of repeatedly pasting long AWS guidance into prompts, developers can now encode that guidance as reusable, versioned capabilities that agents invoke when relevant. This improves determinism, reduces context overhead, and makes agent behavior easier to standardize across teams. Agent plugins act as containers that package different types of expertise artifacts together. A single agent plugin can include: - Agent skills – Structured workflows and best-practice playbooks that guide AI through complex tasks like deployment, code review, or architecture planning. Agent skills encode domain expertise as step-by-step processes. - MCP servers – Connections to external services, data sources, and APIs. MCP servers give your assistant access to live documentation, pricing data, and other resources at runtime. Learn more about [MCP servers for AWS](https://github.com/awslabs/mcp). - Hooks – Automation and guardrails that run on developer actions. Hooks can validate changes, enforce standards, or trigger workflows automatically. - References – Documentation, configuration defaults, and knowledge that the agent skill can consult. References make agent skills smarter without bloating the prompt. As new types of expertise artifacts emerge in this space, they can be packaged into agent plugins, making the evolution transparent to developers. ## Best practices To maximize the benefits of plugin-assisted development while maintaining security and code quality, follow these essential guidelines: - Always review generated code before deployment (for example, against your constraints for security, cost, resilience) - Use plugins as accelerators, not replacements for developer judgment and expertise. - Keep plugins updated to benefit from the latest AWS best practices. - Follow the principle of least privilege when configuring AWS credentials. - Run security scanning tools on generated infrastructure code. ## Plugins | Plugin | Description | Status | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | | **amazon-location-service** | Add maps, geocoding, routing, places search, and geospatial features to applications with Amazon Location Service | Available | | **aws-amplify** | Build full-stack apps with AWS Amplify Gen 2 using guided workflows for auth, data, storage, and functions | Available | | **aws-serverless** | Build serverless applications with Lambda, API Gateway, EventBridge, Step Functions, durable functions, and Lambda Managed Instances | Available | | **aws-transform** | Migrate, modernize, and upgrade codebases to AWS — .NET to .NET 8/10, mainframe COBOL to Java, VMware to EC2, SQL Server to Aurora, and language/SDK upgrades | Available | | **codebase-documentor-for-aws** | Analyze AWS-deployed services and codebases to generate structured technical documentation with source-of-truth citations | Available | | **databases-on-aws** | Database guidance for the AWS database portfolio — schema design, queries, migrations, and multi-tenant patterns | Some Services Available (Aurora DSQL) | | **deploy-on-aws** | Deploy applications to AWS with architecture recommendations, cost estimates, and IaC deployment | Available | | **migration-to-aws** | Migrate GCP infrastructure to AWS with resource discovery, architecture mapping, cost analysis, and execution planning | Available | | **sagemaker-ai** | Build, train, and deploy AI models with deep AWS AI/ML expertise brought directly into your coding assistants, covering the surface area of [Amazon SageMaker AI](https://aws.amazon.com/sagemaker/ai/) | Available | ## Installation ### Claude Code #### Add the marketplace ```bash /plugin marketplace add awslabs/agent-plugins ``` #### Install a plugin ```bash /plugin install amazon-location-service@agent-plugins-for-aws ``` or ```bash /plugin install aws-amplify@agent-plugins-for-aws ``` or ```bash /plugin install aws-serverless@agent-plugins-for-aws ``` or ```bash /plugin install codebase-documentor-for-aws@agent-plugins-for-aws ``` or ```bash /plugin install databases-on-aws@agent-plugins-for-aws ``` or ```bash /plugin install deploy-on-aws@agent-plugins-for-aws ``` or ```bash /plugin install sagemaker-ai@agent-plugins-for-aws ``` ### Codex Codex supports repo-local marketplaces and plugin manifests through `.agents/plugins/marketplace.json` and per-plugin manifests under `plugins/*/.codex-plugin/plugin.json`; this repo includes both, following the official Codex plugin packaging guidance in [Build plugins](https://developers.openai.com/codex/plugins/build). To try these plugins in Codex from this repo: 1. Clone this repository locally. 2. Open the repo in Codex so Codex can discover `.agents/plugins/marketplace.json`. 3. Restart Codex. 4. Open the plugin directory, choose the `Agent Plugins for AWS` marketplace, and install the plugin you want to use. Known limitation: - Claude-specific automatic hooks are not yet wired into the Codex manifests. - The `databases-on-aws` prompt hook is included because it does not depend on Claude-specific environment variables. ### Cursor You can install the **deploy-on-aws** plugin from the [Cursor Marketplace](https://cursor.com/marketplace/aws). For additional information, please refer to the [Cursor plugin documentation](https://cursor.com/docs/plugins). You can also install within the Cursor application: - Open Cursor Settings - Navigate to `Plugins` - Search for `AWS` - Select the plugin you want to install and click `Add to Cursor` - Select the scope for the installed plugin - The plugin should appear under `Plugins -> Installed` ### Kiro (experimental) You can convert Claude Code plugins into Kiro format using the third-party [`@every-env/compound-plugin`](https://www.npmjs.com/package/@every-env/compound-plugin) CLI. This converts skills (SKILL.md workflow instructions and reference documents) and MCP server configs into Kiro's `.kiro/` format. Requires [Bun](https://bun.sh) (latest version recommended). > [!NOTE] > Hook conversion is a work in progress — hooks are currently dropped entirely during conversion because the Claude Code and Kiro hook models are not 1:1. Skills and MCP servers are fully supported. #### Project scope Writes to `.kiro/` in the current working directory: ```bash COMPOUND_PLUGIN_GITHUB_SOURCE=https://github.com/awslabs/agent-plugins \ bunx @every-env/compound-plugin install deploy-on-aws --to kiro ``` #### Global scope Writes to `~/.kiro/` so skills are available across all projects: ```bash COMPOUND_PLUGIN_GITHUB_SOURCE=https://github.com/awslabs/agent-plugins \ bunx @every-env/compound-plugin install deploy-on-aws --to kiro --output ~/.kiro ``` Replace `deploy-on-aws` with any plugin name from the table above (e.g., `aws-serverless`, `amazon-location-service`, `migration-to-aws`, `aws-amplify`). > [!TIP] > If a skill isn't activated automatically, you can explicitly invoke it by saying "Use the deploy skill to ..." in your prompt. Kiro's intent matching may not always auto-trigger skills. > > If `bunx` fails with a "Cannot find package" error, clear the bun cache and retry: > > ```bash > rm -rf ~/.bun/install/cache/@every-env > ``` For issues with the conversion tool, please report them at [EveryInc/compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin/issues). ## amazon-location-service Guides developers through adding maps, places search, geocoding, routing, and other geospatial features with Amazon Location Service, including authentication setup, SDK integration, and best practices. ### Agent Skill Triggers | Agent Skill | Triggers | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **amazon-location-service** | "add a map", "geocode an address", "calculate a route", "location-aware app", "Amazon Location Service", "geospatial", "places search" | ### MCP Servers | Server | Purpose | | ----------- | -------------------------------------- | | **aws-mcp** | AWS documentation and service guidance | ## aws-amplify Build full-stack apps with AWS Amplify Gen 2 using TypeScript code-first development, guided by official AWS Agent Standard Operating Procedures (SOPs). ### Workflow 1. **Backend** - Create Amplify Gen 2 resources (auth, data, storage, functions) 2. **Sandbox** - Deploy to sandbox for testing 3. **Frontend & Test** - Connect frontend to backend, verify locally 4. **Production** - Deploy to production ### Agent Skill Triggers | Agent Skill | Triggers | | -------------------- | ------------------------------------------------------------------------------------------------------------ | | **amplify-workflow** | "build Amplify app", "create Amplify project", "add auth to Amplify", "deploy Amplify", "full-stack Amplify" | ### MCP Servers | Server | Purpose | | ----------- | -------------------------------------- | | **aws-mcp** | AWS documentation and service guidance | ## aws-serverless Design, build, deploy, test, and debug serverless applications with AWS Lambda, API Gateway, EventBridge, Step Functions, and durable functions. Includes SAM and CDK deployment workflows, a SAM template validation hook, the AWS Lambda durable functions skill for building resilient, long-running, multi-step applications, and the Lambda Managed Instances skill for evaluating, configuring, and migrating workloads to EC2-backed Lambda. ### Agent Skill Triggers | Agent Skill | Triggers | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **aws-lambda** | "Lambda function", "event source", "serverless application", "API Gateway", "EventBridge", "Step Functions", "serverless API", "event-driven architecture", "Lambda trigger" | | **aws-serverless-deployment** | "use SAM", "SAM template", "SAM init", "SAM deploy", "CDK serverless", "CDK Lambda construct", "NodejsFunction", "PythonFunction", "serverless CI/CD pipeline" | | **aws-lambda-durable-functions** | "lambda durable functions", "workflow orchestration", "state machines", "retry/checkpoint patterns", "long-running stateful Lambda", "saga pattern", "human-in-the-loop" | | **aws-lambda-managed-instances** | "Lambda Managed Instances", "LMI", "capacity provider", "multi-concurrency Lambda", "EC2-backed Lambda", "cold start elimination", "Graviton Lambda", "Lambda cost optimization with Reserved Instances" | ### MCP Servers | Server | Purpose | | ---------------------- | ------------------------------------------------------------------------------------ | | **aws-serverless-mcp** | Serverless development guidance, project scaffolding, IaC generation, and deployment | ### Hooks | Hook | Trigger | Action | | --------------------------- | --------------------------------------------- | --------------------------------------------- | | **SAM template validation** | After edits to `template.yaml`/`template.yml` | Runs `sam validate` and reports errors inline | ## codebase-documentor-for-aws Analyzes codebases to generate structured technical documentation with source-of-truth citations linking every finding back to the exact code that produced it. Uses an outline-driven pipeline to systematically analyze codebases of any size with a persistent task board for resumability. ### Agent Skill Triggers | Agent Skill | Triggers | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **document-service** | "analyze this codebase", "generate documentation", "document this service", "I inherited this code", "help me understand this system", "draw the architecture", "what does this system look like" | ### MCP Servers | Server | Purpose | | ---------------- | -------------------------------------------------------------------- | | **awsknowledge** | AWS service descriptions, architecture guidance, documentation links | | **awsiac** | CDK/CloudFormation resource schema validation and IaC best practices | ## databases-on-aws Database guidance for the AWS database portfolio. Design schemas, execute queries, handle migrations, build applications, and choose the right database for your workload. Currently includes Aurora DSQL — a serverless, PostgreSQL-compatible distributed SQL database. ### Agent Skill Triggers | Agent Skill | Triggers | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **dsql** | "Aurora DSQL", "DSQL schema", "distributed SQL database", "serverless PostgreSQL-compatible database", "create DSQL table", "migrate to DSQL" | ### MCP Servers | Server | Purpose | | ---------------- | -------------------------------------------------------------------------------- | | **awsknowledge** | AWS documentation, architecture guidance, and best practices | | **aurora-dsql** | Direct database operations — queries, schema, transactions (disabled by default) | ### Hooks | Hook | Trigger | Action | | ----------------------- | --------------------------- | -------------------------------------------------------- | | **Schema verification** | After `transact` operations | Prompts verification of schema changes and affected rows | ## deploy-on-aws Equips agents with the skills to accelerate AWS deployment - recommending AWS architectures and services, estimating costs, generating Infrastructure as Code (CDK or CloudFormation), and guiding you through deployment. ### Workflow 1. **Analyze** - Scan codebase for framework, database, dependencies 2. **Recommend** - Select AWS services with concise rationale 3. **Estimate** - Show cost estimates before proceeding 4. **Generate** - Write IaC code (CDK/CloudFormation) 5. **Deploy** - Execute with user confirmation ### Agent Skill Triggers | Agent Skill | Triggers | | ----------- | --------------------------------------------------------------------------------------------------------------------- | | **deploy** | "deploy to AWS", "host on AWS", "run this on AWS", "AWS architecture", "estimate AWS cost", "generate infrastructure" | ### MCP Servers | Server | Purpose | | ---------------- | ------------------------------------------------------------ | | **awsknowledge** | AWS documentation, architecture guidance, and best practices | | **awspricing** | Real-time AWS service pricing for cost estimates | | **aws-iac-mcp** | IaC best practices for CDK/CloudFormation | ## sagemaker-ai Build, train, and deploy AI models with deep AWS AI/ML expertise brought directly into your coding assistants, covering the surface area of [Amazon SageMaker AI](https://aws.amazon.com/sagemaker/ai/). [Learn more](https://github.com/awslabs/agent-plugins/blob/HEAD/plugins/sagemaker-ai/README.md). ## Requirements - Claude Code >=2.1.29 or [Cursor >= 2.5](https://cursor.com/changelog/2-5) - AWS CLI configured with appropriate credentials ## Troubleshooting Having issues with plugin installation or usage? See our [troubleshooting guide](https://github.com/awslabs/agent-plugins/blob/HEAD/docs/TROUBLESHOOTING.md) for common solutions. ## Contributing Big shout out to our awesome contributors! Thank you for making this project better! Contributions of all kinds are welcome! Check out our [contributor guide](https://github.com/awslabs/agent-plugins/blob/HEAD/CONTRIBUTING.md) for more information. ## Developer guide If you want to add a new plugin to the library, check out our [design guidelines](https://github.com/awslabs/agent-plugins/blob/HEAD/docs/DESIGN_GUIDELINES.md) and [development guide](https://github.com/awslabs/agent-plugins/blob/HEAD/docs/DEVELOPMENT_GUIDE.md). ## Maintainers Repository reviewers, maintainers, and admins can find PR review workflows, merge rules, and CI/CD documentation in the [maintainers guide](https://github.com/awslabs/agent-plugins/blob/HEAD/docs/MAINTAINERS_GUIDE.md). ## Administrators GitHub environment and AWS account configuration are documented in the [administrators guide](https://github.com/awslabs/agent-plugins/blob/HEAD/docs/ADMINISTRATORS_GUIDE.md). ## Additional Resources - [Introducing Agent Plugins for AWS Blog](https://aws.amazon.com/blogs/developer/introducing-agent-plugins-for-aws/) - [Extend Cursor with plugins ft. AWS](https://cursor.com/blog/marketplace) - [MCP Servers for AWS](https://github.com/awslabs/mcp) - [Claude Code plugins documentation](https://code.claude.com/docs/en/plugins) - [Cursor plugins documentation](https://cursor.com/docs/plugins) ## License This project is licensed under the Apache-2.0 License. DetailsTypePluginsTopicCloud & DevOpsPublisherawslabsSourcemarketplaceCategoryToolsStars932Copies (forks)168Proposed changes17Last update2026-10-15T14:35:41ZProject statusActiveLanguagePythonLicenseApache-2.0Added2026-08-30 01:48:58Updated2026-08-30 01:48:58Source idawslabs/agent-plugins/aws-serverlessMoreMore plugins on Cloud & DevOpsAll from awslabsA–Z index
