# AWS Step Functions Agent Setup Guide

These are instructions from AWS to set up AI agent integrations for building and deploying serverless workflows with AWS Step Functions. All commands are validated and ready to use.

---

## Install the AWS serverless skill

Use the correct section for your agent below.

### Claude Code

#### Install the aws-core plugin from Agent Toolkit for AWS

Run these commands to install the AWS serverless skill, agent hooks, and the AWS MCP Server configuration in one step.
```
claude plugin marketplace add aws/agent-toolkit-for-aws
claude plugin install aws-core@agent-toolkit-for-aws
```

### Install for other agents such as Cursor, Kiro CLI, GitHub Copilot, Codex, Windsurf, and OpenCode
```bash
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global
```
---

## AWS Serverless MCP Server

Register the Serverless MCP Server based on your agent. Replace `AWS_PROFILE` with your local AWS profile name.

### Kiro

Config file: `~/.kiro/settings/mcp.json`

Add under `"mcpServers"`:

```json
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": <your profile here>,
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false
}
```

### Claude Code

```bash
claude mcp add awslabs-aws-serverless-mcp \
  -e AWS_PROFILE=<your profile here> \
  -e AWS_REGION=us-east-1 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  --scope user \
  -- uvx awslabs.aws-serverless-mcp-server@latest
```

### Codex

```bash
codex mcp add awslabs-aws-serverless-mcp \
  --env AWS_PROFILE=<your profile here> \
  --env AWS_REGION=us-east-1 \
  --env FASTMCP_LOG_LEVEL=ERROR \
  -- uvx awslabs.aws-serverless-mcp-server@latest
```

### Cursor, GitHub Copilot, Windsurf, OpenCode, and all other agents

Add to your agent's MCP config file under `"mcpServers"`:

| Agent | Config file |
|-------|-------------|
| Cursor | `.cursor/mcp.json` |
| GitHub Copilot | `.vscode/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| OpenCode | `~/.config/opencode/opencode.jsonc` |

```json
"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": <your profile here>,
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}
```