Zum Inhalt
Für Agenten

MCP Reference

project_list

List Projects

Markdown Tools als JSON

Beschreibung

Lists projects the caller can read in the account. Each row includes the project's proj_… prefix ID — pass it back to project_get, task_save({project_id: …}), etc. Filter by workspace_id, status (backlog | planned | in_progress | paused | completed | cancelled), priority (urgent | high | medium | low | no_priority), and archived (defaults to false). Sorted by name. progress_ratio is computed live from completed_tasks / total_tasks.

Zugriff

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

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja Account prefix ID.
workspace_id string Nein Workspace prefix ID or key (e.g. ENG).
status string Nein Project status enum key.
priority string Nein Priority enum key.
archived boolean Nein Include archived projects (default false).
query string Nein Substring match on name or summary.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID."
    },
    "workspace_id": {
      "type": "string",
      "description": "Workspace prefix ID or key (e.g. ENG)."
    },
    "status": {
      "type": "string",
      "description": "Project status enum key."
    },
    "priority": {
      "type": "string",
      "description": "Priority enum key."
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived projects (default false)."
    },
    "query": {
      "type": "string",
      "description": "Substring match on name or summary."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ]
      }
    }
  },
  "required": [
    "projects"
  ],
  "type": "object"
}
Seiten