Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times
GET /v1/global-scheduling-composite on geo.caelaralabs.com
Request parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
timezones | query | string | yes | Comma list of IANA timezones; the first is the organizer whose local day anchors the search |
date | query | string | no | Organizer-local date YYYY-MM-DD (default today) |
duration_minutes | query | integer | no | Meeting length in minutes (default 60) |
work_start | query | string | no | Working day start HH:MM (default 09:00) |
work_end | query | string | no | Working day end HH:MM (default 17:00) |
countries | query | string | no | Comma list of ISO alpha-2 codes aligned with timezones, used to skip public holidays |
Call it with an API key
Send your key as X-Caelara-Key. Responses are JSON; when an upstream source is unavailable the API still answers HTTP 200 with "partial": true instead of a server error.
Use it as an MCP tool
Tool name global_scheduling_composite on the remote server https://geo.caelaralabs.com/mcp (registry ID com.caelaralabs/geo). MCP tool calls need an X-Caelara-Key API key; to pay per call in USDC, use the direct HTTP route in the x402 section below.
Pay per call in USDC on Base
No account needed. An unauthenticated request returns HTTP 402 with an X-Payment-Required: x402 header and a JSON body whose accepts entry carries scheme exact, network base, maxAmountRequired 25000 (0.025 USDC, 6 decimals), the USDC asset and the payTo address. Settlement happens only after a successful response.