Version
READ

list_projects

Paginated list of Subscriby projects visible to the current token.

Return every project the token's team can see, paginated. Use this as a starter tool — most other tools take a project_id you'll pick up from here.

Requires ability

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

Arguments

limitintegeroptional

Maximum projects to return per page (1..100).

min1max100
pageintegeroptional

1-indexed page number.

min1

What it returns

{  "data": [    {      "id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "name": "Research Premium",      "handle": "research-premium",      "description": "Weekly deep-dive research notes.",      "active": true,      "created_at": "2026-05-18T10:05:00Z"    }  ],  "meta": {    "page": 1,    "limit": 25,    "total": 12,    "has_more": false  }}

How it fails

TOKEN_MISSING_ABILITY

token lacks project:view-any.

How is this guide?

Last updated on