List projects

projects_list · Reads only · Markdown

Every project with how many tasks are in each status.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

Which projects are running, and how much is left in each?

Your agent callsprojects_listFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{}

What comes back

{
  "projects": [
    {
      "key": "SALE",
      "name": "Autumn sale",
      "description": "Everything for the sale from October 24 to 31.",
      "statuses": [
        {
          "name": "Backlog",
          "kind": "backlog"
        },
        {
          "name": "To do",
          "kind": "unstarted"
        }
      ],
      "archived": false,
      "tasks": {
        "Backlog": 0,
        "To do": 5,
        "In progress": 0,
        "Done": 0,
        "Canceled": 0
      }
    }
  ]
}

Use it when

To find a project's key, or see how work is spread.

What comes back

projects: each with its key, name, description, statuses and the tasks in each status. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`include_archived`	boolean	Default: false.

The call

Over MCP, call projects_list on https://api.conecto.chat/mcp/projects. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/projects_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Projects tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

List projects

An example

Use it when

What comes back

Inputs

The call

More Projects tools

Give this to your agent.