Agent setup guide

AI coding agents can accelerate serverless development by providing intelligent assistance for application scaffolding, deployment configuration, debugging, and infrastructure-as-code generation. By configuring your agent with the right combination of plugins, skills, and MCP Servers, you equip it with expertise required to build and manage serverless applications.

Work with your coding agent

For a quick-start reference, you can drop this link directly into your agent's context:

https://docs.aws.amazon.com/lambda/latest/dg/samples/aws-lambda-agent-setup.md

Choose the installation method that matches your development environment.

Prerequisites

Ensure the following prerequisites are in place for installing aws-core plugin and Serverless MCP Server:

• uv installed on your system.

• (Optional) An AWS account with IAM credentials set up on your local machine. Credentials are required for tools that execute AWS API calls and run scripts, but not for searching documentation or discovering skills. If you do not have credentials configured, see Setting up the AWS MCP Server for detailed instructions.

Claude Code

Install the aws-core plugin, part of the Agent Toolkit for AWS, that bundles the AWS MCP Server configuration and a curated set of agent skills (including the AWS serverless skill).

Install aws-core plugin from Agent Toolkit for AWS

Run the following command to install the plugin:

/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws

This installs agent skills including the AWS serverless skill, agent hooks, and the AWS MCP Server configuration in one step.

Install Serverless MCP Server

Replace AWS_PROFILE with your local AWS profile name.

claude mcp add awslabs-aws-serverless-mcp \
  -e AWS_PROFILE=default \
  -e AWS_REGION=us-east-1 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  --scope user \
  -- uvx awslabs.aws-serverless-mcp-server@latest

Codex

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Replace AWS_PROFILE with your local AWS profile name.

codex mcp add awslabs-aws-serverless-mcp \
  --env AWS_PROFILE=default \
  --env AWS_REGION=us-east-1 \
  --env FASTMCP_LOG_LEVEL=ERROR \
  -- uvx awslabs.aws-serverless-mcp-server@latest

Cursor

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the following to .cursor/mcp.json under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Kiro

Install AWS serverless skill in Kiro CLI

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the following to ~/.kiro/settings/mcp.json under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false
}

Install Kiro powers (from Kiro IDE)

Install the following Kiro powers that provide specialized contexts and tools to the Kiro agents on-demand:

• Serverless Application Model (SAM) — install via Kiro powers link.

• Lambda Managed Instances — install via Kiro powers link.

• Lambda Durable Functions — install via Kiro powers link.

GitHub Copilot

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the following to .vscode/mcp.json under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

Windsurf

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the following to /.codeium/windsurf/mcp_config.json under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

OpenCode

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the following to /.config/opencode/opencode.jsonc under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

"awslabs.aws-serverless-mcp": {
  "command": "uvx",
  "args": ["awslabs.aws-serverless-mcp-server@latest"],
  "env": {
    "AWS_PROFILE": "default",
    "AWS_REGION": "us-east-1",
    "FASTMCP_LOG_LEVEL": "ERROR"
  }
}

For all other agents compatible with agent skills and MCP Server configuration

For any other agent that supports the open-source agent skills format and MCP Server configuration, follow these steps:

Install AWS serverless skill

npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-serverless --yes --global

Install Serverless MCP Server

Add the Serverless MCP Server to your agent's MCP client configuration file under "mcpServers". Replace AWS_PROFILE with your local AWS profile name.

{
  "mcpServers": {
    "awslabs.aws-serverless-mcp": {
      "command": "uvx",
      "args": ["awslabs.aws-serverless-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}