Spatial queryPro tier

spatial_search

Cross-source POI lookup within a radius around any (lat, lon) coordinate. Returns the closest features from gis.points — a unified table of millions of Italian points-of-interest covering healthcare, education, commerce, mobility, culture, environment, and more — ranked by distance, with optional theme filter.

Use cases

  • Enrich a property listing with the count and identity of nearby schools, pharmacies, supermarkets, and transit stops.
  • Power an AI agent that answers “what's around this address?” without manual SQL or a separate POI database.
  • Build a quick neighborhood-quality score by combining counts of essential services within walking distance.
  • Filter to a single theme (e.g., healthcare) for domain-specific catchment analysis.

Arguments

NameTypeRequiredDescription
lat number required Latitude in WGS84 (EPSG:4326).
lon number required Longitude in WGS84.
radius_m number required Search radius in meters.
Range 1 – 50,000. Tier-capped: 1km Free, 5km Pro, 25km Max.
theme string optional Filter by theme schema (healthcare, commerce, education, mobility, culture, environment, …).
limit integer optional Max results.
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": "spatial_search",
      "arguments": {
            "lat": 45.4642,
            "lon": 9.19,
            "radius_m": 800,
            "theme": "healthcare",
            "limit": 20
      }
    }
  }'

Example response

JSON-RPC 2.0 result
json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  { \"name\": \"Farmacia del Duomo\", \"source\": \"healthcare.farmacie\", \"theme\": \"healthcare\", \"distance_m\": 142, \"lat\": 45.4634, \"lon\": 9.1908 },\n  { \"name\": \"Ospedale Maggiore Policlinico\", \"source\": \"healthcare.minsalute_strutture\", \"theme\": \"healthcare\", \"distance_m\": 612, \"lat\": 45.4587, \"lon\": 9.1932 }\n]"
      }
    ]
  }
}

Prompts to try

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

  • Claude Desktop
    What healthcare facilities are within 1km of Piazza Duomo, Milan? List name and distance.
  • Cursor
    Use spatial_search to find the 30 nearest schools within 2km of (45.4642, 9.1900).
  • Custom MCP client
    Pull all POIs within 500m of the user's saved address; group by theme.

Related tools

nearest_n · points_in_polygon · site_profile · density_grid

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: