​
Prerequisites

  1. Install Docker: Required to run the Chkk-Upgrade-Context-MCP Server.
  2. Install Claude Code: Required to begin generating environment-aware pull requests.
  3. A Claude.ai (recommended) or Anthropic Console account
Agent Responses on this page are illustrative. Exact phrasing from your AI model may vary depending on the model, settings, and repository context.
For the best experience, it is recommended to use the claude-4-sonnet model with the Chkk-Upgrade-Context-MCP Server.
1

Clone the Sample Chkk IaC repo

Run the following command to clone the sample Chkk IaC repo:
git clone git@github.com:chkk-io/upgrade-playground.git && \
cd upgrade-playground
2

Retrieve your Chkk Access Token

  1. In the Chkk Dashboard, expand Configure on the left menu and click Settings.
  2. Select the Tokens tab. Here you’ll see a list of all your active tokens (if any), along with options to create new ones or revoke existing ones.
  3. Click on the clipboard icon next to a token to copy it. Tokens Tab
3

Install in Claude Code

Install the Chkk-Upgrade-Context-MCP using the Claude Code CLI:
claude mcp add Chkk-Upgrade-Context-MCP --env CHKK_ACCESS_TOKEN="<CHKK_TOKEN>"  -- docker run -i --rm -e CHKK_ACCESS_TOKEN public.ecr.aws/chkk/chkk-mcp-upgrade-context:latest
Replace <CHKK_TOKEN> with your Chkk Access Token.
4

Verify Chkk-Upgrade-Context-MCP Server is installed

Verify via CLI that the server is registered:
claude mcp get Chkk-Upgrade-Context-MCP
The command should return server details indicating it is installed and enabled.Claude Code Chkk MCP Server
5

Retrieve the Upgrade ID

  1. In the left-hand column of the Chkk Dashboard, expand Upgrade Copilot.
  2. Under Upgrade Plans select Add-on & App Services. Navigate to Add-on & Application Service Upgrade Plans
  3. On the Middle Right corner of the page, enable the Show Example Data toggle, as shown in the image below.
  4. This will switch the view to only show example data and displays a confirmation banner. Enable Example Data
  5. In the table below, you will see a list of Add-on and Application Service Example Upgrade Plans.
  6. Select any Upgrade Plan from the table that has the AI Context Generated badge, as shown in the image below.
The AI Context Generated badge indicates that these Upgrade Plans are supported by the Chkk-Upgrade-Context-MCP Server.
Example Add-on & Application Service Upgrade Plan with AI Context Generated Badge
  1. At the top of the page, under the name of the Upgrade Plan, you will see the Upgrade ID.
  2. Click the clipboard icon to copy the Upgrade ID to your clipboard. Upgrade ID
6

Open the project in Claude Code

From inside the upgrade-playground directory, start Claude Code.
claude
Open Claude Code
7

Load the Chkk Upgrade Agent

Open a chat in Claude Code and send:
You’re in a K8s repo. Fetch “addon-upgrade-agent” from Chkk MCP and upgrade the package listed in the upgrade plan. Start by asking for the upgrade ID.
Your opening prompt is flexible, but it must explicitly instruct the assistant to fetch “addon-upgrade-agent” from Chkk MCP.
Agent Response:Claude Code Chkk MCP Server start
8

Provide the upgrade ID of the Example Upgrade Plan

Paste your upgrade ID (from your instantiated Add-on or Application Service Upgrade Plan), for example:
upgr_ea53db65-3d8d-4744-b8b7-92e3c7552932
Agent Response:Claude Code Chkk MCP Server upgrade
9

Let the assistant apply changes to your IaC

The assistant will fetch Upgrade Context, stage artifacts in a local Scratchpad (.chkk/scratchpad/upgrade-agent/ in the current working directory), apply targeted edits (Chart.yaml, values.yaml, minimal templates), and summarize the changes it has made.Agent Response:Claude Code Apply Changes
To ensure your model is not overwhelmed by the task scope, any modifications are processed in batches of 5 files at a time.
10

Review the changes

You can now review the changes made within each file, which you would have otherwise would have had to do manually.Agent Response:Claude Code Review Changes
Learn more in the Upgrade Agent guide.

​
Next steps

  • Add your own upgrade plans in Chkk and repeat the flow
  • Enable auto-confirm in trusted repos for zero-click edits