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
| Name | Type | Required | Description |
|---|---|---|---|
| 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: