Location Search & Location Key Lookup (by City or Place Name)
omnial/search-locations
Given a place name (city, town, or region), returns every matching location: its location key (usable as input to other location-keyed lookups), geographic coordinates and elevation, time zone, country/region/administrative-area names, and a rank indicating how prominent a match it is -- an empty list when nothing matches.
activeper callv2
Price
Up to $0.0137 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from AccuWeather.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/search-locations" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-locations" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-locations", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-locations", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0137 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Location name or query to search for (e.g., 'Istanbul', 'London', 'New York')"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Key": {
"type": "string",
"description": "The location key. Pass this to other location-keyed lookups (e.g. a weather-by-location tool) instead of re-resolving the name each time."
},
"Rank": {
"type": "number",
"description": "Lower value = more prominent/likely match. Observed 10 for London, UK (the best-known match for 'London') up to 600 for small same-named towns in the same result set."
},
"Type": {
"type": "string",
"description": "e.g. 'City' on every real result observed."
},
"Region": {
"type": "object",
"properties": {
"ID": {
"type": "string"
},
"EnglishName": {
"type": "string"
},
"LocalizedName": {
"type": "string"
}
},
"additionalProperties": true
},
"Country": {
"type": "object",
"properties": {
"ID": {
"type": "string",
"description": "ISO-style two-letter country code, e.g. 'GB'."
},
"EnglishName": {
"type": "string"
},
"LocalizedName": {
"type": "string"
}
},
"additionalProperties": true
},
"IsAlias": {
"type": "boolean"
},
"DataSets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Names of data products available for this location (e.g. 'Alerts', 'MinuteCast', 'Radar'); varies per location."
},
"TimeZone": {
"type": "object",
"properties": {
"Code": {
"type": "string",
"description": "e.g. 'BST', 'EDT'."
},
"Name": {
"type": "string",
"description": "IANA-style zone name, e.g. 'Europe/London'."
},
"GmtOffset": {
"type": "number"
},
"IsDaylightSaving": {
"type": "boolean"
},
"NextOffsetChange": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp of the next daylight-saving transition for this zone, or null when the zone observes no DST (observed null for several non-DST-observing zones in a London search)."
}
},
"additionalProperties": true
},
"EnglishName": {
"type": "string"
},
"GeoPosition": {
"type": "object",
"properties": {
"Latitude": {
"type": "number"
},
"Elevation": {
"type": "object",
"properties": {
"Metric": {
"type": "object",
"properties": {
"Unit": {
"type": "string"
},
"Value": {
"type": "number"
},
"UnitType": {
"type": "number"
}
},
"additionalProperties": true
},
"Imperial": {
"type": "object",
"properties": {
"Unit": {
"type": "string"
},
"Value": {
"type": "number"
},
"UnitType": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"Longitude": {
"type": "number"
}
},
"additionalProperties": true
},
"LocalizedName": {
"type": "string"
},
"PrimaryPostalCode": {
"type": "string",
"description": "A representative postal code for the location's own area, not a person's or business's mailing address -- observed as an empty string for several non-US/non-UK results."
},
"AdministrativeArea": {
"type": "object",
"properties": {
"ID": {
"type": "string"
},
"Level": {
"type": "number"
},
"CountryID": {
"type": "string"
},
"EnglishName": {
"type": "string"
},
"EnglishType": {
"type": "string",
"description": "e.g. 'State', 'Province', 'London Borough'."
},
"LocalizedName": {
"type": "string"
},
"LocalizedType": {
"type": "string"
}
},
"description": "The location's top-level subdivision -- a US state, a Canadian province, or similar; 'London Borough' observed for London, UK.",
"additionalProperties": true
},
"SupplementalAdminAreas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Level": {
"type": "number"
},
"EnglishName": {
"type": "string"
},
"LocalizedName": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Zero or more secondary administrative subdivisions; observed empty for several results."
}
},
"additionalProperties": true
},
"description": "Zero or more matching locations. Empty on a query with no match (e.g. a gibberish query) -- not an error. Order reflects `Rank` (lower is a more prominent/likely match), not necessarily distance or alphabetical order."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed, including the zero-match query."
}
},
"description": "The search result.",
"additionalProperties": true
}