Yandex Cloud MCP Client

MCP stdio server for Yandex Cloud with automatic authentication.

Usage

npx @yandex-cloud/mcp [arguments]

Required Arguments

• -s, --server - Remote MCP server name (e.g., toolkit, search, functions)

See the list of available servers in the Yandex Cloud MCP GitHub repository.

Authentication Options

Choose one of the following authentication methods:

1. OAuth authentication (default, recommended) - No CLI installation required

   • Used automatically when no authentication flags are provided
   • Opens browser for OAuth authentication automatically
   • Works without Yandex Cloud CLI installed

2. OAuth authentication with explicit account selection

   • -S, --subject-id <ID> - Yandex Cloud user or service account ID
   • -u, --username <EMAIL> - Yandex account email (e.g., [email protected])
   • Use either --subject-id OR --username, not both

3. CLI authentication - Uses installed Yandex Cloud CLI

   • -p, --profile <PROFILE> - Yandex Cloud CLI profile name
   • Requires Yandex Cloud CLI to be installed
   • Used only when --profile is explicitly provided

4. No authentication

   • --no-auth - Disable authentication (use only if MCP server doesn't require it)

Additional Options

• -r, --region <REGION> - Yandex Cloud region: ru or kz (default: ru, used with OAuth authentication)
• -H, --header <Key:Value> - Add custom header to each MCP tool call (can be specified multiple times)

Examples

# Default OAuth authentication (recommended)
npx @yandex-cloud/mcp -s toolkit

# Default OAuth authentication with region
npx @yandex-cloud/mcp -s toolkit -r kz

# OAuth authentication with subject ID
npx @yandex-cloud/mcp -s toolkit -S your_user_id

# OAuth authentication with username
npx @yandex-cloud/mcp -s toolkit -u [email protected]

# CLI authentication with specific profile
npx @yandex-cloud/mcp -s functions -p testing

# No authentication
npx @yandex-cloud/mcp -s docs --no-auth

# Add custom headers
npx @yandex-cloud/mcp -s toolkit -H Folder-Id:your_folder_id

Prerequisites

• Node.js 18.0.0 or higher
• (Optional) Yandex Cloud CLI - required only for CLI authentication (when --profile is provided). Installation instructions: https://cloud.yandex.com/en/docs/cli/quickstart.

Supported Platforms

• Linux x64
• Linux ARM64
• macOS Intel (x64)
• macOS Apple Silicon (ARM64)
• Windows x64
• Windows ARM64

License

Apache-2.0

Links

• Yandex Cloud
• Yandex Cloud MCP GitHub repository
• Model Context Protocol