`nearby`

Pack: entreprises-fr · Endpoint: https://gateway.pipeworx.io/entreprises-fr/mcp

List French business establishments within a radius (0.05–50 km) of a lat/lon coordinate. Optionally filter by APE/NAF sector code. Returns SIREN, denomination, addresses, and sector codes for each nearby unit.

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Latitude (WGS84)
`longitude`	number	yes	Longitude (WGS84)
`radius_km`	number	no	Search radius in km, 0.05-50 (default 1)
`ape`	string	no	Filter to a specific APE/NAF code
`per_page`	number	no	Page size, 1-25 (default 10)
`page`	number	no	1-based page (default 1)

Example call

Arguments

{
  "latitude": 48.8566,
  "longitude": 2.3522
}

curl

curl -X POST https://gateway.pipeworx.io/entreprises-fr/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nearby","arguments":{"latitude":48.8566,"longitude":2.3522}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nearby', {
  "latitude": 48.8566,
  "longitude": 2.3522
});

More examples

{
  "latitude": 43.2965,
  "longitude": 5.3698,
  "radius_km": 5,
  "ape": "4711Z"
}

Response shape

Field	Type	Description
`results`	array	Array of nearby establishments
`total_results`	number	Total number of nearby establishments
`page`	number	Current page number
`per_page`	number	Results per page

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of nearby establishments",
      "items": {
        "type": "object",
        "properties": {
          "siret": {
            "type": "string",
            "description": "14-digit SIRET identifier"
          },
          "siren": {
            "type": "string",
            "description": "9-digit SIREN of parent unit"
          },
          "denomination": {
            "type": "string",
            "description": "Establishment or unit name"
          },
          "enseigne": {
            "type": "string",
            "description": "Trading name"
          },
          "ape": {
            "type": "string",
            "description": "APE/NAF activity code"
          },
          "address": {
            "type": "string",
            "description": "Establishment address"
          },
          "postal_code": {
            "type": "string",
            "description": "5-digit postal code"
          },
          "city": {
            "type": "string",
            "description": "City name"
          },
          "latitude": {
            "type": "number",
            "description": "WGS84 latitude"
          },
          "longitude": {
            "type": "number",
            "description": "WGS84 longitude"
          },
          "distance_km": {
            "type": "number",
            "description": "Distance from search center in km"
          },
          "etat_administratif": {
            "type": "string",
            "description": "Status (A=active, R=closed)"
          }
        }
      }
    },
    "total_results": {
      "type": "number",
      "description": "Total number of nearby establishments"
    },
    "page": {
      "type": "number",
      "description": "Current page number"
    },
    "per_page": {
      "type": "number",
      "description": "Results per page"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "entreprises-fr": {
      "url": "https://gateway.pipeworx.io/entreprises-fr/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

nearby