Create tool

veryfront__create_tool

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

FieldTypeRequiredDescription and constraints
project_referencestringNoProject ID or slug
idstringYesTool ID, a lowercase slug; it also names the tool source file. Minimum length: 1. Maximum length: 128.
descriptionstring or nullNoTool description. Null leaves it empty. On update, REST and GraphQL clear an omitted description and the MCP tool keeps the current one.
sourcestringNoComplete TypeScript source of the tool file. When set it is written as-is and description is ignored. Minimum length: 1.
source_target_kindstringNoThe source target kind associated with this record.
target_branch_idstring or nullNoThe target branch id associated with this record.

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_tool",
    "arguments": {
      "id": "example"
    }
  }
}

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 record.
namestringYesHuman-readable name for the record.
descriptionstring or nullYesHuman-readable description for the record.
source_pathstringYesThe source path associated with this record.
sourcestringYesThe source associated with this record.
edit_modestringYesThe edit mode associated with this record. Values: "structured", "source_only".
source_only_reasonsstring[]YesList of source only reasons associated with this record.

Full schemas

json
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "description": "Tool ID, a lowercase slug; it also names the tool source file."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tool description. Null leaves it empty. On update, REST and GraphQL clear an omitted description and the MCP tool keeps the current one."
    },
    "source": {
      "type": "string",
      "minLength": 1,
      "description": "Complete TypeScript source of the tool file. When set it is written as-is and description is ignored."
    },
    "source_target_kind": {
      "type": "string",
      "description": "The source target kind associated with this record."
    },
    "target_branch_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "description": "The target branch id associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the target branch id."
        }
      ],
      "description": "The target branch id associated with this record."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "description": "Structured create tool input schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the record."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Human-readable description for the record."
    },
    "source_path": {
      "type": "string",
      "description": "The source path associated with this record."
    },
    "source": {
      "type": "string",
      "description": "The source associated with this record."
    },
    "edit_mode": {
      "type": "string",
      "enum": [
        "structured",
        "source_only"
      ],
      "description": "The edit mode associated with this record."
    },
    "source_only_reasons": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One source only reason item associated with this record."
      },
      "description": "List of source only reasons associated with this record."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "source_path",
    "source",
    "edit_mode",
    "source_only_reasons"
  ],
  "additionalProperties": false,
  "description": "Structured tool source output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}