`pois_near`

Pack: overpass · Endpoint: https://gateway.pipeworx.io/overpass/mcp

Find OSM points of interest within a radius of a lat/lon. Pass an OSM key=value tag like “amenity=cafe”, “shop=bakery”, “tourism=museum”, or just “amenity” to match any value. Returns nodes with names, tags, and coordinates.

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Center latitude
`longitude`	number	yes	Center longitude
`radius_m`	number	no	Search radius in metres (1-10000, default 1000)
`tag`	string	yes	OSM tag filter (e.g., “amenity=cafe”, “shop”, “tourism=museum”)
`limit`	number	no	Max results (1-500, default 100)

Example call

Arguments

{
  "latitude": 48.8566,
  "longitude": 2.3522,
  "tag": "amenity=cafe",
  "radius_m": 500
}

curl

curl -X POST https://gateway.pipeworx.io/overpass/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pois_near","arguments":{"latitude":48.8566,"longitude":2.3522,"tag":"amenity=cafe","radius_m":500}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('pois_near', {
  "latitude": 48.8566,
  "longitude": 2.3522,
  "tag": "amenity=cafe",
  "radius_m": 500
});

More examples

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "tag": "shop=bakery",
  "radius_m": 2000,
  "limit": 50
}

Response shape

Always returns: center, radius_m, tag, count, elements

Field	Type	Description
`center`	object	Search center coordinates
`radius_m`	number	Search radius in metres
`tag`	string	OSM tag filter used
`count`	number	Number of POIs found
`elements`	array	Array of POI elements

Full JSON Schema

{
  "type": "object",
  "properties": {
    "center": {
      "type": "object",
      "description": "Search center coordinates",
      "properties": {
        "latitude": {
          "type": "number",
          "description": "Center latitude"
        },
        "longitude": {
          "type": "number",
          "description": "Center longitude"
        }
      },
      "required": [
        "latitude",
        "longitude"
      ]
    },
    "radius_m": {
      "type": "number",
      "description": "Search radius in metres"
    },
    "tag": {
      "type": "string",
      "description": "OSM tag filter used"
    },
    "count": {
      "type": "number",
      "description": "Number of POIs found"
    },
    "elements": {
      "type": "array",
      "description": "Array of POI elements",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "node",
              "way",
              "relation"
            ],
            "description": "OSM element type"
          },
          "id": {
            "type": "number",
            "description": "OSM element ID"
          },
          "osm_url": {
            "type": "string",
            "description": "Direct link to element on OpenStreetMap"
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Latitude coordinate or null if unavailable"
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Longitude coordinate or null if unavailable"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "OSM name tag value or null"
          },
          "tags": {
            "type": "object",
            "description": "All OSM tags as key-value pairs"
          }
        },
        "required": [
          "type",
          "id",
          "osm_url",
          "latitude",
          "longitude",
          "name",
          "tags"
        ]
      }
    }
  },
  "required": [
    "center",
    "radius_m",
    "tag",
    "count",
    "elements"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

pois_near