Link environment to server

veryfront__create_server_environment_link

Requires project.runtime.manage.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
server_idstringYesID of a server you own. Linking and unlinking require project.runtime.manage on every project currently linked to the server. If none are linked, no project capability is required. Linking also requires project.runtime.manage on the environment’s project. Unlinking also requires API-key delete scope. Format: uuid.
environment_idstringYesProvide the environment id. Format: uuid.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__create_server_environment_link",
    "arguments": {
      "server_id": "00000000-0000-4000-8000-000000000000",
      "environment_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
idstringYesUnique identifier for the returned record. Format: uuid.
short_idstringYesThe short id returned by the tool.
user_idstringYesThe user id returned by the tool. Format: uuid.
environment_idsstring[]YesList of environment ids returned by the tool.
hostnamestringYesThe hostname returned by the tool.
statusstringYesLifecycle status for the returned record. Values: "pending", "provisioning", "running", "error", "deleting".
created_atstringYesCreation timestamp in ISO 8601 format.
updated_atstringYesLast update timestamp in ISO 8601 format.

Full schemas

json
{
  "type": "object",
  "properties": {
    "server_id": {
      "type": "string",
      "format": "uuid",
      "description": "ID of a server you own. Linking and unlinking require project.runtime.manage on every project currently linked to the server. If none are linked, no project capability is required. Linking also requires project.runtime.manage on the environment’s project. Unlinking also requires API-key delete scope."
    },
    "environment_id": {
      "type": "string",
      "format": "uuid",
      "description": "Provide the environment id."
    }
  },
  "required": [
    "server_id",
    "environment_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the create_server_environment_link tool."
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for the returned record."
    },
    "short_id": {
      "type": "string",
      "description": "The short id returned by the tool."
    },
    "user_id": {
      "type": "string",
      "format": "uuid",
      "description": "The user id returned by the tool."
    },
    "environment_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "description": "One environment id item returned by the tool."
      },
      "description": "List of environment ids returned by the tool."
    },
    "hostname": {
      "type": "string",
      "description": "The hostname returned by the tool."
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "provisioning",
        "running",
        "error",
        "deleting"
      ],
      "description": "Lifecycle status for the returned record."
    },
    "created_at": {
      "type": "string",
      "description": "Creation timestamp in ISO 8601 format."
    },
    "updated_at": {
      "type": "string",
      "description": "Last update timestamp in ISO 8601 format."
    }
  },
  "required": [
    "id",
    "short_id",
    "user_id",
    "environment_ids",
    "hostname",
    "status",
    "created_at",
    "updated_at"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Structured result returned by the create_server_environment_link tool."
}