veryfront__list_agent_templatesAccess
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 |
|---|---|---|---|
cursor | string | No | Opaque pagination cursor returned by a previous response. |
limit | integer | No | Maximum number of results to return. Default: 50. Minimum: 1. Maximum: 100. |
search | string | No | Provide the search. Minimum length: 1. Maximum length: 200. |
category | string | No | Provide the category. Minimum length: 1. |
kind | string | No | Provide the kind. Values: "template_agent", "installable_agent". |
origin | string | No | Provide the origin. Values: "veryfront", "user". |
sort_by | string | No | Provide the sort by. Values: "name", "agent_id", "category_label". |
sort_order | string | No | Provide the sort order. Values: "asc", "desc". |
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_agent_templates",
"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 | Unified catalog: agents from configured template projects and approved installable registry entries. Template agents expose the fork action; installable agents expose the install action. |
page_info | object | Yes | Pagination cursor values for traversing the result set. |
total | integer | Yes |
Full schemas
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous response."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum number of results to return.",
"default": 50
},
"search": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Provide the search."
},
"category": {
"type": "string",
"minLength": 1,
"description": "Provide the category."
},
"kind": {
"type": "string",
"enum": [
"template_agent",
"installable_agent"
],
"description": "Provide the kind."
},
"origin": {
"type": "string",
"enum": [
"veryfront",
"user"
],
"description": "Provide the origin."
},
"sort_by": {
"type": "string",
"enum": [
"name",
"agent_id",
"category_label"
],
"description": "Provide the sort by."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Provide the sort order."
}
},
"additionalProperties": false,
"description": "Arguments for the list_agent_templates tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the returned record."
},
"agent_id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"template_agent",
"installable_agent"
]
},
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description returned by the tool."
},
"avatar_url": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null",
"description": "The avatar url returned by the tool."
}
]
},
{
"type": "null",
"description": "The avatar url returned by the tool."
}
]
},
"category_id": {
"type": "string"
},
"category_label": {
"type": "string"
},
"provider_name": {
"type": "string"
},
"provider_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null",
"description": "The provider url returned by the tool."
}
]
},
"model": {
"anyOf": [
{
"type": [
"string",
"null"
],
"description": "AI model id associated with this tool result."
},
{
"type": "null",
"description": "AI model id associated with this tool result."
}
],
"description": "AI model id associated with this tool result."
},
"version": {
"type": [
"string",
"null"
]
},
"tools": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "List of tools associated with this tool result."
},
{
"type": "null",
"description": "The tools returned by the tool."
}
]
},
"suggestions": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Short human-readable title returned by the tool."
},
"prompt": {
"type": "string",
"minLength": 1
}
},
"required": [
"title",
"prompt"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this tool result."
}
]
},
"description": "List of suggestions associated with this tool result."
},
{
"type": "null",
"description": "The suggestions returned by the tool."
}
]
},
"actions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"fork",
"install"
]
},
"description": "List of actions associated with this tool result."
},
"template_project": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"project_reference": {
"type": "string",
"description": "Project identifier or slug associated with this result."
},
"source_path": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"project_reference",
"source_path"
],
"additionalProperties": false,
"description": "Structured template project details associated with this tool result."
},
{
"type": "null",
"description": "The template project returned by the tool."
}
]
},
"installability": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"installable",
"already_installed",
"unavailable"
],
"description": "Lifecycle status for the returned record."
},
"reason": {
"type": [
"string",
"null"
]
}
},
"required": [
"status",
"reason"
],
"additionalProperties": false,
"description": "Structured installability details associated with this tool result."
},
{
"type": "null",
"description": "The installability returned by the tool."
}
]
},
"origin": {
"anyOf": [
{
"type": "string",
"enum": [
"veryfront",
"user"
]
},
{
"type": "null",
"description": "The origin returned by the tool."
}
]
},
"runtime_mode": {
"anyOf": [
{
"type": "string",
"enum": [
"push_service",
"pull_worker",
"none"
]
},
{
"type": "null",
"description": "The runtime mode returned by the tool."
}
]
},
"runtime_service_key": {
"anyOf": [
{
"type": [
"string",
"null"
]
},
{
"type": "null",
"description": "The runtime service key returned by the tool."
}
]
},
"environment_scope": {
"anyOf": [
{
"type": "string",
"enum": [
"development",
"staging",
"production",
"all"
]
},
{
"type": "null",
"description": "The environment scope returned by the tool."
}
]
},
"card": {
"anyOf": [
{
"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."
},
"provider": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null",
"description": "The url returned by the tool."
}
]
}
},
"required": [
"name",
"url"
],
"additionalProperties": false,
"description": "Structured provider details associated with this tool result."
},
"version": {
"type": [
"string",
"null"
]
},
"runtime_mode": {
"$ref": "#/properties/data/items/properties/runtime_mode/anyOf/0",
"description": "The runtime mode returned by the tool."
},
"runtime_service_key": {
"type": [
"string",
"null"
]
},
"default_input_modes": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of default input modes associated with this tool result."
},
"default_output_modes": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of default output modes associated with this tool result."
},
"skills": {
"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."
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"description": "List of skills associated with this tool result."
},
"tools": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of tools associated with this tool result."
}
},
"required": [
"id",
"name",
"description",
"provider",
"version",
"runtime_mode",
"runtime_service_key",
"default_input_modes",
"default_output_modes",
"skills",
"tools"
],
"additionalProperties": false,
"description": "Structured card details associated with this tool result."
},
{
"type": "null",
"description": "The card returned by the tool."
}
]
}
},
"required": [
"id",
"agent_id",
"kind",
"name",
"description",
"category_id",
"category_label",
"provider_name",
"provider_url",
"version",
"actions"
],
"additionalProperties": false
},
"description": "Unified catalog: agents from configured template projects and approved installable registry entries. Template agents expose the fork action; installable agents expose the install action."
},
"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."
},
"total": {
"type": "integer"
}
},
"required": [
"data",
"page_info",
"total"
],
"additionalProperties": false,
"description": "Structured result returned by the list_agent_templates tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}