veryfront__list_agent_tool_references
Requires project.agents.write.
Access
No external-service connection is required. Use a Veryfront credential with access to the requested resources.
Call type: Read-only.
Arguments
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.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_agent_tool_references",
"arguments": {}
}
}Result
The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.
Full schemas
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"description": "Opaque cursor pointing at the next page. Omit it to read the first page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum number of compact references to return. Defaults to 20; maximum is 100."
},
"query": {
"type": "string",
"minLength": 1,
"description": "Focused text query matched against valid tool reference names and descriptions."
},
"names": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "Exact tool reference name to validate."
},
"minItems": 1,
"maxItems": 20,
"description": "Exact candidate names to return when they are valid for agent tool_ids."
},
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Project ID or slug whose agent source is being authored."
},
"source_target_kind": {
"type": "string",
"description": "Write authored agent source in project or preview_branch. Omit for project; main_branch is a compatibility alias for project. Environment and release writes are unsupported."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Required for preview_branch. Omit or use null for project and main_branch. Use a branch ID returned by project branch discovery."
}
},
"additionalProperties": false,
"description": "Search valid tool_ids references for create_agent and update_agent in a selected project source target.",
"$schema": "http://json-schema.org/draft-07/schema#"
}{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Returned tool identity. Submit this canonical name for a new platform selection."
},
"legacy_name": {
"type": "string",
"description": "Rollback-compatible identity stored by the API after it validates a canonical platform selection."
},
"description": {
"type": "string",
"description": "Compact purpose of the referenced tool."
},
"source": {
"type": "string",
"enum": [
"platform",
"project",
"integration"
],
"description": "Control-plane source that makes this tool reference valid for the selected project target."
},
"attach_via": {
"type": "string",
"const": "tool_ids",
"description": "Agent field used to attach this reference. Use the exact returned name in tool_ids, never in provider_tool_ids."
}
},
"required": [
"name",
"description",
"source",
"attach_via"
],
"additionalProperties": false,
"description": "Schema-free tool reference that can be attached to a project agent."
},
"description": "Deterministically ranked and deduplicated tool references assignable to project agents. This search does not load callable tool contracts; use host tool discovery for executable tools."
},
"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."
},
"returned": {
"type": "integer",
"minimum": 0,
"description": "Number of references returned after applying the limit."
},
"total_matches": {
"type": "integer",
"minimum": 0,
"description": "Total matching references before applying the limit."
}
},
"required": [
"data",
"page_info",
"returned",
"total_matches"
],
"additionalProperties": false,
"description": "Compact schema-free agent tool reference search result.",
"$schema": "http://json-schema.org/draft-07/schema#"
}