Tables

List tables

tables_list · Reads only · Markdown

Every table with its columns and how many rows it has.

Free*

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

An example

What tables do we keep with you?

Your agent callstables_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
{
  "tables": [
    {
      "table_id": 4101,
      "name": "Workshop jobs",
      "description": "",
      "rows": 3,
      "columns": [
        {
          "id": "c1",
          "name": "Order",
          "type": "text",
          "required": true
        },
        {
          "id": "c2",
          "name": "Customer",
          "type": "text",
          "required": false
        }
      ]
    }
  ]
}

Use it when

To find a table's name and its column names before reading or writing rows.

What it does

Every table with its columns and row count.

What comes back

tables: each with its table_id, name, description, row count and columns. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call tables_list on https://api.conecto.chat/mcp/tables. Over REST:

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

Give this to your agent.

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