DiscoveryFree tier

list_sources

List loaded data sources from the catalog. Filter by theme schema, geometry type, or spatial-resolvability flags. The agent's first call when it needs to know what's in here.

Use cases

  • Bootstrap an agent: get the full list of available datasets before any spatial call.
  • Show only joinable sources (joinable_only=true) when you need a geometry-resolvable layer for a tabular source.
  • Filter by theme="healthcare" to scope downstream queries to a single domain.
  • Power a UI that lets users browse the catalog by geometry type (Point / MultiPolygon / MultiLineString).

Arguments

NameTypeRequiredDescription
theme string optional Filter by theme schema (healthcare, commerce, risk, environment, …).
geometry_type string optional Point, MultiPolygon, or MultiLineString.
joinable_only boolean optional Only sources whose geo_join_table is populated.
location_resolvable boolean optional Only sources spatially resolvable (have lat/lon or a join target).
limit integer optional Max rows.
Range 1 – 500. Default 100.

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": "list_sources",
      "arguments": {
            "theme": "healthcare",
            "limit": 5
      }
    }
  }'

Example response

JSON-RPC 2.0 result
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  { \"source_id\": \"minsalute_strutture_sanitarie\", \"theme\": \"healthcare\", \"geometry_type\": \"Point\", \"row_count\": 12435, \"qualified_table\": \"healthcare.minsalute_strutture_sanitarie\" },\n  { \"source_id\": \"agenas_strutture_residenziali\", \"theme\": \"healthcare\", \"geometry_type\": \"Point\", \"row_count\": 8721, \"qualified_table\": \"healthcare.agenas_strutture_residenziali\" }\n]"
      }
    ]
  }
}

Prompts to try

Drop these into Claude Desktop, Cursor, or any MCP-aware client wired to https://mcp.qubitdata.it/mcp.

  • Claude Desktop
    Which healthcare datasets are loaded? Show the table names and row counts.
  • Cursor
    Use list_sources with joinable_only=true to find sources I can geo-resolve via JOIN.
  • Custom MCP client
    List every dataset whose geometry_type is MultiPolygon.

Related tools

describe_table · relationships_graph · bbox_of

Get started

Sign up for a free key to call this tool from your agent. Need a wider geo cap or higher quota? See pricing.

Last updated: