list_projects

Lists the projects you can open, with your permission on each, and the workspaces you belong to. Assistants call this first to find project ids.


Scope	`mcp:read`
Annotations	`readOnlyHint: true`

Parameters

This tool takes no parameters.

Result

object[]

Every project you can access, oldest first.

Show project

string

Project id: 26 lowercase characters. Pass it as projectId to other tools.

string

Project name.

string | null

Project description, if any.

string

Name of the workspace the project belongs to.

"read" | "write"

Your permission on the project.

string[]

Table names, in creation order.

object[]

Every workspace you belong to.

Show workspace

string

Workspace id (a UUID). Pass it as workspaceId to create_project.

string

Workspace name.

"owner" | "admin" | "member"

Your role in the workspace.

boolean

true when you are the owner or an admin.

Example

Result

{
  "data": {
    "projects": [
      {
        "id": "01k7m3x9q2v8d4h6n1r5t0w2yz",
        "name": "Reading list",
        "description": "Books I've read and want to read",
        "workspace": "Ada's Workspace",
        "permission": "write",
        "tables": ["authors", "books"]
      }
    ],
    "workspaces": [
      {
        "id": "5f0c2a9e-3b1d-4c7a-8e2f-9d6b1a4c3e70",
        "name": "Ada's Workspace",
        "role": "owner",
        "canCreateProjects": true
      }
    ]
  }
}

Notes

A project appears when you created it, you are an owner or admin of its workspace, or it was shared with you. You must also be a member of its workspace. See Permissions.
Projects from every workspace you belong to are included.

Overview

Read tools

Write tools

Destructive tools

Parameters

Result

Example

Notes

​Parameters

​Result

​Example

​Notes

Parameters

Result

Example

Notes