list_projects

List all Bridge Town projects the current user can access. Returns: projects (list[{project, role, url}]) — one entry per accessible project where project is the project name, role is the caller’s access level (owner, editor, or viewer), and url is a direct link to the project in the Bridge Town web app; count (int) — number of projects.

read-only · idempotent

Parameters

This tool takes no parameters.

Returns

Returns a structured object. Top-level fields:

• projects (array<object>)
• count (integer)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_projects",
  "arguments": {}
}

Response

{
  "projects": [
    {
      "project": "forecasts",
      "role": "owner",
      "url": "https://app.bridgetown.example/acme/forecasts"
    },
    {
      "project": "headcount-plan",
      "role": "editor",
      "url": "https://app.bridgetown.example/acme/headcount-plan"
    }
  ],
  "count": 2
}

Notes

• Module: Projects
• Requires authentication via API token or Auth0 JWT.