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 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Captured 2026-10-29T03:35:56.855Z. 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": {}
}
]