---
name: "connect_list"
area: "connect"
title: "List connected systems"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/connect_list"
mcp_server: "https://api.conecto.chat/mcp/connect"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/connect/connect_list"
---

# List connected systems (`connect_list`)

The connected systems with their address, auth and allowed calls, and this month's call count.

The company's connected systems: name, base address, kind of auth and the calls each may make. The credentials are never shown.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Before calling a system, to see its name and what it allows.

## Say this to your agent

> Which of our systems can you reach, and what may you do in each?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `connect_list` on the MCP server `https://api.conecto.chat/mcp/connect` with these arguments:

```json
{}
```

REST:

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

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "connect_list",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "connections": [
      {
        "name": "zendesk",
        "base_url": "https://hansenvoss.zendesk.com/api/v2",
        "auth": "bearer",
        "header": null,
        "allow": [
          "GET /tickets*",
          "PUT /tickets/*"
        ],
        "description": "The old help desk, until the move is done",
        "created_at": "2026-10-14T08:00:00+00:00",
        "last_used_at": null
      }
    ],
    "bridges": [
      {
        "name": "office-hamburg",
        "online": true,
        "systems": [
          {
            "name": "sap",
            "allow": [
              "GET /sap/opu/odata/sap/API_SALES_ORDER_SRV/*"
            ]
          }
        ]
      }
    ],
    "calls_this_month": 0,
    "free_calls_a_month": 10000
  }
}
```

`result`: connections: each with name, base address, auth, allowed calls and when last used, and for a system behind the firewall its bridge; bridges: each with whether it is online and the systems it serves; calls_this_month and free_calls_a_month.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [connect_add](https://conecto.chat/tools/connect/connect_add.md): Connects one of the company's systems: its address, its credential (kept encrypted) and the calls it may make. Free.
- [connect_preview](https://conecto.chat/tools/connect/connect_preview.md): Shows exactly what a call would send (method, full address, headers with the credential hidden, body) without sending it. Free up to 1,000,000 reads a month.
- [connect_call](https://conecto.chat/tools/connect/connect_call.md): Sends one request to a connected system, inside its allowed calls, and returns its answer. $0.0003 for each started 10 seconds the system takes to answer ($0.0003 when it answers within 10 seconds), up to $0.0012.
- [connect_set_rules](https://conecto.chat/tools/connect/connect_set_rules.md): Replaces a connection's allowed calls; waits for the owner's approval by default. $0.001 a call.
- [connect_remove](https://conecto.chat/tools/connect/connect_remove.md): Forgets a connected system and its credential; the system itself doesn't change. Free.