Zum Inhalt
Für Agenten

MCP Reference

task_get

Get Task

Markdown Tools als JSON

Beschreibung

Fetches a single task by prefix id (task_…) or by issue key in the form {WORKSPACE_KEY}-{number} (e.g. ENG-3, VSUP-1000). Returns the full description as Markdown plus comments (chronological), parent/sub-issues, the Blocks / Blocked-by / Related / Duplicate relations, and — when include_activity is true — the activity timeline (status flips, assignee changes, comments, etc.) as humanised event rows. The payload's url field is the canonical web URL.

Zugriff

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

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
id string Ja Task prefix ID (task_…) or issue key (ENG-3).
include_comments boolean Nein
include_relations boolean Nein
include_activity boolean Nein Include activity[] — chronological event log (created / status_changed / assignee_changed / commented / …). Comments also appear here as commented rows alongside the dedicated comments[] array (ENG-1146).

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "description": "Task prefix ID (task_…) or issue key (ENG-3)."
    },
    "include_comments": {
      "type": "boolean",
      "default": true
    },
    "include_relations": {
      "type": "boolean",
      "default": true
    },
    "include_activity": {
      "type": "boolean",
      "default": false,
      "description": "Include `activity[]` — chronological event log (created / status_changed / assignee_changed / commented / …). Comments also appear here as `commented` rows alongside the dedicated `comments[]` array (ENG-1146)."
    }
  },
  "required": [
    "account_id",
    "id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "key": {
          "type": "string"
        },
        "title": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "key",
        "title"
      ]
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}
Seiten