veryfront__list_promptsAccess
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 |
source_target_kind | string | No | Source to read prompts from: project, main_branch, environment or preview_branch. Falls back to runtime_target_kind when omitted. Values: "project", "main_branch", "environment", "preview_branch". |
runtime_target_kind | string or null | No | Runtime target to read from when source_target_kind is omitted: main_branch, environment or preview_branch. |
target_environment_id | string or null | No | Environment to use. Required for the environment target; rejected for any other target. |
target_branch_id | string or null | No | Preview branch to use. Required for the preview_branch target; rejected for any other target. |
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_prompts",
"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 |
|---|---|---|---|
data | object[] | Yes | Primary result records returned by the tool. |
page_info | object | Yes | Pagination cursor values for traversing the result set. |
diagnostics | object[] | No | Prompt source files that could not be read. REST omits it when there are none. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug"
},
"source_target_kind": {
"type": "string",
"enum": [
"project",
"main_branch",
"environment",
"preview_branch"
],
"description": "Source to read prompts from: project, main_branch, environment or preview_branch. Falls back to runtime_target_kind when omitted."
},
"runtime_target_kind": {
"anyOf": [
{
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "Provide the runtime target kind."
},
{
"type": "null",
"description": "Provide the runtime target kind."
}
],
"description": "Runtime target to read from when source_target_kind is omitted: main_branch, environment or preview_branch."
},
"target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target environment id."
},
{
"type": "null",
"description": "Provide the target environment id."
}
],
"description": "Environment to use. Required for the environment target; rejected for any other target."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Preview branch to use. Required for the preview_branch target; rejected for any other target."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the list_prompts tool."
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the returned record."
},
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description returned by the tool."
},
"source_path": {
"type": "string"
},
"edit_mode": {
"type": "string",
"enum": [
"structured",
"source_only"
]
}
},
"required": [
"id",
"name",
"description",
"source_path",
"edit_mode"
],
"additionalProperties": false
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "null"
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page when pagination is available."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
},
"diagnostics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"source_file_diagnostic",
"source_agent_discovery_error",
"source_trigger_discovery_error"
]
},
"source_kind": {
"type": "string",
"enum": [
"agent",
"prompt",
"tool",
"task",
"workflow",
"resource",
"skill",
"eval",
"schedule",
"webhook"
]
},
"source_path": {
"type": "string",
"minLength": 1
},
"source_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null",
"description": "The source id returned by the tool."
}
]
},
"code": {
"type": "string",
"enum": [
"parse_error",
"invalid_definition",
"dynamic_definition",
"duplicate_source_id",
"unsupported_target",
"manual_conflict"
]
},
"message": {
"type": "string",
"minLength": 1
},
"details": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Structured details details associated with this tool result."
},
{
"type": "null",
"description": "The details returned by the tool."
}
]
}
},
"required": [
"kind",
"source_kind",
"source_path",
"code",
"message"
],
"additionalProperties": false
},
"description": "Prompt source files that could not be read. REST omits it when there are none."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Structured result returned by the list_prompts tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}