Skip to content

list_thoughts

mcp:readread-only

List the thoughts, tips and opinions saved for this workspace's content, newest first. status 'new' shows ones not yet turned into posts, 'drafted' ones already drafted, 'active' (default) both, 'archived' retired ones. Use a thought's id with draft_post_from_thought or update_thought.

Returns { items, page, limit, total, hasMore }: limit is per page (default 50, max 100), page is 1-based; call again with page + 1 while hasMore is true.

Input

  • statusstring

    one of active, new, drafted, archived, all · default "active"

  • pageinteger

    1-based page number. Use with limit; hasMore says whether another page exists.

    min 1 · default 1

  • limitinteger

    min 1 · max 100 · default 50

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_thoughts",
"arguments": {}
}
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/thoughts as the signed-in user, with the same validation, approval rules and limits. See it in the Thoughts API reference.