DiscoveryFree

describe_table

Schema colonna per colonna di una tabella qualificata. Restituisce tipi, nullability, commenti curati dal data team e il row_count cached dal catalogo. Da chiamare prima di query_sql o prima di costruire operazioni geometriche.

Use cases

Pre-flight di una query SQL libera: conferma che la colonna esiste ed è del tipo che ti aspetti.
Scopri il target di geo-join per un dataset aggregato (es. statistiche ISTAT su sezioni censuarie).
Leggi i commenti curati prima di decidere se una metrica fa al caso tuo.
Stima il costo di una query controllando il row count cached prima di scansionare 50M di righe.

Arguments

Name	Type	Required	Description
qualified	string	required	Schema-qualified table name (e.g., `commerce.overture_places_italy`).

Example request

curl

bash

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $QUBITDATA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "describe_table",
      "arguments": {
            "qualified": "healthcare.minsalute_strutture_sanitarie"
      }
    }
  }'

Example response

JSON-RPC 2.0 result

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"qualified\": \"healthcare.minsalute_strutture_sanitarie\",\n  \"row_count\": 12435,\n  \"columns\": [\n    { \"name\": \"codice_struttura\", \"type\": \"text\", \"nullable\": false, \"comment\": \"Codice univoco struttura sanitaria (Min. Salute)\" },\n    { \"name\": \"denominazione\", \"type\": \"text\", \"nullable\": false, \"comment\": null },\n    { \"name\": \"geometry\", \"type\": \"geometry(Point,4326)\", \"nullable\": true, \"comment\": \"Centroide ufficiale\" }\n  ]\n}"
      }
    ]
  }
}

Prompt da provare

Incollali in Claude Desktop, Cursor o un qualsiasi client MCP collegato a https://mcp.qubitdata.it/mcp.

Claude Desktop

Descrivi commerce.overture_places_italy — su quali colonne posso filtrare?
Cursor

Usa describe_table per confermare che risk.ingv_iside_terremoti ha una colonna magnitudo prima di scrivere SQL.
Client MCP custom

Mostra lo schema di census_geom.istat_basi_territoriali.

Get started

Registrati per una free key e richiama il tool dal tuo agente. Servono cap geografici più ampi o quota più alta? Vedi pricing.

Last updated: 2026-05-04