Official, AWS-supported MCP servers, skills, and plugins to help AI agents build on AWS
$git clone https://github.com/aws/agent-toolkit-for-awsInstalls into the current project.
Install agent-toolkit-for-aws by running `git clone https://github.com/aws/agent-toolkit-for-aws`, then use it for the current task and follow its documentation at https://github.com/aws/agent-toolkit-for-aws.
| 1 | # Agent Toolkit for AWS |
| 2 | |
| 3 | [](LICENSE) |
| 4 | [](https://github.com/aws/agent-toolkit-for-aws/actions/workflows/build.yml) |
| 5 | [](https://github.com/aws/agent-toolkit-for-aws) |
| 6 | |
| 7 | Help AI coding agents build, deploy, and manage applications on AWS. |
| 8 | |
| 9 | The Agent Toolkit for AWS gives AI coding agents the tools, knowledge, and guardrails they need to work with AWS services. It works with the coding agents developers already use — including Claude Code, Codex, Cursor, and Kiro. |
| 10 | |
| 11 | ## Quick start |
| 12 | |
| 13 | ### AWS CLI |
| 14 | |
| 15 | Use the Agent Toolkit directly from your terminal with the AWS CLI: |
| 16 | |
| 17 | ``` |
| 18 | aws configure agent-toolkit |
| 19 | ``` |
| 20 | |
| 21 | See the [AWS CLI integration guide](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html) for setup, configuration, and usage instructions. |
| 22 | |
| 23 | ### Claude Code |
| 24 | |
| 25 | The plugins are available on the official Anthropic marketplace (`claude-plugins-official`) which is added to your Claude Code installation by default. |
| 26 | Use the following commands to install supported plugins from the toolkit: |
| 27 | |
| 28 | For `aws-core` that covers service selection, CDK/CloudFormation, serverless, containers, storage, observability, billing, SDK usage, and deployment: |
| 29 | |
| 30 | ``` |
| 31 | /plugin install aws-core@claude-plugins-official |
| 32 | ``` |
| 33 | |
| 34 | > **Tip:** If you get `Plugin not found`, update your local marketplace index first: |
| 35 | > |
| 36 | > ``` |
| 37 | > /plugin marketplace update claude-plugins-official |
| 38 | > ``` |
| 39 | |
| 40 | For `aws-agents` that covers building AI agents on AWS with Amazon Bedrock and AgentCore: |
| 41 | |
| 42 | ``` |
| 43 | /plugin install aws-agents@claude-plugins-official |
| 44 | ``` |
| 45 | |
| 46 | For `aws-data-analytics` that covers data lake, analytics, and ETL workflows with S3 Tables, AWS Glue, and Athena: |
| 47 | |
| 48 | ``` |
| 49 | /plugin install aws-data-analytics@claude-plugins-official |
| 50 | ``` |
| 51 | |
| 52 | For `aws-agents-for-devsecops` used to investigate incidents, review code and execute UAT for release readiness, scan code for vulnerabilities, and run penetration tests with AWS DevOps Agent and AWS Security Agent. |
| 53 | |
| 54 | ``` |
| 55 | /plugin marketplace add aws/agent-toolkit-for-aws |
| 56 | /plugin install aws-agents-for-devsecops |
| 57 | /reload-plugins |
| 58 | |
| 59 | # Or from Claude's official marketplace: |
| 60 | /plugin install aws-agents-for-devsecops@claude-plugins-official |
| 61 | /reload-plugins |
| 62 | |
| 63 | # Setup: |
| 64 | /aws-agents-for-devsecops:setup |
| 65 | ``` |
| 66 | |
| 67 | ### Codex |
| 68 | |
| 69 | In your terminal: |
| 70 | |
| 71 | ``` |
| 72 | codex plugin marketplace add aws/agent-toolkit-for-aws |
| 73 | ``` |
| 74 | |
| 75 | Then launch Codex and run `/plugins` to browse and install the **aws-core** plugin. |
| 76 | |
| 77 | ### Cursor |
| 78 | |
| 79 | Add this repository as a team marketplace from **Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo**, pointing it at `aws/agent-toolkit-for-aws`. Cursor indexes the plugins listed in [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json) on import. |
| 80 | |
| 81 | Then open the **Plugins** panel and install the **aws-core** plugin (start here), or **aws-agents** and **aws-data-analytics** as needed. Each plugin bundles the AWS MCP Server configuration and agent skills. |
| 82 | |
| 83 | ### Kiro |
| 84 | |
| 85 | Kiro setup has two independent parts: the AWS MCP Server (for runtime AWS API access and documentation search) and local skills (for task-specific agent guidance). They complement each other but work independently — skills don't require the MCP server, and the MCP server doesn't serve locally-installed skills. |
| 86 | |
| 87 | **1. Add the AWS MCP Server** to your Kiro MCP configuration (`.kiro/settings/mcp.json`): |
| 88 | |
| 89 | ```json |
| 90 | { |
| 91 | "mcpServers": { |
| 92 | "aws": { |
| 93 | "command": "uvx", |
| 94 | "args": [ |
| 95 | "mcp-proxy-for-aws@1.6.4", |
| 96 | "https://aws-mcp.us-east-1.api.aws/mcp", |
| 97 | "--metadata", |
| 98 | "AWS_REGION=us-west-2" |
| 99 | ] |
| 100 | } |
| 101 | } |
| 102 | } |
| 103 | ``` |
| 104 | |
| 105 | > **Note:** It is recommended to pin to a specific version (e.g., `@1.6.4`) to ensure reproducible behavior and protect against supply chain risks. We recommend regularly checking [PyPI](https://pypi.org/project/mcp-proxy-for-aws/) for new stable versions and updating accordingly. |
| 106 | |
| 107 | The MCP server gives your agent access to AWS APIs, sandboxed script execution, and real-time documentation search. |
| 108 | |
| 109 | **2. Install skills** from this repository: |
| 110 | |
| 111 | ``` |
| 112 | npx skills add aws/agent-toolkit-for-aws/skills |
| 113 | ``` |
| 114 | |
| 115 | This installs skill files to `~/.kiro/skills/` (global) or `.kiro/skills/` (project-level). Each skill is a directory containing a `SKILL.md` file and optionally a `references/` subdirectory with additional context the agent reads from the local filesystem when needed. Kiro discovers installed skills automatically and activates them on demand when a task matches. |
| 116 | |
| 117 | > **Prerequisites:** You need [uv](https://docs.astral.sh/uv/) installed. An AWS account with credentials configured locally is required for API calls and script execution, but not for documentation search or skill discovery. See the [user guide](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/) for detailed setup instructions. |
| 118 | |
| 119 | ### Other agents |
| 120 | |
| 121 | See t |