> 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

Connect with Hosted MCP first, or run the local stdio package with your Krutrim Cloud API key.

Connect your AI agent to Krutrim Cloud tools for resource discovery and supported operations. Start with Hosted MCP over HTTPS, or run the package locally over stdio when you need a client-managed server. Both use your Krutrim Cloud API key and permissions.

![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)

## Choose how to connect

| Connection                                   | When to use it                                                                                                                        |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| [Hosted MCP](/mcp/hosted-mcp.md)             | Start here for a remote connection. Use `https://mcp.olakrutrim.com/mcp` and an API-key Bearer header; no local package installation. |
| [Local MCP (stdio)](/mcp/local-mcp-stdio.md) | Run the Python package on your machine. Your client starts the server and passes the API key through its environment.                 |

## 1. Hosted MCP

Connect using Streamable HTTP. The hosted guide covers the shared API-key setup and verification, with client examples for Cursor, VS Code, Claude Code, and Codex.

Start here: [Set up Hosted MCP](/mcp/hosted-mcp.md)

## 2. Local MCP (stdio)

Use this path for a local command-based connection. Install or run `krutrim-mcp-server`, then configure Claude Desktop, Codex, Cursor, VS Code, Hermes, or OpenCode.

Package setup and client guides: [Local MCP (stdio)](/mcp/local-mcp-stdio.md)

## 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.
* Authenticate with your Krutrim Cloud API key and keep operations within your access permissions.

Available tools depend on the hosted deployment or installed package version. Inspect your connected client’s tool catalog before choosing an operation.

## Use Cloud tools safely

List resources first, select exact identifiers and a supported region (`In-Bangalore-1` or `In-Hyderabad-1`), then review the proposed change.

Review the proposed tool call and provide confirmation parameters only after approving the change. Hosted read-only mode is reported by `krutrim_ping` and controlled by the deployment.

For local stdio, mutations require `confirm=true`; floating-IP allocation also requires `allow_public_ip=true`. Set `KRUTRIM_MCP_READ_ONLY=true` in the local server environment to block mutations.

{% hint style="warning" %}
Note: After a create timeout, check whether the resource exists before retrying.
{% endhint %}

## Need help?

Connection or tool errors? See [Troubleshooting](/mcp/troubleshooting.md).