Countries, admin units, Turkey's official mahalle list, boundaries, timezones, postal codes, phones
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Without it the keyless tools work within a daily free quota; the other tools need a key.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
The nearest populated places (GeoNames cities500: 500 inhabitants or more, or a seat of government) with distance in km, population and path, nearest first. 503 NOT_READY on a dataset built before the feature. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language.
Default 10
Kilometres, default 100; places farther away are not returned
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http geo https://api.forlab.io/geo/mcp
Headers
Authorization (optional, not in the config above): Optional. Without it the keyless tools work within a daily free quota; the other tools need a key.The nearest populated places (GeoNames cities500: 500 inhabitants or more, or a seat of government) with distance in km, population and path, nearest first. 503 NOT_READY on a dataset built before the feature. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| lat* | number | |
| lon* | number | |
| lang | string | Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language. |
| limit | integer | Default 10 |
| radius | integer | Kilometres, default 100; places farther away are not returned |
{
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"examples": [
38.4237
]
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"examples": [
27.1428
]
},
"lang": {
"type": "string",
"examples": [
"tr,en"
],
"description": "Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"examples": [
10
],
"description": "Default 10"
},
"radius": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"examples": [
50
],
"description": "Kilometres, default 100; places farther away are not returned"
}
},
"additionalProperties": false
}The postal codes nearest to a point (GeoNames), nearest first, with distance in km. 503 NOT_READY on a dataset built before the feature. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| lat* | number | |
| lon* | number | |
| limit | integer | Default 10 |
| radius | integer | Kilometres, default 50 |
{
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"examples": [
38.4237
]
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"examples": [
27.1428
]
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"examples": [
10
],
"description": "Default 10"
},
"radius": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"examples": [
50
],
"description": "Kilometres, default 50"
}
},
"additionalProperties": false
}Every unit whose land contains the point (country, region, county; in Turkey also mahalle), most general first; match is none at sea or outside the loaded countries. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| lat* | number | |
| lon* | number |
{
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"examples": [
38.4237
]
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"examples": [
27.1428
]
}
},
"additionalProperties": false
}The caller's own location, from Cloudflare's IP geolocation (edge only: the Worker at api.forlab.io/geo answers it, the Python service does not). Only the address the request comes from is looked up, never one you send. The location is approximate, city level at best, and a value Cloudflare does not know is null. `country` is the country's place in this dataset (same shape as /v1/contains), null when the dataset lacks it. Replies carry `Cache-Control: private, no-store`. Works without a key within a daily free quota.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}One country: names, calling codes, currencies, languages, timezones, levels with coverage. Works without a key within a daily free quota.
| Argument | Type | Description |
|---|---|---|
| cc* | string | |
| lang | string | Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language. |
{
"type": "object",
"required": [
"cc"
],
"properties": {
"cc": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"TR"
]
},
"lang": {
"type": "string",
"examples": [
"tr,en"
],
"description": "Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language."
}
},
"additionalProperties": false
}Dataset version, public tileset URLs, sources and licences. Works without a key within a daily free quota.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}One place with its path (ancestors, country first). Works without a key within a daily free quota.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| lang | string | Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"examples": [
"TR-35"
]
},
"lang": {
"type": "string",
"examples": [
"tr,en"
],
"description": "Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language."
}
},
"additionalProperties": false
}The boundary as one GeoJSON Feature (application/geo+json, not wrapped in `data`), ready for MapLibre. properties: id, name, detail, dataset_version, attribution. Sent gzip-compressed when the client accepts gzip. A reply over 200 KB, or detail=full, is not inlined: the result is its REST URL and size, to download outside the chat. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| detail | any | overview is for country and region maps, standard for a city view, full is the source geometry |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"examples": [
"TR-35"
]
},
"detail": {
"enum": [
"overview",
"standard"
],
"default": "overview",
"examples": [
"overview"
],
"description": "overview is for country and region maps, standard for a city view, full is the source geometry"
}
},
"additionalProperties": false
}IANA timezone of a point (timezone-boundary-builder polygons: land and territorial waters) with the current UTC offset, DST flag and local time; match is none on the open sea. `dst` is true when the zone's clocks are advanced at that instant: its offset is the larger of the two it shows in that year (1 January and 1 July); a zone with one offset all year is never DST (Morocco: +01:00 and the +00:00 of Ramadan are both `dst: false`). When zones share an edge or overlap, `ambiguous` is true, `timezone` and the other fields are the first zone by name and `candidates` lists all of them (each with its own offset, dst and local time). 503 NOT_READY on a dataset built before the feature. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| lat* | number | |
| lon* | number |
{
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"examples": [
38.4237
]
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"examples": [
27.1428
]
}
},
"additionalProperties": false
}All countries and dependencies with their profile. Works without a key within a daily free quota.
| Argument | Type | Description |
|---|---|---|
| lang | string | Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language. |
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"examples": [
"tr,en"
],
"description": "Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language."
}
},
"additionalProperties": false
}Children of a place (`parent`) or a name prefix search (`q`); exactly one of the two. Works without a key within a daily free quota.
| Argument | Type | Description |
|---|---|---|
| q | string | Name prefix (e.g. kuşa); case, diacritics and Turkish i/ı are ignored |
| lang | string | Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language. |
| limit | integer | Default 1000 for parent, 20 (max 100) for q |
| offset | integer | |
| parent | string | Country, region (il), county (ilçe) ID. An ilçe lists its official mahalle and köy (TÜİK); places off that list are not children. |
| country | string | Only with q, e.g. TR |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 100,
"description": "Name prefix (e.g. kuşa); case, diacritics and Turkish i/ı are ignored"
},
"lang": {
"type": "string",
"examples": [
"tr,en"
],
"description": "Comma-separated BCP 47 tags (max 5), e.g. en,de. Adds `names`; null means we do not have that language."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"examples": [
10
],
"description": "Default 1000 for parent, 20 (max 100) for q"
},
"offset": {
"type": "integer",
"minimum": 0,
"examples": [
0
]
},
"parent": {
"type": "string",
"examples": [
"TR-35"
],
"description": "Country, region (il), county (ilçe) ID. An ilçe lists its official mahalle and köy (TÜİK); places off that list are not children."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Only with q, e.g. TR"
}
},
"additionalProperties": false
}The places of a postal code (GeoNames); case, spaces and hyphens in the code are ignored. `partial` is true for the countries GeoNames gives only in part (CA, NL, GB: first part; CL, CN, AR: first digits; IE, MT: first letters; BR: major codes). 503 NOT_READY on a dataset built before the feature. Needs an API key: the MCP client sends `Authorization: Bearer <key>`.
| Argument | Type | Description |
|---|---|---|
| code* | string | |
| limit | integer | Default 100 |
| offset | integer | |
| country* | string |
{
"type": "object",
"required": [
"country",
"code"
],
"properties": {
"code": {
"type": "string",
"examples": [
"35030"
],
"maxLength": 20
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"examples": [
10
],
"description": "Default 100"
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"examples": [
0
]
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"TR"
]
}
},
"additionalProperties": false
}Validate and format a phone number. Works without a key within a daily free quota.
| Argument | Type | Description |
|---|---|---|
| number* | string | E.164 with a leading +, or national with country; in a URL query send the + as %2B |
| country | string | Default region for numbers without a + prefix |
{
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"examples": [
"+905321234567"
],
"maxLength": 40,
"description": "E.164 with a leading +, or national with country; in a URL query send the + as %2B"
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"TR"
],
"description": "Default region for numbers without a + prefix"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.