> For the complete documentation index, see [llms.txt](https://docs.cloud.olakrutrim.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloud.olakrutrim.com/mcp/overview.md).

# Overview

Krutrim Cloud MCP brings Krutrim Cloud resource discovery and supported operations into your preferred AI client. It lets an assistant work from the same Cloud context you use, with your own credentials and the normal IAM and MFA controls.

![Krutrim Cloud MCP Overview](https://3930361567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcdalF6NcNO6DZa5TKbY%2Fuploads%2F5aLTPPKjstYzgMwjk2PP%2FUntitled%20design%20\(1\).png?alt=media\&token=e0b57145-7c81-452c-b87f-3501c39509dd)

### Why Krutrim Cloud MCP?

Use natural-language requests in your AI client while keeping the work grounded in Krutrim Cloud tools, regions, and your access permissions. MCP gives you one consistent way to connect clients such as Visual Studio Code, Claude Desktop, Cursor, and Codex—without building a separate integration for each.

### What you can do

* Discover available regions, VPCs, virtual machines, load balancers, and other supported Cloud resources.
* Run supported operations from the client you already use.
* Keep authentication and authorization with your Krutrim Cloud account, IAM credentials, and MFA verification.

### Initial setup

#### Prerequisites

* A Krutrim Cloud account.
* An access token and refresh token created in the same active session.
* An MCP-compatible client.
* Your target region, such as `In-Bangalore-1` or `In-Hyderabad-1`.

#### 1. Install the MCP server

You can run the server directly with `uvx`, or install it into a virtual environment.

PyPI package: <https://pypi.org/project/krutrim-mcp-server/>

Latest version: 1.0.2

```bash
uvx krutrim-mcp-server --help
```

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install krutrim-mcp-server
```

On Windows, activate the environment with:

```powershell
.venv\Scripts\Activate.ps1
```

#### 2. Authenticate

Use your root account only to sign in and create an IAM user. Use IAM credentials for MCP configuration and daily work.

{% code overflow="wrap" %}

```bash
curl --location 'https://cloud.olakrutrim.com/iam/v1/signInAsRootUser' --header 'Content-Type: application/json' --header 'Accept: application/json' --data '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'
```

{% endcode %}

For IAM sign-in:

{% code overflow="wrap" %}

```bash
curl --location 'https://cloud.olakrutrim.com/iam/v1/signInAsIAMUser' --header 'Content-Type: application/json' --header 'Accept: application/json' --data '{"accountId":"YOUR_ACCOUNT_ID","email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'
```

{% endcode %}

#### 3. Verify MFA

If MFA is enabled, verify it before using the resulting access and refresh tokens:

{% code overflow="wrap" %}

```bash
curl --location 'https://cloud.olakrutrim.com/iam/v1/mfa/verify' --header 'Content-Type: application/json' --header 'Accept: application/json' --data '{"mfaCode":"YOUR_MFA_CODE"}'
```

{% endcode %}

#### 4. Configure an MCP client

Use the dedicated guide for Visual Studio Code, Claude Desktop, Cursor, or Codex for the exact client configuration. Restart the client after changing its configuration.

A typical stdio configuration looks like this:

```json
{
  "mcpServers": {
    "krutrim-cloud": {
      "command": "uvx",
      "args": ["krutrim-mcp-server"],
      "env": {
        "KRUTRIM_ACCESS_TOKEN": "YOUR_IAM_ACCESS_TOKEN",
        "KRUTRIM_REFRESH_TOKEN": "YOUR_IAM_REFRESH_TOKEN"
      }
    }
  }
}
```

#### 5. Verify the installation

```bash
uvx krutrim-mcp-server --list-tools
uvx krutrim-mcp-server --doctor
```

`--list-tools` shows the installed tool catalog and `--doctor` checks local configuration. Then make a read-only Cloud request, such as `List my VPCs in In-Bangalore-1.`, to verify permissions.

### Next steps

Client setup guides:

[Connect VS Code](/mcp/connect-vs-code.md)

[Connect Claude Desktop](/mcp/connect-claude-desktop.md)

[Connect Cursor](/mcp/connect-cursor.md)

[Connect Codex](/mcp/connect-codex.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cloud.olakrutrim.com/mcp/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.