veryfront__create_agent_label
Requires project.agents.write.
Access
No external-service connection is required. Use a Veryfront credential with access to the requested resources.
Call type: Can change resources.
Arguments
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.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__create_agent_label",
"arguments": {
"agent_id": "example",
"key": "example"
}
}
}Result
The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.
Full schemas
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"minLength": 1,
"description": "Provide the agent id."
},
"source_target_kind": {
"anyOf": [
{
"type": "string",
"enum": [
"project",
"main_branch",
"preview_branch"
],
"description": "Provide the source target kind."
},
{
"type": "null",
"description": "Provide the source target kind."
}
],
"description": "Source target: project, main_branch, or preview_branch. Null and omission select project."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Provide the target branch id."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Required label key. Trimmed and lowercased; starts with a letter or number and allows letters, numbers, dot, underscore and dash."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"description": "Provide the value."
},
{
"type": "null",
"description": "Provide the value."
}
],
"description": "Label value. Trimmed; a supplied blank value is invalid. Omit or use null for a key-only label, including on replacement."
},
"color": {
"anyOf": [
{
"type": "string",
"maxLength": 32,
"description": "Provide the color."
},
{
"type": "null",
"description": "Provide the color."
}
],
"description": "Display color. Omit, use null or supply a blank string to clear it, including on replacement."
},
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Project identifier or slug that scopes the tool call."
}
},
"required": [
"agent_id",
"key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the create_agent_label tool."
}{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Label UUID."
},
"resource_kind": {
"type": "string",
"enum": [
"project",
"project_agent"
],
"description": "Resource to which the label is assigned."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project UUID containing the labeled resource."
},
"source_target_kind": {
"type": [
"string",
"null"
],
"description": "The source target kind returned by the tool."
},
"source_agent_id": {
"type": [
"string",
"null"
],
"description": "The source agent id returned by the tool."
},
"namespace": {
"type": "string",
"description": "Normalized label namespace. API-created labels use user."
},
"key": {
"type": "string",
"description": "Normalized lowercase label key."
},
"value": {
"type": [
"string",
"null"
],
"description": "Trimmed label value, or null for a key-only label."
},
"color": {
"type": [
"string",
"null"
],
"description": "Trimmed display color, or null when unset."
},
"created_at": {
"type": "string",
"description": "Creation time as an ISO 8601 timestamp."
},
"updated_at": {
"type": "string",
"description": "Last update time as an ISO 8601 timestamp."
}
},
"required": [
"id",
"resource_kind",
"project_id",
"namespace",
"key",
"value",
"created_at",
"updated_at"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the create_agent_label tool."
}