Account

list_projects

The projects (tracked brands) this credential can read. Every other tool takes one of these ids.

readReads only. Annotated read-only, so a client can call it without asking.

Plan: Grow and above
Rate cost: 1 unit
REST: GET /projects

Try asking

“Which brands can you see in Vidrys?”

list_projects

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

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "projects": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Acme Invoicing",
        "industry": "Accounting software"
      },
      {
        "id": "7f1b6a2d-91c4-4e05-9a3b-2d4e6f8a1c90",
        "name": "Acme Payroll",
        "industry": "HR software"
      }
    ]
  },
  "isError": false
}

Arguments

—none

This tool takes no arguments.

Result

The same object as List projects, returned as structured output.

projectsobject[]

Projects in the workspace.

+Show child attributes

idstring

Project id (a UUID). Every project-scoped call takes it.

namestring

The brand the project tracks.

industrystringnullable

The industry set on the project.

Errors

401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.

Failures arrive as a tool error — isError: true with code: message as text. See Using the tools.