conecto. Get started
Projects

See a project's board

projects_board · Reads only · Markdown

A project as a board: each status with its tasks in order.

Free*

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

An example

Show me the autumn sale board.

Your agent callsprojects_boardFree*

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
{
  "project": "SALE"
}
What comes back
{
  "project": "SALE",
  "name": "Autumn sale",
  "columns": [
    {
      "status": "Backlog",
      "kind": "backlog",
      "count": 0,
      "tasks": []
    },
    {
      "status": "To do",
      "kind": "unstarted",
      "count": 5,
      "tasks": [
        {
          "task": "SALE-1",
          "task_id": 4101,
          "title": "Choose the sale prices with Luis",
          "status": "To do",
          "priority": "urgent",
          "assignee": "luis@halversoncycle.example",
          "labels": [
            "prices"
          ],
          "due_date": "2026-10-15",
          "parent": null,
          "updated_at": "2026-10-14T08:00:00+00:00"
        },
        {
          "task": "SALE-2",
          "task_id": 4102,
          "title": "Design the sale flyer",
          "status": "To do",
          "priority": "high",
          "assignee": "luis@halversoncycle.example",
          "labels": [
            "print"
          ],
          "due_date": "2026-10-19",
          "parent": null,
          "updated_at": "2026-10-14T08:00:00+00:00"
        }
      ]
    }
  ]
}

Use it when

Someone asks how a project stands.

What it does

A project as a board: each status with its tasks in order (finished and canceled ones only if asked).

What comes back

The project's key and name, and columns: each status with its tasks (number, title, priority, assignee, labels, due date). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
projectRequiredstringA project's key ("WEB") or name. 1 to 80 characters.
include_finishedbooleanDefault: false.
per_statusinteger1 to 100. Default: 50.

The call

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

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

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No project has that key or name.Call projects_list and use one of its keys.

More Projects tools

All 9 tools

Give this to your agent.

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