Nebius

You are using the Nebius MCP Server to let AI agents fetch Nebius service documentation and execute Nebius CLI commands through the Model Context Protocol. This enables hands-on access to Nebius capabilities directly from your MCP-enabled tools, while providing safety controls to prevent risky actions.

How to use

You interact with the Nebius MCP Server through an MCP client that supports stdio or http connections. Use it to: retrieve up-to-date Nebius service documentation, inspect available services, get detailed help for Nebius CLI commands, and execute Nebius CLI commands when you need practical results. The server is designed to be cautious by default, with safety modes that restrict potentially dangerous operations. Always review suggested commands before running them.

Typical usage patterns include: - Asking for documentation about a specific Nebius service to understand available commands and features. - Requesting a list of resources (such as storage buckets or compute platforms) within a Nebius project. - Generating and executing Nebius CLI commands for a given service, then returning the command results. Remember to verify any command that could modify resources before execution.

How to install

Prerequisites you need on your machine: - Python version 3.13 or newer with the uv package manager installed. - Nebius CLI version 0.12.65 or newer installed locally with at least one profile configured. On macOS, it is recommended to install uv via Homebrew: brew install uv.

Step-by-step setup flow to configure the Nebius MCP Server client: - Update Nebius CLI to the latest version: nebius update - Configure your MCP-compatible client using the following command: uvx --refresh-package nebius-mcp-server "nebius-mcp-server@git+https://github.com/nebius/mcp-server@main"

Additional configuration and notes

Safety and access controls: Nebius MCP Server forbids execution of any commands that accept tokens or access keys as arguments or return them as results. By default, it also disables commands that can perform updates or deletions or other potentially destructive changes. The SAFE_MODE environment variable can be used to override this behavior, but changing defaults is not recommended.

Using client-specific configuration examples: The Nebius MCP Server can be wired into clients like Claude Desktop and VSCode Copilot. The following configuration snippet demonstrates how to register the MCP server in Claude Desktop so you can access its tools from the Claude interface.

{
  "mcpServers": {
    "Nebius MCP Server": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "nebius-mcp-server",
        "nebius-mcp-server@git+https://github.com/nebius/mcp-server@main"
      ],
      "env": {}
    }
  }
}

Available tools

nebius_profiles

Fetches information about configured Nebius CLI profiles, including available credentials and their scopes.

nebius_available_services

Returns a list of Nebius services that are available in the current context, including service names and short descriptions.

nebius_cli_help

Shows detailed help for Nebius CLI commands for a specified service, including usage, flags, and examples.

nebius_cli_execute

Generates and executes Nebius CLI commands for a given service and returns the command output.