Create project

veryfront__create_project

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
namestringYesProject name Minimum length: 1.
descriptionstringNoProject description
template_project_idstringNoProject UUID to copy as a template Format: uuid.
slugstringNoProject slug (URL-friendly identifier). If omitted, the API generates one from the project name. Minimum length: 1.
template_slugstringNoTemplate slug to use (e.g., "minimal", "chat"). Identifies the template to start from. Omit it (or pass "blank") to create an empty project with no files.

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_project",
    "arguments": {
      "name": "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 returned record.
namestringYesHuman-readable name for the returned record.
slugstringYes
descriptionstringNoHuman-readable description returned by the tool.
configobjectNo
typestringNoValues: "regular", "default", "template".
system_managedbooleanNo

Full schemas

json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Project name"
    },
    "description": {
      "type": "string",
      "description": "Project description"
    },
    "template_project_id": {
      "type": "string",
      "format": "uuid",
      "description": "Project UUID to copy as a template"
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
      "description": "Project slug (URL-friendly identifier). If omitted, the API generates one from the project name."
    },
    "template_slug": {
      "type": "string",
      "description": "Template slug to use (e.g., \"minimal\", \"chat\"). Identifies the template to start from. Omit it (or pass \"blank\") to create an empty project with no files."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "description": "Requires an authenticated user identity; project-scoped tokens cannot create projects.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the returned record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the returned record."
    },
    "slug": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "Human-readable description returned by the tool."
    },
    "config": {
      "type": "object",
      "properties": {
        "disable_meta_robots": {
          "type": "boolean",
          "description": "When true, the rendered site asks crawlers not to index it (noindex robots meta tag)."
        },
        "provider_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identifier of the provider backing the project, or null when none is configured. Not necessarily a UUID."
        },
        "layout_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identifier of the layout applied to the project, or null when none is configured."
        },
        "is_template": {
          "type": "boolean",
          "description": "Whether the project is offered in the template gallery."
        },
        "coming_soon": {
          "type": "boolean",
          "description": "Whether the template is listed as coming soon in the gallery."
        },
        "category": {
          "type": [
            "string",
            "null"
          ],
          "description": "Template gallery category, or null when uncategorised."
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "Template gallery description, or null when none is set."
        },
        "disableMetaRobots": {
          "type": "boolean",
          "description": "Legacy camelCase spelling of `disable_meta_robots`; carries the same value. Prefer `disable_meta_robots`."
        },
        "providerId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Legacy camelCase spelling of `provider_id`; carries the same value. Prefer `provider_id`."
        },
        "layoutId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Legacy camelCase spelling of `layout_id`; carries the same value. Prefer `layout_id`."
        },
        "isTemplate": {
          "type": "boolean",
          "description": "Legacy camelCase spelling of `is_template`; carries the same value. Prefer `is_template`."
        },
        "comingSoon": {
          "type": "boolean",
          "description": "Legacy camelCase spelling of `coming_soon`; carries the same value. Prefer `coming_soon`."
        }
      },
      "additionalProperties": false
    },
    "type": {
      "type": "string",
      "enum": [
        "regular",
        "default",
        "template"
      ]
    },
    "system_managed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "name",
    "slug"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the create_project tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}