Default model tools

projects_list

List projects

Lists or finds BitterClip projects/shows visible to this person, including projects shared with them. It resolves a named show/project, a project shared by another account, or the project_id for a shared shell, ahead of recordings_list or episodes_list. query filters by project title, description, or owning studio; multi-word queries tolerate punctuation differences (for example, "andrew adrian" can match "andrew & adrian"). Returned project_id values can be passed directly to recordings_list, episodes_list, and upload tools. workspace_open opens a Project with target_type:"project" and that project_id as target_id.

Surface: Default model and app

Product release eb8538f4a297f331d0399351c1e175bffcd212d2
Public contract commit 20688e11af473a363145ed880d5019c90a7ec1e2
Public contract SHA-256 87a94b85a84dc19245fc03f9b544c70d64bd9f5e08585dcccb38157cace5700d
Captured 2026-10-04T11:55:45.577Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

Default model descriptor

{
  "name": "projects_list",
  "title": "List projects",
  "description": "Lists or finds BitterClip projects/shows visible to this person, including projects shared with them. It resolves a named show/project, a project shared by another account, or the project_id for a shared shell, ahead of recordings_list or episodes_list. query filters by project title, description, or owning studio; multi-word queries tolerate punctuation differences (for example, \"andrew adrian\" can match \"andrew & adrian\"). Returned project_id values can be passed directly to recordings_list, episodes_list, and upload tools. workspace_open opens a Project with target_type:\"project\" and that project_id as target_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Optional case-insensitive filter across project title, description, owning studio name, and relationship (owned/shared)."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List projects",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}

App descriptor

{
  "name": "projects_list",
  "title": "List projects",
  "description": "Lists or finds BitterClip projects/shows visible to this person, including projects shared with them. It resolves a named show/project, a project shared by another account, or the project_id for a shared shell, ahead of recordings_list or episodes_list. query filters by project title, description, or owning studio; multi-word queries tolerate punctuation differences (for example, \"andrew adrian\" can match \"andrew & adrian\"). Returned project_id values can be passed directly to recordings_list, episodes_list, and upload tools. workspace_open opens a Project with target_type:\"project\" and that project_id as target_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Optional case-insensitive filter across project title, description, owning studio name, and relationship (owned/shared)."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List projects",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}

Live Workspace descriptor

{
  "name": "projects_list",
  "title": "List projects",
  "description": "Lists or finds BitterClip projects/shows visible to this person, including projects shared with them. It resolves a named show/project, a project shared by another account, or the project_id for a shared shell, ahead of recordings_list or episodes_list. query filters by project title, description, or owning studio; multi-word queries tolerate punctuation differences (for example, \"andrew adrian\" can match \"andrew & adrian\"). Returned project_id values can be passed directly to recordings_list, episodes_list, and upload tools. workspace_get_link opens a Project with target_type:\"project\" and that project_id as target_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Optional case-insensitive filter across project title, description, owning studio name, and relationship (owned/shared)."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List projects",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}

Errors

[
  "invalid_input"
]

Examples

[
  {
    "label": "Find a shared show by name",
    "input": {
      "query": "Science Based AI"
    }
  },
  {
    "label": "List accessible projects",
    "input": {}
  }
]