get_agent

Fetch a visible Agent definition's metadata and complete current active behavior by the exact name returned from list_agents. This inspects a stored definition; it does not start, assign, or execute an agent. A missing or hidden target is reported identically as not found.

The name is caller-relative: bare selects personal content for a standalone credential and the organization catalogue for an organization credential; me/name selects the represented member's private organization space, and <team>/name selects a bound team.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Exact caller-relative name returned by list_agents.

Response

Field	Type	Description
name	string	Canonical caller-relative MCP address.
description	string	Description when one is present.
scope	string	Ownership scope.
active_version	integer	Active immutable version read for this call.
version_limit_policy	string	reject or prune_oldest.
definition	object	Complete current identity, categories, and components.

Example

{ "name": "engineering/reviewer" }

Result:

{
	"name": "engineering/reviewer",
	"description": "Reviews risky changes",
	"scope": "team",
	"active_version": 2,
	"version_limit_policy": "reject",
	"definition": {
		"identity": "You are a careful code reviewer.",
		"categories": [],
		"components": []
	}
}

Errors

Code	Cause
agent_not_found	No Agent with that name is visible; absence and hidden state match.
capability_denied	The credential lacks Agents.
invalid_arguments	Input is missing or does not match the schema.
internal_error	An unexpected server error occurred.

Notes

• The tool is governed: it requires Tools and tool-policy admission, plus Agents for the content read. No Agent management permission is required.
• Each call resolves the current active version. A later behavior update is visible immediately; after a rename, use the new qualified name.