project_list
My projects, my apps, my sites, my deployments, account inventory, dashboard overview — show every project I own or collaborate on. Each row includes is_owner so you can tell which is which.
Compact + paginated by default to keep the payload small: returns up to 50 projects with the core fields (id, name, subdomain, status, tags, created_at, last_deployed_at, latest_screenshot_url, favicon_url, is_owner). The render fields are included in this one response; screenshot/favicon URLs are null until their live-release asset exists. When more exist, the response ends with a note telling you the total and how to page. To narrow or expand: pass q (substring filter on name/subdomain), tag (organization label filter; multiple values combine with AND), limit/offset (paging), or fields:"full" for the complete record per row.
Example:
// project_list({ q: "saas", limit: 50 }) returns:
[
{ "id": "p_abc123", "name": "My SaaS", "subdomain": "my-saas", "status": "deployed", "last_deployed_at": "2026-04-01T...", "latest_screenshot_url": "https://api.somewhere.cloud/v1/deploy-screenshots/p_abc123/v7-desktop.png?exp=...&sig=...", "favicon_url": "https://my-saas.somewhere.site/favicon.ico", "tags": ["marketing"], "is_owner": true },
{ "id": "p_xyz789", "name": "Jen's App", "subdomain": "jen-app", "status": "draft", "last_deployed_at": null, "latest_screenshot_url": null, "favicon_url": null, "tags": [], "is_owner": false }
]Shared projects: you can deploy, edit files, run db migrations, send email, and use AI — all billed to the project owner. You cannot delete, transfer, change env var values, or manage billing/spend caps on shared projects.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "project_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Optional substring filter matched against project name and subdomain for locating a specific project without paging the whole list. | |
| tag | No | Optional organization-tag filter. Tags normalize to lowercase letters, digits, and hyphens. One tag or an array is accepted; arrays use AND semantics. | |
| limit | No | Maximum rows to return (default 50). The compact list is paginated; larger limits or `offset` cover accounts with many projects. | |
| fields | No | Response shape. "compact" (default) returns identity, status, tags, render-ready asset URLs, deploy time, and ownership. "full" adds the heavier complete project record. | |
| offset | No | Row offset for paging (default 0). Together with `limit`, it traverses a long list; the response note reports the total count. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| data | No | ||
| error | No | ||
| message | No |