Creating an MCP server in MCP Hub from scratch

In the management console, select the folder for which your account has the serverless.mcpGateways.editor and iam.serviceAccounts.user roles or higher.

Go to AI Studio.

In the left-hand panel, select MCP servers and click Create MCP server. In the window that opens:

1. Under Add method, select Create.

2. Under Tools, select the type of the tool you want to add to the MCP server: HTTPS query, Cloud Functions, or Workflows:

   HTTPS request

   Cloud Functions

   Workflows

   1. In the Tool name field, enter a name for the new tool. Follow these naming requirements:

      • It must be from 2 to 63 characters long.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

   2. In the Instructions for agent field, enter the required text description for the tool. This description must define conditions for the AI agent to use this tool. Here is an example:

      A tool for creating tickets in a corporate task processing system. Use this 
      tool to log customer complaints, support requests, and 
      error reports. When using this tool, set the `queue`, `type`, `priority`, and `summary` parameters. 
      In the `queue` parameter (queue name), always provide the SUPPORT constant. In the `type` parameter (request 
      type), provide one of the following values: bug (error report), complaint (customer complaint) or 
      support-request (request for consultation). In the `priority` parameter, 
      provide one of these values: low, medium, or high. In the 
      `summary` parameter, provide a text describing the gist of the user request in their own words.
      

   3. In the URL field, specify the endpoint for the HTTPS request.

      • You can use jq templates to add path parameters to the endpoint value. Here is an example:

        https://console.yandex.cloud/folders/\(.folder-id)
        

        In this example, the folder-id field must also be added to the Tool parameters section of the MCP server settings.

      • To send query parameters of the endpoint request:

        • Add relevantly named fields to the Tool parameters section of the new MCP server settings, e.g., country, city, and name.
        • Add relevant query parameters to the HTTPS method parameters section of the new MCP server settings. Specify jq templates with the names of the fields mentioned above as values for the new query parameters, e.g., \(.country), \(.city), and \(.name).

   4. In the Method field, select the HTTP request method: GET, POST, DELETE, PATCH, OPTIONS, or HEAD.

   5. Expand the Additional parameters section and specify the authentication data to provide in HTTPS requests:

      • Service account: To provide the IAM token issued for the service account attached to the MCP server.
      • Access token: To provide the specified access token.
      • Without authorization: To skip authentication.

   6. Under Tool parameters, specify the names, types, and text descriptions of the parameters the tool will use.

      You can add the parameters you need on the layout-header-cells-large Form tab one by one by clicking Add, or on the JSON schema tab, as a JSON structure.

      JSON schema:

      {
        properties?: { [key: string]: object };
        required?: string[];
        type: "object";
      }
      

      JSON struture example

      {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "City name or zip code"
          }
        },
        "required": ["location"]
      }
      

   7. Under HTTPS method parameters, configure the HTTPS request parameters:

      • Under Request headers, specify the names and values ​​of the headers to provide in requests.

      • Under Query parameters, specify the names and values ​​of the parameters to provide in the request.

      • Under Request body, review an example of the request and modify it as needed.

        By default, an empty request body is generated with a flat JSON object consisting of pairs of tool parameters and their values. For example:

        {
          "parameter-a": <parameter-a_value>,
          "parameter-b": <parameter-b_value>,
          "parameter-c": <parameter-c_value>
        }
        

      All HTTPS request parameters support templating: their values can be generated dynamically in the jq language. For more information, see the jq guide.

      For example, the \(.city) value of the HTTPS request parameter will be taken from the city tool parameter. In addition, you can use the syntax Bearer \(.token) for the Authorization header to set up authorization via a token provided in the tool parameter.

   1. In the Tool name field, enter a name for the new tool. Follow these naming requirements:

      • It must be from 2 to 63 characters long.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

   2. In the Instructions for agent field, enter the required text description for the tool. This description must define conditions for the AI agent to use this tool. Here is an example:

      This tool recognizes text in an image transmitted in base64 encoding. In the recognized 
      text, the tool extracts "article":"quantity" pairs and returns them in JSON structure format.
      

   3. In the Function field, select the Cloud Functions function to process the requests and its version.

   4. Under Tool parameters, specify the names, types, and text descriptions of the parameters the tool will use.

      You can add the parameters you need on the layout-header-cells-large Form tab one by one by clicking Add, or on the JSON schema tab, as a JSON structure.

      JSON schema:

      {
        properties?: { [key: string]: object };
        required?: string[];
        type: "object";
      }
      

      JSON struture example

      {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "City name or zip code"
          }
        },
        "required": ["location"]
      }
      

   By default, an empty request body is generated with a flat JSON object consisting of pairs of tool parameters and their values. For example:

   {
     "parameter-a": <parameter-a_value>,
     "parameter-b": <parameter-b_value>,
     "parameter-c": <parameter-c_value>
   }
   

   1. In the Tool name field, enter a name for the new tool. Follow these naming requirements:

      • It must be from 2 to 63 characters long.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

   2. In the Instructions for agent field, enter the required text description for the tool. This description must define conditions for the AI agent to use this tool. Here is an example:

      This tool invokes a workflow to automatically summarize long text. Provides 
      the source text, maximum summation length, and language.
      

   3. In the Workflow field, select the Workflows workflow to process the requests.

   4. Under Tool parameters, specify the names, types, and text descriptions of the parameters the tool will use.

      You can add the parameters you need on the layout-header-cells-large Form tab one by one by clicking Add, or on the JSON schema tab, as a JSON structure.

      JSON schema:

      {
        properties?: { [key: string]: object };
        required?: string[];
        type: "object";
      }
      

      JSON struture example

      {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "City name or zip code"
          }
        },
        "required": ["location"]
      }
      

   By default, an empty request body is generated with a flat JSON object consisting of pairs of tool parameters and their values. For example:

   {
     "parameter-a": <parameter-a_value>,
     "parameter-b": <parameter-b_value>,
     "parameter-c": <parameter-c_value>
   }
   

3. To add an additional tool to the MCP server, click Add tool.

   Note

   One MCP server can contain up to 50 tools.

4. Under Server parameters:

   1. In the Name field, enter a name for the new MCP server. Follow these naming requirements:

      • It must be from 2 to 63 characters long.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

   2. Optionally, add a description and labels for the server you are creating by using the corresponding buttons.

   3. In the Access field, select the type of your new server:

      • Private: To build a private MCP server with the authentication-based access.
      • Public: To build a public MCP server that requires no authentication.

   4. In the Service account field, select the service account your MCP server will use to access Yandex Cloud services and resources. The service account should get the roles sufficient to access these resources and services.

   5. Optionally, enable Select network to specify a cloud network to host your MCP server instances.

   6. Optionally, turn on the Enable logging option and configure the logging settings to keep a log of the MCP server you are creating.

5. Click Save.