Skip to main content
Glama

get_share_link_activity

Read-onlyIdempotent

Lists or inspects tracked share links for a team (Admins and Creators). Read-only: checking never counts as an open or notifies anyone.

Two modes (requires team_id):

  • List mode (omit share_link): lists links the caller can open, newest activity first, with counts (all/opened/not_opened), summary_7d, and links_page (filter: opened|not_opened, query, links_limit, links_offset). Cannot combine with opens_limit/opens_offset.

  • Detail mode (share_link: URL https://app.marcora.ai/s/<token> or UUID token): full stats for one link (link_detail: opened, summary, coverage_note, link, opens, unique_viewers, opens_without_details, viewers, automated, open_log paged by opens_limit/opens_offset). Cannot combine with list params (filter/query/links_limit/links_offset); invalid share_link errors directly.

opened/opens come from the lifetime counter while viewers/open_log cover only opens with details; automated opens are separate and excluded. Returns tracking_locked: true when the team's plan excludes tracking.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "team_id": "<team_id>"
    },
    "name": "get_share_link_activity"
  }
}

Input Schema

NameRequiredDescriptionDefault
queryNoList mode only: match content title (max 100 chars).
filterNoList mode only: filter by lifetime open status.
team_idYesTeam id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions.
share_linkNoOptional share link (https://app.marcora.ai/s/<token>) or UUID token. Pass for detail mode; omit for list mode.
links_limitNoList mode only: links per page (1-100, default 25).
opens_limitNoDetail mode only: open-log rows per page (1-100, default 50).
links_offsetNoList mode only: links to skip (default 0).
opens_offsetNoDetail mode only: open-log rows to skip (default 0).

Output Schema

NameRequiredDescriptionDefault
modeYesWhich mode ran: list (when share_link omitted) or detail (when share_link provided).
teamYesThe team these share links belong to.
messageNo
links_pageNoPresent in list mode when open tracking is enabled.
link_detailNoPresent in detail mode when open tracking is enabled.
tracking_lockedYesTrue when the team plan excludes open tracking; only `mode`, `tracking_locked`, `team`, and `message` are returned.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed30 schema fields changed
    • 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"
      +]
  2. Added

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, non-destructive behavior, but the description adds non-obvious context: checking never counts as an open and notifies no one. It also discloses that `tracking_locked: true` appears when the team's plan excludes tracking and explains that automated opens are tracked separately and excluded.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The read-only guarantee and required `team_id` are front-loaded, then the two modes are presented as parallel bullets. Every sentence carries operational meaning — role scope, mode selection, incompatible flags, counter semantics — with no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, yet the description still names the key return structures (`counts`, `summary_7d`, `links_page`, `link_detail`, `open_log`) and flags the lifetime-counter versus detail-log discrepancy. Combined with plan-based locking, it covers everything an agent needs to call and interpret the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description earns above baseline by grouping parameters into mutually exclusive list and detail mode sets and clarifying what `opened`/`opens` measure versus `viewers`/`open_log`, which the per-parameter schema text does not convey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence states a specific verb and resource ('Lists or inspects tracked share links for a team') and names the authorized roles. The two-mode breakdown makes the dual list/detail behavior unmistakable without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly states the selection rule: omit `share_link` for list mode, pass it for detail mode. It goes further by naming incompatible parameter combinations in both directions (`opens_limit`/`opens_offset` vs `filter`/`query`/`links_limit`/`links_offset`) and noting that invalid `share_link` errors directly — no inference required.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources