Contract
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.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 the London-search fixture). A timestamp, not a phone number or other contact detail."
}
},
"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 (confirmed by the gibberish-empty fixture) -- 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, as returned at routing.responseResultPath ($.output).",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.01365 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 8, 2026