# 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

```json
{
  "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

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

## Output

```json
{
  "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

```json
{}
```

### Result

```json
{
  "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

```json
{}
```

### Result

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

## Errors

```json
[
  {
    "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](https://conversionlab.app/docs/developer/authentication).