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

EndpointTierPer callDescription
/v1/global-scheduling-compositecomposite$0.025Find 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-compositecomposite$0.025Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility
/v1/timezone-converteratomic$0.005Convert a date-time between IANA timezones with offsets, abbreviations and DST flags
/v1/business-hours-calcatomic$0.005Is a location open right now (or at a given instant) and when does it next open or close
/v1/public-holiday-lookupatomic$0.005Public holidays for a country and year, with an optional is-holiday check for one date
/v1/live-fx-ratesatomic$0.005Live foreign-exchange rates for a base currency with optional amount conversion
/v1/vat-gst-rate-lookupatomic$0.005Standard and reduced VAT/GST rates for a country with optional tax amount calculation
/v1/postal-code-validatoratomic$0.005Validate and normalize a postal code for a country
/v1/country-iso-enricheratomic$0.005Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone
/v1/distance-haversine-calcatomic$0.005Great-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}" } } } }