Skip to main content
Chkk Upgrade Agent connects Chkk Upgrade Plans to your MCP-compatible AI coding agent (e.g., Cursor, Claude Code), turning approved plans into environment-aware diffs and precise edits to your IaC (Helm/Kustomize/Jsonnet/Terraform). The agent changes only what’s required, preserves your customizations, and produces a focused PR you can review, validate, and merge with confidence.
  • Cursor + Chkk
  • Claude Code + Chkk

​
Prerequisites

  1. Install Docker: Required to run the Chkk-Upgrade-Context-MCP Server.
  2. Install Cursor: Required to begin generating environment-aware pull requests.
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 and open it in Cursor:
git clone git@github.com:chkk-io/upgrade-playground.git && \
cd upgrade-playground && \
cursor .
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 Cursor via deeplink

Click the card below to install the Chkk Upgrade Context MCP Server in Cursor.

Add Chkk to Cursor

Click here to add Chkk to your Cursor
4

Configure your Chkk Access Token

Paste your Chkk Access Token in the CHKK_ACCESS_TOKEN environment variable in the MCP Tool Settings opened via the deeplink in the previous step.Tokens Tab
5

Verify Chkk Upgrade Context MCP Server is installed

Verify in MCP Tool Settings that Chkk Upgrade Context MCP Server is successfully installed and enabled. Tokens Tab
6

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
7

Load the Chkk Upgrade Agent

Paste and send the following Prompt in the Cursor chat:
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 agent to fetch “addon-upgrade-agent” from Chkk MCP.
Agent Response:Tokens Tab
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:Tokens Tab
9

Let the agent apply changes to your IaC

Cursor 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:Tokens Tab
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.
Learn more in the Upgrade Agent guide.

​
Need Help?

Email us at support@chkk.io for assistance.