Contract
input_schema.json
{
"type": "object",
"required": [
"muid",
"locale"
],
"properties": {
"muid": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{1,20}$"
},
"maxItems": 2,
"minItems": 1,
"description": "One or two Apple Maps place IDs (the auid= number in an Apple Maps place link), each a string of digits."
},
"locale": {
"enum": [
"en-US"
],
"type": "string",
"description": "The result language; only \"en-US\" (US English) is offered."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"place_results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"muid": {
"type": "string",
"description": "The Apple Maps place ID."
},
"type": {
"type": "string",
"description": "The place's category."
},
"about": {
"type": "string",
"description": "A short about text, where present."
},
"title": {
"type": "string",
"description": "The place's name."
},
"types": {
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"type": "number",
"description": "The Apple rating, out of max_rating."
},
"address": {
"type": "string",
"description": "The full street address."
},
"ratings": {
"type": "object",
"properties": {
"values": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"rating": {
"type": "number"
},
"reviews": {
"type": "number"
},
"category": {
"type": "string",
"description": "Absent on the overall row."
},
"max_rating": {
"type": "number"
}
}
},
"description": "The overall rating, then any per-category ratings."
}
}
},
"reviews": {
"type": "number",
"description": "The number of ratings."
},
"website": {
"type": "string",
"description": "The place's own website."
},
"place_id": {
"type": "string",
"description": "Apple's alternate place ID."
},
"position": {
"type": "number"
},
"timezone": {
"type": "string"
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
}
},
"max_rating": {
"type": "number"
},
"open_state": {
"type": "string",
"description": "Open or closed now, where present."
},
"weekly_hours": {
"type": "object",
"properties": {
"friday": {
"type": "array",
"items": {
"type": "string"
}
},
"monday": {
"type": "array",
"items": {
"type": "string"
}
},
"sunday": {
"type": "array",
"items": {
"type": "string"
}
},
"tuesday": {
"type": "array",
"items": {
"type": "string"
}
},
"saturday": {
"type": "array",
"items": {
"type": "string"
}
},
"thursday": {
"type": "array",
"items": {
"type": "string"
}
},
"wednesday": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "Opening hours per weekday, where present."
},
"gps_coordinates": {
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
}
},
"phone_formatted": {
"type": "string",
"description": "The published phone number."
},
"structured_address": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"locality": {
"type": "string",
"description": "The city."
},
"post_code": {
"type": "string"
},
"country_code": {
"type": "string"
},
"full_thoroughfare": {
"type": "string",
"description": "Street number and name."
},
"administrative_area": {
"type": "string",
"description": "The state or region."
},
"sub_administrative_area": {
"type": "string",
"description": "The county or similar sub-region, as Apple Maps lists it."
}
}
}
}
},
"description": "One entry per requested place, in request order."
}
},
"description": "The places' Apple Maps listings."
}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.001 |
- 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
- Oct 11, 2026