Skip to content

README.md

Latest commit

 

History

History
151 lines (118 loc) · 4.79 KB

README.md

File metadata and controls

151 lines (118 loc) · 4.79 KB
Raw

Yandex Cloud Serverless Triggers MCP Server (Preview)

The server is running in preview mode, some features may be unstable

MCP server for managing Yandex Cloud Serverless Triggers - create, configure, and manage event-driven triggers for functions and containers from various sources like timers, message queues, object storage, IoT, and more.

Table of Contents

Use Cases

Prompts examples:

  • List all serverless triggers in my folder
  • Create a timer trigger to run my function every hour
  • Set up a trigger for Object Storage events
  • Create a message queue trigger with batch processing
  • Resume paused trigger xyz

Installation and Usage

Configuration

To start working with Yandex Cloud Serverless Triggers MCP Server, you have to update your assistant's configuration (e.g. Cline, Roo Code or Claude Desktop) by adding yandex-cloud-triggers server.

There are two available ways:

1. NPM Client (recommended)

Provides authentication via OAuth (browser-based, default) or Yandex Cloud CLI (yc).

See the npm package documentation for more details.

Prerequisites:

  • Roles. Account to perform operations with this MCP Server must have the necessary roles (e.g., editor or functions.admin).
  • Node.js 18.0.0 or higher
  • (Optional) Yandex Cloud CLI (yc) - required only when using CLI authentication

Authentication Options:

  • OAuth (default, recommended): Run the package without authentication flags. Browser-based authentication is used automatically.
  • OAuth with explicit account selection: Use -S <user or service account ID> or -u <email>
  • CLI: Use -p <profile> to authenticate via Yandex Cloud CLI (requires CLI installation)

Configuration:

{
  "mcpServers": {
    "yandex-cloud-triggers": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "@yandex-cloud/mcp",
        "-s", "triggers",
        "-H", "Folder-Id:<Folder ID (optional)>"
      ]
    }
  }
}

2. Streamable HTTP

Prerequisites:

  • Roles. Account to perform operations with this MCP Server must have the necessary roles (e.g., editor or functions.admin).

  • IAM token. You can get it using Yandex Cloud CLI:

    • yc iam create-token for user account
    • yc iam create-token --impersonate-service-account-id <service-account-id> for service account

    The IAM token has a maximum lifespan of 12 hours. After expiration, it must be rotated.

Configuration:

{
  "mcpServers": {
    "yandex-cloud-triggers": {
      "type": "streamableHttp",
      "url": "https://triggers.mcp.cloud.yandex.net/mcp",
      "headers": {
        "Authorization": "Bearer <YC IAM Token>",
        "Folder-Id": "<Folder ID (optional)>"
      }
    }
  }
}

Headers

Header Description Requireness
Folder-Id Yandex Cloud folder as default value for MCP tool's input field folder_id Optional
Authorization Yandex Cloud IAM Token for Streamable HTTP authorization Required for Streamable HTTP

Tools

Yandex Cloud Serverless Triggers MCP Server currently consists of 8 tools listed below:

Tool Description
trigger_get Get Yandex Cloud Serverless Trigger
triggers_list List Yandex Cloud Serverless Triggers in the folder
trigger_create Create Yandex Cloud Serverless Trigger
trigger_update Update Yandex Cloud Serverless Trigger
trigger_delete Delete Yandex Cloud Serverless Trigger
trigger_pause Pause Yandex Cloud Serverless Trigger
trigger_resume Resume Yandex Cloud Serverless Trigger
trigger_operations_list List Yandex Cloud Serverless Trigger operations