veryfront__list_branchesAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug |
limit | integer | No | Page size 1-100. Omit limit and cursor for the complete collection; cursor alone defaults to 20. Minimum: 1. Maximum: 100. |
cursor | string | No | Opaque continuation bound to collection, project, branch, principal, filters and page size. Minimum length: 1. Maximum length: 4096. |
search | string | No | Case-insensitive partial branch-name match. |
status | string | No | Branch status filter; defaults to all. Default: "all". Values: "active", "merged", "closed", "all". |
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.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_branches",
"arguments": {}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
branches | object[] | Yes | List of branches associated with this record. |
page_info | object | No | Pagination cursor values for traversing the result set. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Page size 1-100. Omit limit and cursor for the complete collection; cursor alone defaults to 20."
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Opaque continuation bound to collection, project, branch, principal, filters and page size."
},
"search": {
"type": "string",
"description": "Case-insensitive partial branch-name match."
},
"status": {
"type": "string",
"enum": [
"active",
"merged",
"closed",
"all"
],
"description": "Branch status filter; defaults to all.",
"default": "all"
}
},
"additionalProperties": false,
"description": "Arguments for the list_branches tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"branches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"project_id": {
"type": "string",
"description": "Project identifier associated with the record."
},
"base_branch_id": {
"type": [
"string",
"null"
],
"description": "The base branch id associated with this record."
},
"created_at": {
"type": [
"string",
"null"
],
"description": "Creation timestamp in ISO 8601 format."
},
"created_by": {
"type": [
"string",
"null"
],
"description": "The created by associated with this record."
},
"merged_at": {
"type": [
"string",
"null"
],
"description": "The merged at associated with this record."
},
"merged_by": {
"type": [
"string",
"null"
],
"description": "The merged by associated with this record."
},
"version": {
"type": "number",
"description": "The version associated with this record."
},
"status": {
"type": "string",
"enum": [
"active",
"merged",
"closed"
],
"description": "Lifecycle status for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"auto_delete_on_merge": {
"type": "boolean",
"description": "The auto delete on merge associated with this record."
}
},
"required": [
"id",
"name",
"project_id",
"base_branch_id",
"created_at",
"created_by",
"merged_at",
"merged_by",
"version",
"status",
"description",
"auto_delete_on_merge"
],
"additionalProperties": false,
"description": "Structured branch schema for MCP tools."
},
"description": "List of branches associated with this record."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor used for this page."
},
"first": {
"type": "null",
"description": "Omit cursor to request the first page."
},
"next": {
"type": [
"string",
"null"
],
"description": "Next page cursor, or null on the last page."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Previous page cursor, or null on the first page."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
}
},
"required": [
"branches"
],
"additionalProperties": false,
"description": "Structured list branches output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}