veryfront__list_connected_agentsAccess
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 identifier or slug that scopes the tool call. Minimum length: 1. |
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_connected_agents",
"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 or object[] | Yes | The project’s connected agents: every push runtime service first, then at most the 50 most recently updated pull workers, with no continuation for the rest. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Project identifier or slug that scopes the tool call."
}
},
"additionalProperties": false,
"description": "Arguments for the list_connected_agents tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the returned record."
},
"service_name": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"service_key": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"scope_kind": {
"type": "string",
"enum": [
"global",
"project"
]
},
"scope_key": {
"type": "string",
"minLength": 1
},
"project_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
},
{
"type": "null",
"description": "Project identifier associated with this result."
}
],
"description": "Project identifier associated with this result."
},
"agent_id": {
"type": [
"string",
"null"
]
},
"base_url": {
"type": "string",
"format": "uri"
},
"invoke_url": {
"type": "string",
"format": "uri"
},
"status": {
"type": "string",
"enum": [
"active",
"disabled"
],
"description": "Lifecycle status for the returned record."
},
"capabilities": {
"anyOf": [
{},
{
"type": "null",
"description": "The capabilities returned by the tool."
}
]
},
"metadata": {
"anyOf": [
{
"description": "Additional structured metadata returned by the tool."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional structured metadata returned by the tool."
},
"managed_source": {
"anyOf": [
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
},
"environment_id": {
"type": "string",
"format": "uuid"
},
"release_id": {
"type": "string",
"format": "uuid",
"description": "Release identifier associated with this result."
}
},
"required": [
"project_id",
"environment_id",
"release_id"
],
"additionalProperties": false,
"description": "Structured managed source details associated with this tool result."
},
{
"type": "null",
"description": "The managed source returned by the tool."
}
]
},
"version": {
"type": [
"string",
"null"
]
},
"runtime": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"last_heartbeat_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"updated_at": {
"type": "string",
"description": "Last update timestamp in ISO 8601 format."
},
"kind": {
"type": "string",
"const": "registered_push_service"
},
"mode": {
"type": "string",
"const": "push"
},
"source": {
"type": "string",
"const": "runtime_service_registry"
},
"connection_status": {
"type": "string",
"enum": [
"online",
"offline",
"disabled"
]
}
},
"required": [
"id",
"service_name",
"service_key",
"scope_kind",
"scope_key",
"project_id",
"agent_id",
"base_url",
"invoke_url",
"status",
"managed_source",
"version",
"runtime",
"region",
"last_heartbeat_at",
"created_at",
"updated_at",
"kind",
"mode",
"source",
"connection_status"
],
"additionalProperties": false,
"description": "Structured option 1 details associated with this tool result."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "pull_worker"
},
"mode": {
"type": "string",
"const": "pull"
},
"source": {
"type": "string",
"const": "agent_worker_registry"
},
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the returned record."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
},
"implementation_kind": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[a-zA-Z0-9_-]+$"
},
"worker_key": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[a-zA-Z0-9_.:-]+$"
},
"display_name": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string",
"enum": [
"active",
"disabled"
],
"description": "Lifecycle status for the returned record."
},
"connection_status": {
"$ref": "#/properties/data/items/anyOf/0/properties/connection_status",
"description": "The connection status returned by the tool."
},
"metadata": {
"anyOf": [
{
"description": "Additional structured metadata returned by the tool."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional structured metadata returned by the tool."
},
"last_heartbeat_at": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"updated_at": {
"type": "string",
"description": "Last update timestamp in ISO 8601 format."
}
},
"required": [
"kind",
"mode",
"source",
"id",
"project_id",
"implementation_kind",
"worker_key",
"display_name",
"status",
"connection_status",
"last_heartbeat_at",
"created_at",
"updated_at"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this tool result."
}
]
},
"description": "The project's connected agents: every push runtime service first, then at most the 50 most recently updated pull workers, with no continuation for the rest."
}
},
"required": [
"data"
],
"additionalProperties": false,
"description": "Structured result returned by the list_connected_agents tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}