Search the docs

Search guides, API endpoints and MCP tools.

Planning

list_projects

Read grantRead-onlyIdempotent

List the projects your person can open, in priority order, optionally for one team or one product. Returns projects with their status, lead, target date, teams, products, milestones and ticket counts by status category, without their documents. Archived projects are left out unless archived says otherwise. Needs read access.

Inputs

teamstring

Only projects linked to this team, such as WEB.

productstring

Only projects linked to this product, by slug, such as storefront.

archivedstring

Which projects to list: exclude (the default) leaves archived ones out, include adds them, only lists just them.

One ofexcludeincludeonly
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_projects",    "arguments": {      "team": "WEB"    }  }}
POST/agent/v1/projects:list
curl -X POST https://api.qa.clankership.net/agent/v1/projects:list \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB"  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.