# MeetZone

> Find meeting times that overlap working hours across several IANA time zones, DST-aware. Remote MCP server for AI agents (free tier) plus a JSON API on RapidAPI.

## For AI agents

- [MCP server](https://meetzone-api.mike-tusa.workers.dev/mcp): remote MCP over Streamable HTTP (POST only, stateless, JSON responses). Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. Tools `find_meeting_overlap` (zones, work_hours, days, duration_minutes, limit, include_ics) and `search_timezones` (q, limit, date). Read-only. Client config (most MCP clients accept this; some use a different format, for example VS Code uses a `servers` key): `{"mcpServers":{"meetzone-api":{"type":"http","url":"https://meetzone-api.mike-tusa.workers.dev/mcp"}}}`
- [OpenAPI 3.1 spec](https://meetzone-api.mike-tusa.workers.dev/openapi.json): machine-readable description of this origin's routes
- [Server card](https://meetzone-api.mike-tusa.workers.dev/.well-known/mcp/server-card.json)

## JSON API (RapidAPI)

- The JSON API (`POST /v1/overlap`, `GET /v1/zones/search`, `GET /v1/health`) is served through RapidAPI: https://rapidapi.com/miketusa/api/meetzone-timezone-meeting-overlap-api. Direct calls to https://meetzone-api.mike-tusa.workers.dev/v1/... without the RapidAPI gateway return HTTP 401 `unauthorized`.
- Errors: { "ok": false, "error": { "code", "message", "details"? } } with 400 validation_error / plan_limit_exceeded, 404 unknown_zone / not_found, 401 unauthorized, 500 internal_error.

## Limits and pricing

- MCP (free tier, no key): up to 5 zones, 7 days, 5 ranked slots and 5 search results per call; about 10 tool calls per minute per IP (HTTP 200 tool error with retryAfterSeconds and Retry-After). Other MCP messages (initialize, tools/list, ping, server/discover) are capped at about 120/min per IP (HTTP 429 + Retry-After). Sending an API key to /mcp returns HTTP 401.
- RapidAPI BASIC: same caps as MCP, with the monthly quota shown on RapidAPI. RapidAPI PRO ($25/month): up to 12 zones, 31 days, 20 slots, 50 search results.

## Optional

- [Privacy](https://meetzone-api.mike-tusa.workers.dev/v1/privacy)
- Contact: digitalpromohub.support@gmail.com