list_top_posts
Posts ranked best to worst by a metric. Rank recent posts to answer "what's my best post?", "what was Alex's best post?", "what was our top post this month?", "worst post?". WHOSE POSTS: this workspace may have several people posting, so pass author whenever the question names one. "my"/"mine"/"I" -> author: "me". A person's name -> that name, e.g. author: "Alex". "our"/"the team"/"we", or no one named at all -> omit author for the whole workspace. Do not assume "my" means the workspace. Omit platform to rank across every connected network; pass one to focus. Defaults to ranking by engagement rate. Use order: bottom for worst-performers. Returns each post's id, stats, snippet, and link.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_top_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many posts (default 5, max 20). | |
| order | No | top (best) or bottom (worst). Default top. | |
| author | No | Whose posts to rank. "me" for the person asking (use this for "my best post"), or a teammate's name for theirs ("Alex"). Omit for the whole workspace, which is the default and is what "our" / "the team" means. | |
| metric | No | What to rank by. Default engagement_rate. discussion_rate is comments per 1,000 impressions. LinkedIn also tracks profile_views (profile viewers the post drove), members_reached, saves, sends, follows, lift, clicks and premium_cta_clicks (clicks on a Premium member's profile button that came from the post); other platforms track their own subset. A metric a platform doesn't report is refused with the list it does. | |
| period | No | Rolling window ending today. Default 30d. For any other window, pass start_date/end_date instead. | |
| end_date | No | Optional. Last day of a custom range, YYYY-MM-DD, inclusive. Defaults to today. Needs start_date. | |
| platform | No | Optional. Omit to rank across all platforms. | |
| workspace | No | Optional: the workspace (client) to answer from for this call only, by name (e.g. 'Acme') or numeric id, as returned by list_workspaces. Leave it out to use the current workspace. It does not change the current workspace; use select_workspace for that. | |
| start_date | No | Optional. First day of a custom range, YYYY-MM-DD, in the user's timezone. Use for windows the presets don't cover: "last 14 days", "in March", "since Jan 1", "last year". Overrides `period`. Ranges can cover up to 366 days. |