Tool details
| Field | Value |
|---|---|
| Name | list_agent_templates |
| Group | Agents |
Playground
Input schema
input-schema.json
{
"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."
},
"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": "Input schema for the list_agent_templates tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the record."
},
"agent_id": {
"type": "string",
"description": "The agent id associated with this record."
},
"kind": {
"type": "string",
"enum": [
"template_agent",
"installable_agent"
],
"description": "The kind associated with this record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"avatar_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"description": "The avatar url associated with this record."
},
{
"type": "null",
"description": "The avatar url returned by the tool."
}
],
"description": "The avatar url associated with this record."
},
"category_id": {
"type": "string",
"description": "The category id associated with this record."
},
"category_label": {
"type": "string",
"description": "The category label associated with this record."
},
"provider_name": {
"type": "string",
"description": "The provider name associated with this record."
},
"provider_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"description": "The provider url associated with this record."
},
{
"type": "null",
"description": "The provider url returned by the tool."
}
],
"description": "The provider url associated with this record."
},
"model": {
"type": [
"string",
"null"
],
"description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
},
"version": {
"type": [
"string",
"null"
],
"description": "The version associated with this record."
},
"tools": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "One tool item associated with this record."
},
"description": "List of tools associated with this record."
},
{
"type": "null",
"description": "The tools returned by the tool."
}
],
"description": "The tools associated with this record."
},
"suggestions": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The option 1 associated with this record."
},
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Short human-readable title for the record."
},
"prompt": {
"type": "string",
"minLength": 1,
"description": "The prompt associated with this record."
}
},
"required": [
"title",
"prompt"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this record."
}
],
"description": "One suggestion item associated with this record."
},
"description": "List of suggestions associated with this record."
},
{
"type": "null",
"description": "The suggestions returned by the tool."
}
],
"description": "List of suggestions associated with this record."
},
"actions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"fork",
"install"
],
"description": "One action item associated with this record."
},
"description": "List of actions associated with this record."
},
"template_project": {
"anyOf": [
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project identifier or slug associated with the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"source_path": {
"type": [
"string",
"null"
],
"description": "The source path associated with this record."
}
},
"required": [
"project_reference",
"name",
"source_path"
],
"additionalProperties": false,
"description": "Structured template project details associated with this record."
},
{
"type": "null",
"description": "The template project returned by the tool."
}
],
"description": "The template project associated with this record."
},
"installability": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"installable",
"already_installed",
"unavailable"
],
"description": "Lifecycle status for the record."
},
"reason": {
"type": [
"string",
"null"
],
"description": "The reason associated with this record."
}
},
"required": [
"status",
"reason"
],
"additionalProperties": false,
"description": "Structured installability details associated with this record."
},
{
"type": "null",
"description": "The installability returned by the tool."
}
],
"description": "The installability associated with this record."
},
"origin": {
"anyOf": [
{
"type": "string",
"enum": [
"veryfront",
"user"
],
"description": "The origin associated with this record."
},
{
"type": "null",
"description": "The origin returned by the tool."
}
],
"description": "The origin associated with this record."
},
"runtime_mode": {
"anyOf": [
{
"type": "string",
"enum": [
"push_service",
"pull_worker",
"none"
],
"description": "The runtime mode associated with this record."
},
{
"type": "null",
"description": "The runtime mode returned by the tool."
}
],
"description": "The runtime mode associated with this record."
},
"runtime_service_key": {
"type": [
"string",
"null"
],
"description": "The runtime service key associated with this record."
},
"environment_scope": {
"anyOf": [
{
"type": "string",
"enum": [
"development",
"staging",
"production",
"all"
],
"description": "The environment scope associated with this record."
},
{
"type": "null",
"description": "The environment scope returned by the tool."
}
],
"description": "The environment scope associated with this record."
},
"card": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Structured card details associated with this record."
},
{
"type": "null",
"description": "The card returned by the tool."
}
],
"description": "The card associated with this record."
}
},
"required": [
"id",
"agent_id",
"kind",
"name",
"description",
"avatar_url",
"category_id",
"category_label",
"provider_name",
"provider_url",
"model",
"version",
"tools",
"suggestions",
"actions",
"template_project",
"installability",
"origin",
"runtime_mode",
"runtime_service_key",
"environment_scope",
"card"
],
"additionalProperties": false,
"description": "Structured agent template output schema for MCP tools."
},
"description": "Primary record collection."
},
"total": {
"type": "integer",
"description": "The total associated with this record."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "object",
"description": "The first associated with this record."
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
}
},
"required": [
"data",
"total",
"page_info"
],
"additionalProperties": false,
"description": "Structured list agent templates output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}