API suite
Global Locale API
Timezone and scheduling math, public holidays, live FX, VAT/GST rates, postal validation and cross-border checkout.
10Endpoints
2 composite$0.025 per call
8 atomic$0.005 per call
Endpoints
All 10 Global Locale endpoints
| Endpoint | Tier | Per call | Description |
|---|---|---|---|
/v1/global-scheduling-composite | composite | $0.025 | Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times |
/v1/cross-border-checkout-composite | composite | $0.025 | Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility |
/v1/timezone-converter | atomic | $0.005 | Convert a date-time between IANA timezones with offsets, abbreviations and DST flags |
/v1/business-hours-calc | atomic | $0.005 | Is a location open right now (or at a given instant) and when does it next open or close |
/v1/public-holiday-lookup | atomic | $0.005 | Public holidays for a country and year, with an optional is-holiday check for one date |
/v1/live-fx-rates | atomic | $0.005 | Live foreign-exchange rates for a base currency with optional amount conversion |
/v1/vat-gst-rate-lookup | atomic | $0.005 | Standard and reduced VAT/GST rates for a country with optional tax amount calculation |
/v1/postal-code-validator | atomic | $0.005 | Validate and normalize a postal code for a country |
/v1/country-iso-enricher | atomic | $0.005 | Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone |
/v1/distance-haversine-calc | atomic | $0.005 | Great-circle distance, initial bearing and midpoint between two coordinates |
Access
Three ways to call it
RapidAPI$0 to startSubscribe on the marketplace listing; the free Basic plan includes 15 requests per month. Open the listing.
Direct API keyX-Caelara-KeySend the key as a header on every request to https://geo.caelaralabs.com. Request a key.
Keyless x402 USDC$0.005 / $0.025 on BaseAtomic / composite per call. A call without credentials returns HTTP 402 with payment terms; pay in USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base and retry with
X-PAYMENT.Model Context Protocol
Remote MCP server
Connect an MCP client over Streamable HTTP with no local install. Endpoint https://geo.caelaralabs.com/mcp, listed in the Official MCP Registry as com.caelaralabs/geo. initialize and tools/list work without credentials; tool calls need an API key sent as X-Caelara-Key. Keyless x402 payment applies to the direct HTTP routes, not to MCP tool calls.
{
"mcpServers": {
"caelara-geo": {
"type": "http",
"url": "https://geo.caelaralabs.com/mcp",
"headers": {
"X-Caelara-Key": "${CAELARA_KEY}"
}
}
}
}