addedInput schema / properties / filter
Added value: +{
+ "description": "List mode only: filter by lifetime open status.",
+ "enum": [
+ "opened",
+ "not_opened"
+ ],
+ "type": "string"
+}
removedInput schema / properties / limit
Removed value: -{
- "default": 50,
- "description": "Open-log page size.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
-}
addedInput schema / properties / links_limit
Added value: +{
+ "default": 25,
+ "description": "List mode only: links per page (1-100, default 25).",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+}
addedInput schema / properties / links_offset
Added value: +{
+ "default": 0,
+ "description": "List mode only: links to skip (default 0).",
+ "minimum": 0,
+ "type": "integer"
+}
removedInput schema / properties / offset
Removed value: -{
- "default": 0,
- "description": "Open-log rows to skip.",
- "minimum": 0,
- "type": "integer"
-}
addedInput schema / properties / opens_limit
Added value: +{
+ "default": 50,
+ "description": "Detail mode only: open-log rows per page (1-100, default 50).",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+}
addedInput schema / properties / opens_offset
Added value: +{
+ "default": 0,
+ "description": "Detail mode only: open-log rows to skip (default 0).",
+ "minimum": 0,
+ "type": "integer"
+}
addedInput schema / properties / query
Added value: +{
+ "description": "List mode only: match content title (max 100 chars).",
+ "type": "string"
+}
changedInput schema / properties / share_link / description
Previous value: -"The share link (https://app.marcora.ai/s/<token>) or just the token."New value: +"Optional share link (https://app.marcora.ai/s/<token>) or UUID token. Pass for detail mode; omit for list mode."
addedInput schema / properties / team_id
Added value: +{
+ "description": "Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions.",
+ "minimum": 1,
+ "type": "integer"
+}
changedInput schema / required
Previous value: -[
- "share_link"
-]New value: +[
+ "team_id"
+]
removedOutput schema / properties / automated
Removed value: -{
- "description": "Automated opens (email scanners, data centers). Not counted.",
- "properties": {
- "last_at": {
- "description": "Most recent automated open. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "network": {
- "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
- "properties": {
- "kind": {
- "type": [
- "string",
- "null"
- ]
- },
- "name": {
- "type": "string"
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "opens": {
- "type": "integer"
- }
- },
- "required": [
- "opens",
- "last_at",
- "network"
- ],
- "type": "object"
-}
removedOutput schema / properties / coverage_note
Removed value: -{
- "description": "Set when opens lack details (opened before open details were recorded); explains what the viewer and log figures cover.",
- "type": [
- "string",
- "null"
- ]
-}
removedOutput schema / properties / first_opened_at
Removed value: -{
- "description": "First counted open, or null if never opened. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
-}
removedOutput schema / properties / last_opened_at
Removed value: -{
- "description": "Last counted open, or null if never opened. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
-}
removedOutput schema / properties / link
Removed value: -{
- "properties": {
- "content_id": {
- "description": "Content UUID; use with get_content.",
- "type": "string"
- },
- "content_title": {
- "type": [
- "string",
- "null"
- ]
- },
- "expires_at": {
- "description": "When the link expires, or null. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "share_url": {
- "type": "string"
- },
- "shared_at": {
- "description": "ISO 8601.",
- "format": "date-time",
- "type": "string"
- },
- "shared_by": {
- "description": "Name of who created the link.",
- "type": [
- "string",
- "null"
- ]
- },
- "status": {
- "description": "active: can be opened. expired: past its expiry. off: switched off.",
- "enum": [
- "active",
- "expired",
- "off"
- ],
- "type": "string"
- }
- },
- "required": [
- "share_url",
- "status",
- "shared_at",
- "expires_at",
- "shared_by",
- "content_id",
- "content_title"
- ],
- "type": "object"
-}
addedOutput schema / properties / link_detail
Added value: +{
+ "description": "Present in detail mode when open tracking is enabled.",
+ "properties": {
+ "automated": {
+ "description": "Automated opens (email scanners, data centers). Not counted.",
+ "properties": {
+ "last_at": {
+ "description": "Most recent automated open. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "network": {
+ "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
+ "properties": {
+ "kind": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "opens": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "opens",
+ "last_at",
+ "network"
+ ],
+ "type": "object"
+ },
+ "coverage_note": {
+ "description": "Set when opens lack details (opened before open details were recorded); explains what the viewer and log figures cover.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "first_opened_at": {
+ "description": "First counted open, or null if never opened. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_opened_at": {
+ "description": "Last counted open, or null if never opened. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "link": {
+ "properties": {
+ "content_id": {
+ "description": "Content UUID; use with get_content.",
+ "type": "string"
+ },
+ "content_title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "expires_at": {
+ "description": "When the link expires, or null. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "share_url": {
+ "type": "string"
+ },
+ "shared_at": {
+ "description": "ISO 8601.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "shared_by": {
+ "description": "Name of who created the link.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "active: can be opened. expired: past its expiry. off: switched off.",
+ "enum": [
+ "active",
+ "expired",
+ "off"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "share_url",
+ "status",
+ "shared_at",
+ "expires_at",
+ "shared_by",
+ "content_id",
+ "content_title"
+ ],
+ "type": "object"
+ },
+ "open_log": {
+ "properties": {
+ "items": {
+ "items": {
+ "properties": {
+ "device": {
+ "description": "desktop, mobile or tablet.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "likely_automated": {
+ "description": "True for data-center or email-scanner opens. These are never counted.",
+ "type": "boolean"
+ },
+ "network": {
+ "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
+ "properties": {
+ "kind": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "place": {
+ "description": "Approximate place (from the network, not the person). Any part can be null.",
+ "properties": {
+ "city": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "country": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "region": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "returning": {
+ "description": "True when this viewer had opened the link before this open.",
+ "type": "boolean"
+ },
+ "viewed_at": {
+ "description": "ISO 8601.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "viewer": {
+ "description": "Viewer number; null for automated opens and opens with no viewer identifier.",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "viewed_at",
+ "device",
+ "viewer",
+ "returning",
+ "place",
+ "network",
+ "likely_automated"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "limit": {
+ "type": "integer"
+ },
+ "offset": {
+ "type": "integer"
+ },
+ "total": {
+ "description": "Rows in the log, automated included.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "total",
+ "limit",
+ "offset",
+ "items"
+ ],
+ "type": "object"
+ },
+ "opened": {
+ "description": "Whether the link has been opened by anyone, from the lifetime counter.",
+ "type": "boolean"
+ },
+ "opens": {
+ "description": "Lifetime counted opens (automated opens excluded).",
+ "type": "integer"
+ },
+ "opens_without_details": {
+ "description": "Counted opens that predate open details (no viewer, place or device). 0 when fully covered.",
+ "type": "integer"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "unique_viewers": {
+ "description": "Distinct recorded viewer identifiers; excludes opens that predate open details. Not a verified count of people.",
+ "type": "integer"
+ },
+ "viewers": {
+ "items": {
+ "properties": {
+ "device": {
+ "description": "desktop, mobile or tablet.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "first_opened_at": {
+ "description": "When this viewer first opened it. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_opened_at": {
+ "description": "When this viewer last opened it. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "network": {
+ "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
+ "properties": {
+ "kind": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "opens": {
+ "type": "integer"
+ },
+ "place": {
+ "description": "Approximate place (from the network, not the person). Any part can be null.",
+ "properties": {
+ "city": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "country": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "region": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "returning": {
+ "description": "True when this numbered viewer has more than one counted open.",
+ "type": "boolean"
+ },
+ "viewer": {
+ "description": "Viewer number, 1 = first recorded viewer identifier. Stable for this link; not a personal identity.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "viewer",
+ "opens",
+ "first_opened_at",
+ "last_opened_at",
+ "place",
+ "network",
+ "device",
+ "returning"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "opened",
+ "summary",
+ "link",
+ "opens",
+ "unique_viewers",
+ "opens_without_details",
+ "viewers",
+ "automated",
+ "open_log"
+ ],
+ "type": "object"
+}
addedOutput schema / properties / links_page
Added value: +{
+ "description": "Present in list mode when open tracking is enabled.",
+ "properties": {
+ "counts": {
+ "properties": {
+ "all": {
+ "type": "integer"
+ },
+ "not_opened": {
+ "type": "integer"
+ },
+ "opened": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "limit": {
+ "type": "integer"
+ },
+ "links": {
+ "items": {
+ "properties": {
+ "content_id": {
+ "type": "string"
+ },
+ "content_title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "expires_at": {
+ "description": "Expiry, or null. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_open": {
+ "description": "The most recent counted open with details; null when none has details.",
+ "properties": {
+ "at": {
+ "description": "ISO 8601.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "device": {
+ "description": "desktop, mobile or tablet.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "place": {
+ "description": "Approximate place (from the network, not the person). Any part can be null.",
+ "properties": {
+ "city": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "country": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "region": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "returning": {
+ "type": "boolean"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "opened": {
+ "type": "boolean"
+ },
+ "opens": {
+ "description": "Lifetime counted opens.",
+ "type": "integer"
+ },
+ "share_url": {
+ "type": "string"
+ },
+ "shared_at": {
+ "description": "ISO 8601.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "shared_by": {
+ "description": "Name of who created the link.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "active: can be opened. expired: past its expiry. off: switched off.",
+ "enum": [
+ "active",
+ "expired",
+ "off"
+ ],
+ "type": "string"
+ },
+ "viewers": {
+ "description": "People with open details only.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "share_url",
+ "content_id",
+ "content_title",
+ "status",
+ "shared_at",
+ "expires_at",
+ "shared_by",
+ "opened",
+ "opens",
+ "viewers",
+ "last_open"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "note": {
+ "type": "string"
+ },
+ "offset": {
+ "type": "integer"
+ },
+ "summary_7d": {
+ "properties": {
+ "not_opened_count": {
+ "description": "Active links nobody has opened.",
+ "type": "integer"
+ },
+ "oldest_not_opened_shared_at": {
+ "description": "When the oldest still-unopened active link was shared. ISO 8601.",
+ "format": "date-time",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "opens_7d": {
+ "type": "integer"
+ },
+ "returning_viewers_7d": {
+ "type": "integer"
+ },
+ "viewers_7d": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "total": {
+ "description": "Links matching the filter.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "counts",
+ "summary_7d",
+ "note",
+ "links",
+ "total",
+ "limit",
+ "offset"
+ ],
+ "type": "object"
+}
addedOutput schema / properties / mode
Added value: +{
+ "description": "Which mode ran: list (when share_link omitted) or detail (when share_link provided).",
+ "enum": [
+ "list",
+ "detail"
+ ],
+ "type": "string"
+}
removedOutput schema / properties / open_log
Removed value: -{
- "properties": {
- "items": {
- "items": {
- "properties": {
- "device": {
- "description": "desktop, mobile or tablet.",
- "type": [
- "string",
- "null"
- ]
- },
- "likely_automated": {
- "description": "True for data-center or email-scanner opens. These are never counted.",
- "type": "boolean"
- },
- "network": {
- "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
- "properties": {
- "kind": {
- "type": [
- "string",
- "null"
- ]
- },
- "name": {
- "type": "string"
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "place": {
- "description": "Approximate place (from the network, not the person). Any part can be null.",
- "properties": {
- "city": {
- "type": [
- "string",
- "null"
- ]
- },
- "country": {
- "type": [
- "string",
- "null"
- ]
- },
- "region": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "returning": {
- "description": "True when this viewer had opened the link before this open.",
- "type": "boolean"
- },
- "viewed_at": {
- "description": "ISO 8601.",
- "format": "date-time",
- "type": "string"
- },
- "viewer": {
- "description": "Viewer number; null for automated opens and opens with no viewer identifier.",
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "required": [
- "viewed_at",
- "device",
- "viewer",
- "returning",
- "place",
- "network",
- "likely_automated"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "limit": {
- "type": "integer"
- },
- "offset": {
- "type": "integer"
- },
- "total": {
- "description": "Rows in the log, automated included.",
- "type": "integer"
- }
- },
- "required": [
- "total",
- "limit",
- "offset",
- "items"
- ],
- "type": "object"
-}
removedOutput schema / properties / opened
Removed value: -{
- "description": "Whether the link has been opened by anyone, from the lifetime counter.",
- "type": "boolean"
-}
removedOutput schema / properties / opens
Removed value: -{
- "description": "Lifetime counted opens (automated opens excluded).",
- "type": "integer"
-}
removedOutput schema / properties / opens_without_details
Removed value: -{
- "description": "Counted opens that predate open details (no viewer, place or device). 0 when fully covered.",
- "type": "integer"
-}
removedOutput schema / properties / summary
Removed value: -{
- "type": "string"
-}
addedOutput schema / properties / team
Added value: +{
+ "description": "The team these share links belong to.",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name"
+ ],
+ "type": "object"
+}
changedOutput schema / properties / tracking_locked / description
Previous value: -"True when the workspace's plan does not include open tracking; only `workspace` and `message` are returned."New value: +"True when the team plan excludes open tracking; only `mode`, `tracking_locked`, `team`, and `message` are returned."
removedOutput schema / properties / unique_viewers
Removed value: -{
- "description": "Distinct recorded viewer identifiers; excludes opens that predate open details. Not a verified count of people.",
- "type": "integer"
-}
removedOutput schema / properties / viewers
Removed value: -{
- "items": {
- "properties": {
- "device": {
- "description": "desktop, mobile or tablet.",
- "type": [
- "string",
- "null"
- ]
- },
- "first_opened_at": {
- "description": "When this viewer first opened it. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "last_opened_at": {
- "description": "When this viewer last opened it. ISO 8601.",
- "format": "date-time",
- "type": [
- "string",
- "null"
- ]
- },
- "network": {
- "description": "The network the open came from, e.g. a company, a home ISP or a mobile carrier.",
- "properties": {
- "kind": {
- "type": [
- "string",
- "null"
- ]
- },
- "name": {
- "type": "string"
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "opens": {
- "type": "integer"
- },
- "place": {
- "description": "Approximate place (from the network, not the person). Any part can be null.",
- "properties": {
- "city": {
- "type": [
- "string",
- "null"
- ]
- },
- "country": {
- "type": [
- "string",
- "null"
- ]
- },
- "region": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "returning": {
- "description": "True when this numbered viewer has more than one counted open.",
- "type": "boolean"
- },
- "viewer": {
- "description": "Viewer number, 1 = first recorded viewer identifier. Stable for this link; not a personal identity.",
- "type": "integer"
- }
- },
- "required": [
- "viewer",
- "opens",
- "first_opened_at",
- "last_opened_at",
- "place",
- "network",
- "device",
- "returning"
- ],
- "type": "object"
- },
- "type": "array"
-}
removedOutput schema / properties / workspace
Removed value: -{
- "description": "The workspace the link belongs to.",
- "properties": {
- "is_active": {
- "description": "Whether it is the caller's active workspace.",
- "type": "boolean"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "is_active"
- ],
- "type": "object"
-}
changedOutput schema / required
Previous value: -[
- "tracking_locked",
- "workspace"
-]New value: +[
+ "mode",
+ "tracking_locked",
+ "team"
+]