MCP Tool Reference
This reference is generated from the server tool definitions. tools/list on your deployment is authoritative for the tools available to your key. See Remote MCP for transport behavior and File security for asynchronous upload results.
Download the tool catalog JSON. Schemas describe successful structured results; business failures use isError: true. Optional user_id and organization_id arguments are restricted to staff/superuser keys.
list_agents
List persistent agents accessible to the API key.
Required scope: agents:read.
Gated service credentials: supported with agents:read and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"agents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
}
},
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
},
"total": {
"type": "integer"
},
"has_next": {
"type": "boolean"
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"agents",
"page",
"page_size",
"total",
"has_next"
]
}
get_agent
Retrieve details for one persistent agent.
Required scope: agents:read.
Gated service credentials: supported with agents:read and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"agent"
]
}
create_agent
Create a persistent agent using the same provisioning path as the public Agent API.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Display name. Required when the organization requires agent names; otherwise Decision Terrain generates one when omitted."
},
"charter": {
"type": "string",
"description": "Instructions describing the agent's job."
},
"schedule": {
"type": [
"string",
"null"
],
"description": "Optional cron-like schedule, @daily, or @every interval."
},
"is_active": {
"type": "boolean",
"default": true
},
"preferred_llm_tier": {
"type": "string",
"description": "Preferred intelligence tier key, such as standard, premium, max, ultra, or ultra_max."
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Deprecated, inactive historical credit field. Writes are rejected."
},
"whitelist_policy": {
"type": "string",
"enum": [
"default",
"manual"
],
"description": "Contact allowlist policy."
},
"contact_approval_mode": {
"type": "string",
"enum": [
"require_approval",
"auto_approve_email"
]
},
"proactive_opt_in": {
"type": "boolean",
"default": true
},
"team_id": {
"type": "string",
"format": "uuid",
"description": "Optional active Team within the key Organization; requires Team creation authority."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"agent"
]
}
update_agent
Update only the supplied persistent agent settings; omitted mutable fields retain their current values. Send null for schedule to clear it. Credit fields are deprecated, inactive reads; writes are rejected.
Required scope: agents:manage.
Gated service credentials: supported with agents:manage and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"name": {
"type": "string"
},
"charter": {
"type": "string"
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"preferred_llm_tier": {
"type": "string",
"description": "Preferred intelligence tier key, such as standard, premium, max, ultra, or ultra_max."
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Deprecated, inactive historical credit field. Writes are rejected."
},
"whitelist_policy": {
"type": "string",
"enum": [
"default",
"manual"
]
},
"contact_approval_mode": {
"type": "string",
"enum": [
"require_approval",
"auto_approve_email"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"agent"
]
}
archive_agent
Soft-delete a persistent agent using Decision Terrain's normal archive/delete behavior.
Required scope: agents:manage.
Gated service credentials: supported with agents:manage and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"changed": {
"type": "boolean"
},
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"status",
"changed",
"agent"
]
}
get_agent_config_options
Discover supported agent configuration fields, intelligence tiers, inference usage, schedules, and policies for this API key.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Optional persistent agent UUID to include current per-agent config."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"owner": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": [
"integer",
"string"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"type",
"id"
]
},
"agent": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"charter": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
},
"planning_state": {
"type": [
"string",
"null"
]
},
"whitelist_policy": {
"type": "string"
},
"contact_approval_mode": {
"type": "string"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"last_interaction_at": {
"type": [
"string",
"null"
]
},
"user_id": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"string",
"null"
]
},
"team_id": {
"type": [
"string",
"null"
]
},
"workspace": {
"type": "object"
},
"browser_use_agent_id": {
"type": [
"string",
"null"
]
},
"preferred_contact_endpoint_id": {
"type": [
"string",
"null"
]
},
"preferred_llm_tier": {
"type": [
"string",
"null"
]
},
"daily_credit_limit": {
"type": [
"integer",
"null"
],
"deprecated": true,
"description": "Inactive historical credit target; writes are rejected."
},
"credit_controls_active": {
"type": "boolean",
"const": false
},
"daily_credit_soft_target": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"daily_credit_hard_limit": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"proactive_opt_in": {
"type": "boolean"
},
"proactive_last_trigger_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"schedule",
"is_active"
]
},
{
"type": "null"
}
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
},
"fields": {
"type": "object",
"properties": {
"preferred_llm_tier": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"current_system_default": {
"type": "string"
},
"max_allowed_tier": {
"type": "string"
},
"max_allowed_rank": {
"type": "integer"
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"description": {
"type": "string"
},
"rank": {
"type": "integer"
},
"credit_multiplier": {
"type": [
"number",
"string"
]
},
"is_default": {
"type": "boolean"
},
"allowed": {
"type": "boolean"
}
},
"additionalProperties": true,
"required": [
"key",
"label",
"allowed"
]
}
}
},
"additionalProperties": true,
"required": [
"type",
"options"
]
},
"daily_credit_limit": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"deprecated": {
"type": "boolean"
},
"active": {
"type": "boolean"
},
"writable": {
"type": "boolean"
},
"enforced_by_agent_runtime": {
"type": "boolean"
},
"message": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"type",
"deprecated",
"active",
"writable",
"enforced_by_agent_runtime",
"message"
]
}
},
"additionalProperties": true,
"required": [
"preferred_llm_tier",
"daily_credit_limit"
]
},
"unsupported_remote_mcp_v1_fields": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true,
"required": [
"owner",
"fields",
"unsupported_remote_mcp_v1_fields"
]
}
list_agent_links
List peer-agent links for accessible agents.
Required scope: agents:read.
Gated service credentials: supported with agents:read and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Optional agent UUID to filter links."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"agent_a": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"agent_b": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"health": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"reason": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"agent_id",
"reason"
]
}
}
},
"additionalProperties": true,
"required": [
"status",
"issues"
]
},
"is_enabled": {
"type": "boolean"
},
"messages_per_window": {
"type": "integer"
},
"window_hours": {
"type": "integer"
},
"feature_flag": {
"type": [
"string",
"null"
]
},
"pair_key": {
"type": "string"
},
"created_by_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"agent_a",
"agent_b",
"is_enabled"
]
}
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"links"
]
}
link_agents
Create or enable a peer-agent link between two accessible agents so they can coordinate.
Required scope: agents:manage.
Gated service credentials: supported with agents:manage and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "First persistent agent UUID."
},
"peer_agent_id": {
"type": "string",
"format": "uuid",
"description": "Second persistent agent UUID."
},
"messages_per_window": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 30
},
"window_hours": {
"type": "integer",
"minimum": 1,
"maximum": 168,
"default": 6
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id",
"peer_agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"link": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"agent_a": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"agent_b": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"health": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"reason": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"agent_id",
"reason"
]
}
}
},
"additionalProperties": true,
"required": [
"status",
"issues"
]
},
"is_enabled": {
"type": "boolean"
},
"messages_per_window": {
"type": "integer"
},
"window_hours": {
"type": "integer"
},
"feature_flag": {
"type": [
"string",
"null"
]
},
"pair_key": {
"type": "string"
},
"created_by_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"agent_a",
"agent_b",
"is_enabled"
]
},
"created": {
"type": "boolean"
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"link",
"created"
]
}
unlink_agents
Remove a peer-agent link while preserving historical peer conversation messages.
Required scope: agents:manage.
Gated service credentials: supported with agents:manage and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"peer_link_id": {
"type": "string",
"format": "uuid",
"description": "Existing peer link UUID."
},
"agent_id": {
"type": "string",
"format": "uuid",
"description": "First persistent agent UUID when peer_link_id is omitted."
},
"peer_agent_id": {
"type": "string",
"format": "uuid",
"description": "Second persistent agent UUID when peer_link_id is omitted."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"link": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"agent_a": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"agent_b": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"health": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"reason": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"agent_id",
"reason"
]
}
}
},
"additionalProperties": true,
"required": [
"status",
"issues"
]
},
"is_enabled": {
"type": "boolean"
},
"messages_per_window": {
"type": "integer"
},
"window_hours": {
"type": "integer"
},
"feature_flag": {
"type": [
"string",
"null"
]
},
"pair_key": {
"type": "string"
},
"created_by_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"agent_a",
"agent_b",
"is_enabled"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"status",
"link"
]
}
send_agent_message
Send an authenticated Decision Terrain MCP message to a persistent agent and optionally attach existing filespace files.
Required scope: agents:operate.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"body": {
"type": "string",
"description": "Message body sent to the agent."
},
"attachment_file_paths": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional filespace paths such as /uploads/report.pdf to attach to the message."
},
"attachments": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Destination filespace path, such as /uploads/report.pdf."
},
"content_base64": {
"type": "string",
"description": "Base64-encoded file contents."
},
"mime_type": {
"type": "string",
"default": "application/octet-stream"
},
"overwrite": {
"type": "boolean",
"default": false
}
},
"required": [
"path",
"content_base64"
],
"additionalProperties": false
},
"description": "Optional small files to upload and attach in this message call. Use this instead of a separate upload call when the content is already available."
},
"trigger_processing": {
"type": "boolean",
"default": true,
"description": "Whether to queue the agent to process the inbound message."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id",
"body"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"accepted_state": {
"type": "string"
},
"message_id": {
"type": "string",
"format": "uuid"
},
"agent_id": {
"type": "string",
"format": "uuid"
},
"cursor": {
"type": [
"string",
"null"
]
},
"latest_cursor": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"actor": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"source": {
"type": "string"
},
"user_id": {
"type": [
"integer",
"string"
]
}
},
"additionalProperties": true,
"required": [
"type",
"source"
]
},
"message": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"owner_agent_id": {
"type": [
"string",
"null"
]
},
"conversation_id": {
"type": [
"string",
"null"
]
},
"parent_id": {
"type": [
"string",
"null"
]
},
"is_outbound": {
"type": "boolean"
},
"body": {
"type": "string"
},
"timestamp": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"body"
]
},
"timeline_event": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"kind"
]
},
"conversation_id": {
"type": "string",
"format": "uuid"
},
"attachment_count": {
"type": "integer"
},
"uploaded_attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"pending_scan"
]
},
"message": {
"type": "string"
},
"scan_status": {
"type": "string"
},
"available": {
"type": "boolean"
},
"path": {
"type": "string"
},
"node_id": {
"type": "string",
"format": "uuid"
},
"filename": {
"type": "string"
},
"resource_uri": {
"type": "string",
"format": "uri"
},
"mime_type": {
"type": [
"string",
"null"
]
},
"size_bytes": {
"type": [
"integer",
"null"
]
},
"checksum_sha256": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"status",
"path",
"node_id",
"filename"
]
}
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"status",
"message_id",
"agent_id",
"cursor",
"latest_cursor"
]
}
get_agent_timeline
Fetch recent chat, task, thinking, and processing events for a persistent agent. Foreign or purged application history requires scoped REST request reads.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"after_cursor": {
"type": [
"string",
"null"
],
"description": "Return events strictly newer than this durable timeline cursor. The event with this exact cursor is excluded."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Cursor from a previous timeline result."
},
"direction": {
"type": "string",
"enum": [
"initial",
"older",
"newer"
],
"default": "initial"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 40
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"kind"
]
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"latest_cursor": {
"type": [
"string",
"null"
]
},
"oldest_cursor": {
"type": [
"string",
"null"
]
},
"newest_cursor": {
"type": [
"string",
"null"
]
},
"has_more": {
"type": "boolean"
},
"has_more_older": {
"type": "boolean"
},
"has_more_newer": {
"type": "boolean"
},
"processing_active": {
"type": "boolean"
},
"processing_snapshot": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"events",
"latest_cursor",
"has_more"
]
}
get_agent_debug_trace
Fetch bounded, sanitized debugging information for one accessible agent, including recent timeline/audit events, tool calls, completions, prompt archive metadata, usage/cost, eval artifacts, and diagnostics. Raw prompt archives and secret-like values are not returned. Foreign or purged application history requires scoped REST request reads.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Optional audit/debug cursor returned as audit.next_cursor for older debug events."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Maximum items per bounded debug section."
},
"recent_minutes": {
"type": [
"integer",
"null"
],
"minimum": 1,
"maximum": 10080,
"default": 60,
"description": "Recent time window when no cursor or explicit since is supplied. Null disables the time window and relies on limit/cursor bounds."
},
"since": {
"type": [
"string",
"null"
],
"description": "Optional ISO8601 lower time bound. Cannot be combined with recent_minutes."
},
"until": {
"type": [
"string",
"null"
],
"description": "Optional ISO8601 upper time bound. Defaults to request time."
},
"include": {
"type": "array",
"items": {
"type": "string",
"enum": [
"timeline",
"audit_events",
"completions",
"eval_debug_artifacts",
"diagnostics"
]
},
"default": [
"timeline",
"audit_events",
"completions",
"eval_debug_artifacts",
"diagnostics"
],
"description": "Optional debug sections to include."
},
"detail": {
"type": "string",
"enum": [
"summary",
"standard",
"verbose"
],
"default": "standard",
"description": "Controls sanitized preview length; verbose still redacts secrets and omits raw prompts."
},
"eval_run_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional eval run UUID to filter eval debug artifacts for this agent."
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"life_state": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"scope": {
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"requested_at": {
"type": [
"string",
"null"
]
},
"since": {
"type": [
"string",
"null"
]
},
"until": {
"type": [
"string",
"null"
]
},
"recent_minutes": {
"type": [
"integer",
"null"
]
},
"cursor": {
"type": [
"string",
"null"
]
},
"limit": {
"type": "integer"
},
"include": {
"type": "array",
"items": {
"type": "string"
}
},
"detail": {
"type": "string"
},
"eval_run_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"agent_id",
"limit",
"include",
"detail"
]
},
"timeline": {
"type": "object",
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"kind"
]
}
},
"latest_cursor": {
"type": [
"string",
"null"
]
},
"oldest_cursor": {
"type": [
"string",
"null"
]
},
"newest_cursor": {
"type": [
"string",
"null"
]
},
"has_more_older": {
"type": "boolean"
},
"has_more_newer": {
"type": "boolean"
},
"processing_active": {
"type": "boolean"
},
"processing_snapshot": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"additionalProperties": true
},
"audit_events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"timestamp": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"kind"
]
}
},
"audit": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"has_more": {
"type": "boolean"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"returned": {
"type": "integer"
}
},
"additionalProperties": true
},
"completions": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"eval_debug_artifacts": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"diagnostics": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"redaction": {
"type": "object",
"properties": {
"mode": {
"type": "string"
},
"replacement": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true,
"required": [
"mode",
"replacement"
]
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"agent",
"scope",
"redaction",
"warnings"
]
}
wait_for_agent_event
Bounded long-poll over an agent's unified timeline using durable cursors and supported structured filters. Each snapshot rejects foreign or purged application history; use scoped REST request waits.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"after_cursor": {
"type": [
"string",
"null"
],
"description": "Only consider timeline events strictly newer than this cursor. The event with this exact cursor is excluded, even when filters.message_id references it."
},
"timeout_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"default": 10
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"event_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"message",
"plan",
"steps",
"thinking"
]
},
"description": "Optional event kinds to match."
},
"filters": {
"type": "object",
"properties": {
"from_actor_type": {
"type": "string",
"enum": [
"agent",
"human_user",
"external",
"system"
],
"description": "Actor source derived from the serialized timeline event: agent for outbound or peer messages, human_user for inbound web user messages, external for MCP and other inbound messages, and system for steps/thinking/plan events."
},
"from_agent_id": {
"type": "string",
"format": "uuid",
"description": "Source agent UUID for message events: the owner agent on non-peer outbound messages, or the peer agent on inbound peer messages."
},
"to_agent_id": {
"type": "string",
"format": "uuid",
"description": "Target agent UUID for message events: the owner agent on non-peer inbound messages, or the peer agent on outbound peer messages. Ordinary agent-to-human/external replies do not have a to_agent_id."
},
"message_id": {
"type": "string",
"format": "uuid",
"description": "Timeline message UUID. Cursor strictness still applies."
},
"peer_link_id": {
"type": "string",
"format": "uuid",
"description": "Peer-link UUID for peer message events."
},
"channel": {
"type": "string",
"description": "Message channel from the serialized timeline event, such as mcp, web or email."
},
"status": {
"type": "string",
"description": "Tool-call status for steps events."
},
"tool_name": {
"type": "string",
"description": "Tool name for steps events."
}
},
"additionalProperties": false
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"matched": {
"type": "boolean"
},
"timed_out": {
"type": "boolean"
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"kind"
]
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"latest_cursor": {
"type": [
"string",
"null"
]
},
"waited_seconds": {
"type": [
"number",
"string"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"matched",
"timed_out",
"events",
"waited_seconds"
]
}
read_agent_resource
Read an authenticated file or image from a Decision Terrain resource URI returned by agent timeline or filespace tools. Content is returned as native MCP resource or image content.
Required scope: agents:read.
Gated service credentials: supported with agents:read and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"uri": {
"type": "string",
"format": "uri",
"description": "An agent:// resource URI returned by another Decision Terrain MCP tool."
}
},
"required": [
"uri"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"resource": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size_bytes": {
"type": "integer"
},
"checksum_sha256": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"uri",
"name",
"mime_type",
"size_bytes",
"checksum_sha256"
]
}
},
"additionalProperties": true,
"required": [
"resource"
]
}
list_agent_files
List files and folders in an agent's default filespace. Foreign or purged application history prevents broad filespace reads and attachment reuse.
Required scope: agents:read.
Gated service credentials: supported with agents:read and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"type": "string"
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"filespace": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
}
},
"additionalProperties": true,
"required": [
"id",
"name"
]
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"parent_id": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"path": {
"type": "string"
},
"node_type": {
"type": "string"
},
"size_bytes": {
"type": [
"integer",
"null"
]
},
"mime_type": {
"type": [
"string",
"null"
]
},
"checksum_sha256": {
"type": [
"string",
"null"
]
},
"resource_uri": {
"type": [
"string",
"null"
],
"format": "uri"
},
"created_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"scan_status": {
"type": [
"string",
"null"
]
},
"available": {
"type": [
"boolean",
"null"
]
},
"availability": {
"type": [
"string",
"null"
]
},
"active_generation": {
"type": [
"object",
"null"
]
},
"pending_generation": {
"type": [
"object",
"null"
]
}
},
"additionalProperties": true,
"required": [
"id",
"name",
"path",
"node_type"
]
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"filespace",
"nodes"
]
}
upload_agent_file
Upload a small base64-encoded file into an agent's filespace for later use or message attachment.
Required scope: agents:operate.
Gated service credentials: supported with agents:operate and explicit resource grants.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"description": "Persistent agent UUID."
},
"path": {
"type": "string",
"description": "Filespace path where the file should be stored, e.g. /uploads/report.txt."
},
"content_base64": {
"type": "string",
"description": "Base64-encoded file content."
},
"mime_type": {
"type": "string",
"default": "application/octet-stream"
},
"overwrite": {
"type": "boolean",
"default": false
},
"user_id": {
"type": [
"integer",
"string",
"null"
],
"description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
},
"organization_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied."
}
},
"required": [
"agent_id",
"path",
"content_base64"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"pending_scan"
]
},
"message": {
"type": [
"string",
"null"
]
},
"scan_status": {
"type": "string"
},
"available": {
"type": "boolean"
},
"path": {
"type": "string"
},
"node_id": {
"type": "string",
"format": "uuid"
},
"filename": {
"type": "string"
},
"resource_uri": {
"type": "string",
"format": "uri"
},
"mime_type": {
"type": [
"string",
"null"
]
},
"size_bytes": {
"type": [
"integer",
"null"
]
},
"checksum_sha256": {
"type": [
"string",
"null"
]
},
"access": {
"type": "object",
"properties": {
"admin_access": {
"type": "boolean"
},
"access_scope": {
"type": "string"
},
"operator_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"target_organization_id": {
"type": [
"string",
"null"
]
},
"requested_user_id": {
"type": [
"integer",
"string",
"null"
]
},
"requested_organization_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true,
"required": [
"admin_access",
"access_scope"
]
}
},
"additionalProperties": true,
"required": [
"status"
]
}
list_organizations
Discover active Organization memberships. Personal keys discover metadata only; use an Organization key to operate that Organization.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
}
},
"required": [],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
list_workspaces
List this key's personal or Organization-private workspace and accessible active Teams, with creation and management permissions.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
}
},
"required": [],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
list_workspace_members
Page Team memberships, or Organization membership when authorized to manage people or agents. Omit team_id for Organization membership.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"team_id": {
"type": "string",
"format": "uuid"
}
},
"required": [],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
create_team
Create an Organization Team using the normal Team service. Requires Organization agent administration and exact-request browser approval.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"name",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
update_team
Rename or change Team availability. Availability changes require Organization agent administration. Requires exact-request browser approval.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"is_active": {
"type": "boolean"
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"team_id",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
set_team_member
Add, update or remove an active Organization member's Team assignment. Requires Team administration and exact-request browser approval.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"format": "uuid"
},
"organization_membership_id": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "string",
"pattern": "^[1-9][0-9]*$"
}
]
},
"role": {
"type": "string",
"enum": [
"admin",
"member",
"viewer"
]
},
"active": {
"type": "boolean"
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"team_id",
"organization_membership_id",
"active",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
move_agent
Move an agent within this key's ownership boundary using console workspace restrictions; Team-to-private moves remain disabled.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"workspace_type": {
"type": "string",
"enum": [
"personal",
"organization_private",
"team"
]
},
"team_id": {
"type": "string",
"format": "uuid"
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"agent_id",
"workspace_type",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
list_integrations
Discover native provider capabilities or Organization OpenAPI integrations. Supply agent_id for effective native connections and assignments. No credentials are returned.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"kind": {
"type": "string",
"enum": [
"native",
"openapi"
]
},
"agent_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"kind"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
get_integration
Inspect native capabilities or a paged OpenAPI revision's operations and supported configuration, including secret-entry handoff.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"kind": {
"type": "string",
"enum": [
"native",
"openapi"
]
},
"integration_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"agent_id": {
"type": "string",
"format": "uuid"
},
"revision_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"kind",
"integration_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
configure_openapi_integration
Create/update configuration, import a bundled specification, configure draft operations, publish a revision, or enable/disable an integration. Secrets and external specification URLs are not accepted. Inspect get_integration for revisions and operations.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"update",
"import",
"operations",
"publish",
"enable",
"disable"
]
},
"integration_id": {
"type": "string",
"format": "uuid"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
},
"configuration": {
"type": "object",
"properties": {
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"maxLength": 2000
},
"base_url": {
"type": "string",
"maxLength": 2048
},
"auth_scheme": {
"type": "string",
"enum": [
"none",
"api_key_header",
"api_key_query",
"bearer",
"basic",
"oauth_authorization_code",
"oauth_client_credentials"
]
},
"auth_parameter_name": {
"type": "string",
"maxLength": 128
},
"oauth_authorization_url": {
"type": "string",
"maxLength": 2048
},
"oauth_token_url": {
"type": "string",
"maxLength": 2048
},
"oauth_scopes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 100,
"uniqueItems": true
},
"oauth_client_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [],
"additionalProperties": false
},
"spec": {
"type": "string",
"minLength": 1,
"maxLength": 1000000,
"description": "Bundled OpenAPI 3.x JSON/YAML without credentials or private material."
},
"revision_id": {
"type": "string",
"format": "uuid"
},
"operations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"selected": {
"type": "boolean"
},
"tool_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"maxLength": 2000
},
"policy": {
"type": "string",
"enum": [
"read",
"autonomous",
"approval"
]
},
"redaction_paths": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
},
"maxItems": 100,
"uniqueItems": true
}
},
"required": [
"id"
],
"additionalProperties": false
},
"maxItems": 100,
"uniqueItems": true
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"action",
"request_id"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"action": {
"const": "create"
}
}
},
"then": {
"required": [
"configuration",
"slug",
"spec"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "update"
}
}
},
"then": {
"required": [
"integration_id",
"configuration"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "import"
}
}
},
"then": {
"required": [
"integration_id",
"spec"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "operations"
}
}
},
"then": {
"required": [
"integration_id",
"revision_id",
"operations"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "publish"
}
}
},
"then": {
"required": [
"integration_id",
"revision_id"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "enable"
}
}
},
"then": {
"required": [
"integration_id"
]
}
},
{
"if": {
"properties": {
"action": {
"const": "disable"
}
}
},
"then": {
"required": [
"integration_id"
]
}
}
]
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
set_agent_integration
Bind/unbind an OpenAPI integration and existing credential, or enable/disable a native system skill using the agent's inherited connection. Native connection IDs cannot retarget credential ownership. Agent-scoped email authentication uses the browser setup flow.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"kind": {
"type": "string",
"enum": [
"native",
"openapi"
]
},
"integration_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"enabled": {
"type": "boolean"
},
"credential_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"approver_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"maxItems": 100,
"uniqueItems": true
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"agent_id",
"kind",
"integration_id",
"enabled",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
list_credentials
Page authorized credential metadata. Use agent_id for inherited/global and agent secrets; integration_id for OpenAPI credentials and grants. Secret values, OAuth tokens, and certificate material are never returned.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"agent_id": {
"type": "string",
"format": "uuid"
},
"integration_id": {
"type": "string",
"format": "uuid"
}
},
"required": [],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
set_credential_grant
Grant/revoke one agent's access to a member-owned OpenAPI credential. Only the credential owner may change grants. Revocation removes active bindings through the normal service.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"integration_id": {
"type": "string",
"format": "uuid"
},
"credential_id": {
"type": "string",
"format": "uuid"
},
"agent_id": {
"type": "string",
"format": "uuid"
},
"active": {
"type": "boolean"
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"integration_id",
"credential_id",
"agent_id",
"active",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
list_machine_identities
Page Organization identity, destination, or grant metadata. Requires machine-identity viewing authority. Certificate material is excluded; connection health retains its actual process source.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"section": {
"type": "string",
"enum": [
"identities",
"destinations",
"grants"
]
},
"agent_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"section"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
configure_machine_identity_destination
Create/update destination policy for an existing Organization. Requires machine-identity administration and browser approval. Custom CA imports use browser setup; no network requests or infrastructure changes are performed.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"destination_id": {
"type": "string",
"format": "uuid"
},
"configuration": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname_pattern": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535
},
"network_mode": {
"type": "string",
"enum": [
"public",
"private"
]
},
"private_cidrs": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 100,
"uniqueItems": true
},
"is_active": {
"type": "boolean"
}
},
"required": [],
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"configuration",
"request_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
set_machine_identity_grant
Grant or revoke an agent's access to a provisioned identity and destination through normal method/path restrictions and audit. Requires machine-identity administration and browser approval.
Required scope: agents:manage.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"identity_id": {
"type": "string",
"format": "uuid"
},
"destination_id": {
"type": "string",
"format": "uuid"
},
"grant_id": {
"type": "string",
"format": "uuid"
},
"active": {
"type": "boolean"
},
"allowed_methods": {
"type": "array",
"items": {
"type": "string",
"enum": [
"GET",
"HEAD",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS"
]
},
"maxItems": 7,
"uniqueItems": true
},
"path_prefixes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 100,
"uniqueItems": true
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input."
}
},
"required": [
"agent_id",
"active",
"request_id"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"active": {
"const": true
}
}
},
"then": {
"required": [
"identity_id",
"destination_id",
"allowed_methods",
"path_prefixes"
]
},
"else": {
"required": [
"grant_id"
]
}
}
]
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
get_integration_setup
Return a supported human setup handoff and a machine-readable pending status. Open the authenticated console to enter credentials, import certificates, or complete provider OAuth; then re-inspect through MCP.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"native",
"openapi",
"secret",
"machine_identity"
]
},
"integration_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"agent_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"kind"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Control completion or action-required state; integration reads use their publication status."
},
"code": {
"type": "string"
},
"request_id": {
"type": "string",
"format": "uuid"
},
"action": {
"type": "object"
}
},
"additionalProperties": true
}
get_agent_readiness
Bounded read-only preflight for agent configuration and optionally one integration or published OpenAPI operation. Checks durable state, never probes URLs or claims worker reachability. unknown means untested, not ready.
Required scope: agents:read.
Service credentials: unavailable for this tool.
Input schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"format": "uuid"
},
"kind": {
"type": "string",
"enum": [
"native",
"openapi"
]
},
"integration_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"operation_id": {
"type": "string",
"format": "uuid"
},
"capability": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"agent_id"
],
"additionalProperties": false
}
Output schema
{
"type": "object",
"required": [
"status",
"checks",
"execution_tested"
],
"properties": {
"status": {
"type": "string",
"enum": [
"ready",
"blocked",
"action_required",
"unknown"
]
},
"execution_tested": {
"const": false
},
"configuration_ready": {
"type": [
"boolean",
"null"
]
},
"checks": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"required": [
"check",
"status",
"code",
"next_step",
"details"
],
"properties": {
"check": {
"type": "string",
"maxLength": 2000
},
"status": {
"type": "string",
"enum": [
"ready",
"blocked",
"action_required",
"unknown"
]
},
"code": {
"type": "string",
"maxLength": 2000
},
"next_step": {
"type": "string",
"maxLength": 2000
},
"details": {
"type": "object"
}
}
}
}
}
}