`cells_in_area`

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

List cell towers inside a bounding box. Bounding box format: “lat_sw,lon_sw,lat_ne,lon_ne”. OpenCellID caps results per call — narrow the bbox if you need detail.

Parameters

Name	Type	Required	Description
`bbox`	string	yes	Bounding box “lat_sw,lon_sw,lat_ne,lon_ne”
`mcc`	number	no	Restrict to a country (Mobile Country Code)
`mnc`	number	no	Restrict to a network within MCC
`limit`	number	no	Max records (default 1000, server-capped)

Example call

Arguments

{
  "bbox": "37.7749,-122.4194,37.8049,-122.3894"
}

curl

curl -X POST https://gateway.pipeworx.io/opencellid/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cells_in_area","arguments":{"bbox":"37.7749,-122.4194,37.8049,-122.3894"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('cells_in_area', {
  "bbox": "37.7749,-122.4194,37.8049,-122.3894"
});

More examples

{
  "bbox": "37.7749,-122.4194,37.8049,-122.3894",
  "mcc": 310,
  "mnc": 410,
  "limit": 500
}

Response shape

Always returns: bbox, count, cells

Field	Type	Description
`bbox`	string	Bounding box used in query
`count`	number	Number of cell towers found
`cells`	array	List of cell towers in area

Full JSON Schema

{
  "type": "object",
  "properties": {
    "bbox": {
      "type": "string",
      "description": "Bounding box used in query"
    },
    "count": {
      "type": "number",
      "description": "Number of cell towers found"
    },
    "cells": {
      "type": "array",
      "description": "List of cell towers in area",
      "items": {
        "type": "object",
        "properties": {
          "mcc": {
            "type": [
              "number",
              "null"
            ],
            "description": "Mobile Country Code"
          },
          "mnc": {
            "type": [
              "number",
              "null"
            ],
            "description": "Mobile Network Code"
          },
          "lac": {
            "type": [
              "number",
              "null"
            ],
            "description": "Location Area Code"
          },
          "cell_id": {
            "type": [
              "number",
              "null"
            ],
            "description": "Cell ID"
          },
          "radio": {
            "type": [
              "string",
              "null"
            ],
            "description": "Radio type (GSM/UMTS/LTE/CDMA)"
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Cell tower latitude"
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Cell tower longitude"
          },
          "range_m": {
            "type": [
              "number",
              "null"
            ],
            "description": "Cell tower coverage range in meters"
          },
          "samples": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of samples collected"
          },
          "avg_signal_strength": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average signal strength"
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 timestamp of creation"
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 timestamp of last update"
          }
        },
        "required": [
          "mcc",
          "mnc",
          "lac",
          "cell_id",
          "radio",
          "latitude",
          "longitude",
          "range_m",
          "samples",
          "avg_signal_strength",
          "created_at",
          "updated_at"
        ]
      }
    }
  },
  "required": [
    "bbox",
    "count",
    "cells"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

cells_in_area