Zum Inhalt
Für Agenten

MCP Reference

agent_log_list

List Agent Log Entries

Markdown Tools als JSON

Beschreibung

Call this before any action you might have already taken — e.g. before commenting on a task, nudging a user, or escalating something. If a recent entry shows you already did the same action under the same subject, escalate or move on instead of repeating.

Returns your own log entries in this account, newest first. Other users' entries are invisible.

Filters (all optional, AND-combined): - subject — exact match. Use the same conventions as agent_log_write ("task:ENG-123", "standup:user_max:2026-05-07"). - tags — match if the entry has any of the given tags (OR, not AND). - since — only entries created at or after this moment. Same lenient parsing as agent_reminder_upsert.due_at: relative offset (+30m, +2h, +1d), ISO 8601, date-only, space-separated, or Unix epoch. Note: relative offsets here are future-anchored — to scan the last 2h pass the absolute time (Time.now - 2h).iso8601, or just pass the date today. Bad input → error. - limit — default 50, max 200.

Example: before nudging @max again about ENG-123, call with subject: "task:ENG-123", tags: ["estimate-reminder"] — if anything comes back from the last 24h, don't nudge again.

Zugriff

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

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
subject string Nein Exact-match filter, e.g. 'task:ENG-123'.
tags array Nein Match if the entry has ANY of these tags (OR).
since string Nein Only entries created at or after this moment. Accepts ISO 8601, date-only, space-separated, Unix epoch, or relative future offset. Bad input → error.
limit integer Nein Max rows (default 50, max 200).

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "subject": {
      "type": "string",
      "description": "Exact-match filter, e.g. 'task:ENG-123'."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Match if the entry has ANY of these tags (OR)."
    },
    "since": {
      "type": "string",
      "description": "Only entries created at or after this moment. Accepts ISO 8601, date-only, space-separated, Unix epoch, or relative future offset. Bad input → error."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "description": "Max rows (default 50, max 200)."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "created_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "body",
          "tags",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "entries"
  ],
  "type": "object"
}
Seiten