MCP tool reference

get_today_daily_brief

Return today's retained daily brief if one already exists. This never generates a new brief.

Return today's retained daily brief if one already exists. This never generates a new brief.

Permissions

{
  "ability": "mcp:read or mcp:write",
  "role": "Team membership and applicable entity view policies are required.",
  "plan": "The billing account must have the MCP entitlement. Writes also require a writable billing mode and applicable entity limits.",
  "team": "The bearer token selects exactly one Team. Other team_id values cannot change the tenant."
}

Input

{
  "type": "object",
  "properties": {}
}

Output

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "brief_date": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "content": {
              "type": [
                "string",
                "null"
              ]
            },
            "generated_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "viewed_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          "required": [
            "id",
            "brief_date",
            "content",
            "generated_at",
            "viewed_at"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "found",
    "data"
  ]
}

Examples

Request arguments

{}

Result

{
  "found": true,
  "data": {
    "id": 101,
    "brief_date": "2026-01-15",
    "content": "## Today\\nReview the delivery estimate experiment.",
    "generated_at": "2026-01-15T12:00:00+00:00",
    "viewed_at": null
  }
}

Request arguments

{}

Result

{
  "found": false,
  "data": null
}

Errors

[
  {
    "status": 401,
    "description": "Missing, expired, or revoked bearer token."
  },
  {
    "status": 403,
    "description": "Missing MCP ability, team membership, plan entitlement, or user permission."
  },
  {
    "status": 404,
    "description": "The MCP server is disabled."
  },
  {
    "status": 429,
    "description": "Rate limited; honor Retry-After before retrying."
  },
  {
    "description": "Tool execution or validation failures are MCP error results. Inspect isError; a successful HTTP status alone does not indicate a successful tool call."
  }
]

An expired or revoked key cannot connect. A missing ability, role, feature entitlement, or team access prevents the operation. See authentication.

Was this article helpful?

Need more help? Copy this article's details and paste them into a request on our feedback portal. You may need to sign in.

Open feedback portal

On this page