`fr_buildings_near`

Pack: france-geodata · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fr_buildings_near for the schema, then POST the same URL with its arguments for the data.

Buildings within a radius (max 500 m) of a point in France, from the IGN BD TOPO building layer. Each building has GeoJSON polygon geometry, height (m), floors, dwellings, use, nature and construction dates. Reports the total matched and flags truncation. Use for “buildings within 200 m of X” and GeoJSON export of them.

Parameters

Name	Type	Required	Description
`lat`	number	yes	Latitude (WGS84), e.g. 45.764.
`lon`	number	yes	Longitude (WGS84), e.g. 4.8357.
`radius_m`	number	no	Search radius in metres, 1-${MAX_RADIUS_M} (default 200).
`limit`	number	no	Max buildings returned, 1-${MAX_BUILDINGS} (default 50). Nearest first.
`include_geometry`	boolean	no	Include polygon geometry (default true). Set false for attributes only.

Example call

Arguments

{
  "lat": 45.764,
  "lon": 4.8357,
  "radius_m": 200,
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/france-geodata/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fr_buildings_near","arguments":{"lat":45.764,"lon":4.8357,"radius_m":200,"limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('fr_buildings_near', {
  "lat": 45.764,
  "lon": 4.8357,
  "radius_m": 200,
  "limit": 10
});

Response shape

Field	Type	Description
`found`	boolean
`source`	string
`center`	object
`radius_m`	number
`total_matched`	number
`returned`	number
`truncated`	boolean
`note`	string
`buildings`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "source": {
      "type": "string"
    },
    "center": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        }
      },
      "additionalProperties": true
    },
    "radius_m": {
      "type": "number"
    },
    "total_matched": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "truncated": {
      "type": "boolean"
    },
    "note": {
      "type": "string"
    },
    "buildings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "distance_m": {
            "type": "number"
          },
          "height_m": {
            "type": "number"
          },
          "floors": {
            "type": [
              "number",
              "null"
            ]
          },
          "dwellings": {
            "type": [
              "number",
              "null"
            ]
          },
          "use": {
            "type": "string"
          },
          "use_secondary": {
            "type": [
              "string",
              "null"
            ]
          },
          "nature": {
            "type": "string"
          },
          "light_construction": {
            "type": "boolean"
          },
          "first_seen": {
            "type": [
              "string",
              "null"
            ]
          },
          "rnb_ids": {
            "type": "string"
          },
          "geometry": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      }
                    }
                  }
                }
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the france-geodata pack

{
  "mcpServers": {
    "france-geodata": {
      "url": "https://gateway.pipeworx.io/france-geodata/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

fr_buildings_near