Zum Inhalt
Für Agenten

MCP Reference

agent_list

List Agents

Markdown Tools als JSON

Beschreibung

Lists the account's AI agents (every agent is scoped to one account and visible to all its members). Sorted alphabetically by name.

Filters (all optional): - active — true to hide retired rows, false to show only retired - query — case-insensitive substring match on name - limit — default 50, max 250

Zugriff

Zugriffsprofil: gated. Module: none. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
active boolean Nein
query string Nein
limit integer Nein

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "agents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "system_prompt": {
            "type": [
              "string",
              "null"
            ]
          },
          "model": {
            "type": [
              "string",
              "null"
            ]
          },
          "tools": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "object"
              ]
            }
          },
          "active": {
            "type": "boolean"
          },
          "creator_role": {
            "type": "string"
          },
          "creator": {
            "type": [
              "object",
              "null"
            ]
          },
          "account_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "active",
          "creator_role",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "agents"
  ],
  "type": "object"
}
Seiten