veryfront__list_agent_tool_referencesAccess
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 cursor pointing at the next page. Omit it to read the first page. |
limit | integer | No | Maximum number of compact references to return. Defaults to 20; maximum is 100. Minimum: 1. Maximum: 100. |
query | string | No | Focused text query matched against valid tool reference names and descriptions. Minimum length: 1. |
names | string[] | No | Exact candidate names to return when they are valid for agent tool_ids. |
project_reference | string | No | Project ID or slug whose agent source is being authored. Minimum length: 1. |
source_target_kind | string | No | 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 | string or null | No | Required for preview_branch. Omit or use null for project and main_branch. Use a branch ID returned by project branch discovery. |
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_tool_references",
"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 | 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 | object | Yes | Pagination cursor values for traversing the result set. |
returned | integer | Yes | Number of references returned after applying the limit. Minimum: 0. |
total_matches | integer | Yes | Total matching references before applying the limit. Minimum: 0. |
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#"
}