Вход

API календаря для AI-агентов с управлением событиями, доступностью и настройкой Google/Microsoft.

нужен ключ схема сломана Удалённый · Streamable HTTP API-ключ ИИ и модели Продуктивность Официальный реестр · 11 просмотров

Что умеет

API календаря для AI-агентов с управлением событиями, доступностью и настройкой Google/Microsoft.

Перевод каталога (LLM) · показать оригинал автора

Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.

Подключение

Удалённый сервер: клиент обращается по адресу, код на вашей машине не запускается.

Claude Desktop

claude_desktop_config.json

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Вставьте блок mcpServers в файл конфигурации своего клиента. Ключи не входят в файл: вместо SET_LOCALLY подставьте свои значения.

{
    "mcpServers": {
        "ai-chronary-mcp": {
            "url": "https://api.chronary.ai/mcp",
            "headers": {
                "Authorization": "Bearer SET_LOCALLY"
            }
        }
    }
}

Какие ключи понадобятся

CHRONARY_API_KEY

Каталог хранит только имена переменных. Значения задаются у вас локально и никогда не попадают на сервер.

Вызов без установки — через шлюз

Агент вызывает инструменты этого сервера через https://www.n2j.ru/mcphub/mcp: hub_call_tool {"server":"ai-chronary-mcp","tool":"…","arguments":{…}} Сервер требует авторизации — ключ задаётся на стороне каталога.

https://api.chronary.ai/mcp

Инструменты

54 схем · ≈ 13 387 условных токенов

create_agent

Register your agent (AI assistant, human participant, or resource) with Chronary so it can own calendars, events, and webhooks.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "name",
        "type"
    ],
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "Display name for the agent"
        },
        "type": {
            "enum": [
                "ai",
                "human",
                "resource"
            ],
            "type": "string",
            "description": "Agent type"
        },
        "description": {
            "type": "string",
            "description": "Optional description"
        }
    }
}

list_agents

List all agents in your organization

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "type": {
            "enum": [
                "ai",
                "human",
                "resource"
            ],
            "type": "string",
            "description": "Filter by agent type"
        },
        "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        },
        "status": {
            "enum": [
                "active",
                "paused",
                "decommissioned"
            ],
            "type": "string",
            "description": "Filter by status"
        }
    }
}

create_calendar

Create a calendar to hold events and track availability. Calendars are required before creating events — call this first when setting up a new agent. An agent can have multiple calendars (e.g. "Work", "Personal"). Org-level calendars (no agent id) can be used as shared resources like meeting rooms.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "name",
        "timezone"
    ],
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "Calendar name"
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID to own this calendar (omit for org-level)"
        },
        "timezone": {
            "type": "string",
            "minLength": 1,
            "description": "IANA timezone (e.g. America/New_York)"
        },
        "default_reminders": {
            "anyOf": [
                {
                    "type": "array",
                    "items": {
                        "type": "integer",
                        "maximum": 40320,
                        "minimum": 1
                    },
                    "maxItems": 5
                },
                {
                    "type": "null"
                }
            ],
            "description": "Default reminder offsets in minutes before start, inherited by events on this calendar that don't set their own. Omit or null to use the system default (10 min); [] for no reminders."
        }
    }
}

create_event

Create a booking, appointment, meeting, hold, or any scheduled event on a calendar. The calendar id comes from create calendar or list events. Once created, this event blocks the agent's availability during that time and appears in availability queries. Use status="hold" with hold expires at to tentatively reserve a slot that auto-releases on TTL.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id",
        "title",
        "start_time",
        "end_time"
    ],
    "properties": {
        "title": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "Event title"
        },
        "status": {
            "enum": [
                "confirmed",
                "tentative",
                "hold"
            ],
            "type": "string",
            "description": "Event status. \"hold\" creates a tentative reservation that auto-expires at hold_expires_at. Defaults to \"confirmed\"."
        },
        "all_day": {
            "type": "boolean",
            "default": false,
            "description": "Whether this is an all-day event"
        },
        "end_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "End time (ISO 8601)"
        },
        "reminders": {
            "anyOf": [
                {
                    "type": "array",
                    "items": {
                        "type": "integer",
                        "maximum": 40320,
                        "minimum": 1
                    },
                    "maxItems": 5
                },
                {
                    "type": "null"
                }
            ],
            "description": "Reminder offsets in minutes before start_time (e.g. [10, 1440]). Each fires an event.reminder webhook and shows as an alarm in the iCal feed. Omit or null to inherit the calendar default (then the system default of 10 min); [] for no reminders."
        },
        "start_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Start time (ISO 8601)"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to add the event to"
        },
        "description": {
            "type": "string",
            "description": "Optional event description"
        },
        "hold_priority": {
            "type": "integer",
            "maximum": 100,
            "minimum": 0,
            "description": "Only valid with status=\"hold\". Higher-priority overlapping holds pre-empt lower-priority ones. Defaults to 0."
        },
        "hold_expires_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Required when status=\"hold\". ISO 8601 timestamp 30s-15min in the future. Auto-releases the hold when reached."
        },
        "recurrence_rule": {
            "type": "string",
            "maxLength": 256,
            "description": "Make this a recurring series (RFC 5545 RRULE subset, no \"RRULE:\" prefix), e.g. \"FREQ=WEEKLY;BYDAY=MO,WE;COUNT=12\". Supports FREQ=DAILY/WEEKLY/MONTHLY/YEARLY, INTERVAL, COUNT (max 730) or UNTIL, BYDAY (weekly list or monthly ordinal like 2TU/-1FR), BYMONTHDAY (1-28 or -1). start_time must match the rule pattern; expansion is UTC-only. Not allowed with status=\"hold\". Free plan: max 5 recurring events, series must end within 90 days."
        }
    }
}

list_events

List events on a calendar or across an agent's calendars, including internally created events and externally synced events from iCal subscriptions (e.g. Google Calendar, Outlook). Provide calendar id OR agent id . Narrow with start after / start before (time window), status , and source .

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return"
        },
        "expand": {
            "type": "boolean",
            "default": false,
            "description": "Expand recurring series into individual occurrence instances within the window. Requires both start_after and start_before (max 366 days apart). Instances carry recurringEventId + originalStartTime."
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        },
        "source": {
            "enum": [
                "internal",
                "external_ical"
            ],
            "type": "string",
            "description": "Filter by source: \"internal\" (created via the API) or \"external_ical\" (synced from an iCal subscription)"
        },
        "status": {
            "enum": [
                "confirmed",
                "tentative",
                "cancelled",
                "hold"
            ],
            "type": "string",
            "description": "Filter by event status"
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID to list events for across all of the agent's calendars. Provide this or calendar_id."
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to list events from. Provide this or agent_id."
        },
        "start_after": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Only events starting after this ISO 8601 time"
        },
        "start_before": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Only events starting before this ISO 8601 time"
        }
    }
}

get_event

Retrieve a single event by ID, including its title, times, status, location, reminders, and metadata. Works for both internally created events and externally synced iCal events. calendar id is optional — if omitted the calendar is resolved from the event. Provide calendar id to fail fast on cross-calendar typos.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "event_id"
    ],
    "properties": {
        "event_id": {
            "type": "string",
            "description": "Event ID to retrieve"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID that owns the event. Optional — if omitted the calendar is resolved from the event."
        }
    }
}

update_event

Reschedule or edit an event — change its title, description, start/end times, location, status, reminders, or metadata. Use this to move an appointment to a new time or update its details. Provide only the fields you want to change. Holds cannot be edited via this tool (use confirm event / release event). External iCal events are read-only. calendar id is optional — if omitted it is resolved from the event.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "event_id"
    ],
    "properties": {
        "title": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "New event title"
        },
        "status": {
            "enum": [
                "confirmed",
                "tentative",
                "cancelled"
            ],
            "type": "string",
            "description": "New event status"
        },
        "all_day": {
            "type": "boolean",
            "description": "Whether this is an all-day event"
        },
        "end_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "New end time (ISO 8601)"
        },
        "event_id": {
            "type": "string",
            "description": "Event ID to update"
        },
        "metadata": {
            "type": "object",
            "description": "Replacement metadata object",
            "propertyNames": {
                "type": "string"
            },
            "additionalProperties": []
        },
        "reminders": {
            "anyOf": [
                {
                    "type": "array",
                    "items": {
                        "type": "integer",
                        "maximum": 40320,
                        "minimum": 1
                    },
                    "maxItems": 5
                },
                {
                    "type": "null"
                }
            ],
            "description": "Reminder offsets in minutes before start_time. Omit to leave unchanged, null to inherit the calendar default, [] for no reminders."
        },
        "start_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "New start time (ISO 8601)"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID that owns the event. Optional — if omitted the calendar is resolved from the event."
        },
        "description": {
            "type": [
                "string",
                "null"
            ],
            "description": "New description, or null to clear it"
        },
        "recurrence_rule": {
            "anyOf": [
                {
                    "type": "string",
                    "maxLength": 256
                },
                {
                    "type": "null"
                }
            ],
            "description": "Set/change the recurring series rule (RFC 5545 RRULE subset, full-series semantics), or null to make the event a one-off. Changing the rule or start_time resets cancelled occurrences."
        }
    }
}

get_availability

Check when a single agent is free across its Chronary calendars and any human calendars authorized for that agent. This tool is fail-closed: always inspect availability state and warnings before using slots. Accepts start / end or the start time / end time aliases.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "end": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Range end (ISO 8601). Alias: end_time."
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Range start (ISO 8601). Alias: start_time."
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID to check availability for"
        },
        "duration": {
            "enum": [
                "15m",
                "30m",
                "45m",
                "1h",
                "2h"
            ],
            "type": "string",
            "description": "Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m."
        },
        "end_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Alias for `end` (matches REST events naming)."
        },
        "start_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Alias for `start` (matches REST events naming)."
        },
        "include_busy": {
            "type": "boolean",
            "default": false,
            "description": "Include busy blocks in response"
        },
        "slot_duration": {
            "enum": [
                "15m",
                "30m",
                "45m",
                "1h",
                "2h"
            ],
            "type": "string",
            "description": "Deprecated alias for `duration` — minimum slot length. Prefer `duration`."
        }
    }
}

find_meeting_time

Find slots when multiple agents are free across Chronary calendars and any human calendars authorized for each agent. This tool is fail-closed: always inspect availability state and warnings before using slots. Accepts agents / start / end or their aliases.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "end": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Search range end (ISO 8601). Alias: end_time."
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Search range start (ISO 8601). Alias: start_time."
        },
        "agents": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "minItems": 1,
            "description": "Array of agent IDs to find common free time for. All agents must be free during the returned slots. Alias: agent_ids."
        },
        "duration": {
            "enum": [
                "15m",
                "30m",
                "45m",
                "1h",
                "2h"
            ],
            "type": "string",
            "description": "Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m."
        },
        "end_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Alias for `end` (matches REST events naming)."
        },
        "agent_ids": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "minItems": 1,
            "description": "Alias for `agents` (matches REST/scheduling-proposal naming)."
        },
        "calendars": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Additional shared calendar IDs to treat as busy"
        },
        "start_time": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Alias for `start` (matches REST events naming)."
        },
        "include_busy": {
            "type": "boolean",
            "default": false,
            "description": "Include per-agent busy blocks in response"
        },
        "slot_duration": {
            "enum": [
                "15m",
                "30m",
                "45m",
                "1h",
                "2h"
            ],
            "type": "string",
            "description": "Deprecated alias for `duration` — minimum slot length. Prefer `duration`."
        }
    }
}

cancel_event

Delete or cancel an event from a calendar. Use this to remove, cancel, or delete any scheduled event or appointment. The event is marked cancelled and excluded from future availability calculations. For a recurring series, pass occurrence start to cancel just that one occurrence (the series continues); omit it to cancel the whole series. calendar id is optional — if omitted the calendar is looked up from the event. Provide calendar id to fail fast on cross-calendar typos.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "event_id"
    ],
    "properties": {
        "event_id": {
            "type": "string",
            "description": "Event ID to cancel"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID that owns the event. Optional — if omitted the calendar is resolved from the event. Matches the asymmetry with confirm_event / release_event which never required this arg."
        },
        "occurrence_start": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "For recurring events only: ISO 8601 start of the single occurrence to cancel. The rest of the series is unaffected."
        }
    }
}

confirm_event

Promote a held event to a confirmed booking. The event must currently have status="hold" and its hold expires at must not have passed. After confirmation, event.started and event.ended lifecycle webhooks fire at the scheduled times.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "event_id"
    ],
    "properties": {
        "event_id": {
            "type": "string",
            "description": "Event ID of the hold to confirm"
        }
    }
}

release_event

Manually release a held event before its hold expires at. The event must currently have status="hold". Frees the slot for other agents to book.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "event_id"
    ],
    "properties": {
        "event_id": {
            "type": "string",
            "description": "Event ID of the hold to release"
        }
    }
}

subscribe_ical

Link an external iCal feed (e.g. a human's Google Calendar) to an agent's calendar so external events appear in availability calculations. The target calendar must be owned by the specified agent — create the calendar with that agent id first (org-level calendars without an agent id cannot host external iCal subscriptions; create a dedicated per-agent calendar for sync targets).

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id",
        "calendar_id",
        "url"
    ],
    "properties": {
        "url": {
            "type": "string",
            "format": "uri",
            "description": "HTTPS URL of the iCal feed (.ics) to subscribe to"
        },
        "label": {
            "type": "string",
            "description": "Optional label for this subscription"
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID that will own this subscription"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to sync external events into"
        }
    }
}

list_ical_subscriptions

List an agent's external iCal feed subscriptions (e.g. linked Google Calendar / Outlook feeds), including their sync status and last sync time.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        },
        "status": {
            "enum": [
                "active",
                "error",
                "paused"
            ],
            "type": "string",
            "description": "Filter by subscription status"
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID whose iCal subscriptions to list"
        }
    }
}

get_ical_subscription

Get a single external iCal feed subscription by id, including its sync status, last sync time, and last error.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "subscription_id"
    ],
    "properties": {
        "subscription_id": {
            "type": "string",
            "description": "iCal subscription ID to fetch"
        }
    }
}

update_ical_subscription

Update an external iCal feed subscription — change its label or its feed URL. Changing the URL forces a full re-sync on the next poll.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "subscription_id"
    ],
    "properties": {
        "url": {
            "type": "string",
            "format": "uri",
            "description": "New HTTPS URL of the iCal feed (.ics)"
        },
        "label": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "New label for this subscription"
        },
        "subscription_id": {
            "type": "string",
            "description": "iCal subscription ID to update"
        }
    }
}

delete_ical_subscription

Delete an external iCal feed subscription. Events previously synced from the feed are no longer refreshed.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "subscription_id"
    ],
    "properties": {
        "subscription_id": {
            "type": "string",
            "description": "iCal subscription ID to delete"
        }
    }
}

sync_ical_subscription

Trigger an immediate sync of an external iCal feed subscription instead of waiting for the next scheduled poll. Returns once the sync has been queued.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "subscription_id"
    ],
    "properties": {
        "subscription_id": {
            "type": "string",
            "description": "iCal subscription ID to sync"
        }
    }
}

get_calendar_context

Get a calendar's temporal context in a single call: the current event (if one is happening now), the next upcoming event, recent past events, a short upcoming window, and the owning agent's status (idle/working/waiting/error). Use this to answer "what is this agent doing right now?" without issuing multiple list events queries.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID"
        }
    }
}

create_proposal

Create a scheduling proposal — send a set of candidate time slots to one or more participant agents so they can accept, decline, or counter-propose. The organizer agent owns the proposal; once every participant responds, the system auto-resolves to the highest-scoring slot (or cancels if all decline). Requires an org-level API key. Pro plan only.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "title",
        "organizer_agent_id",
        "participant_agent_ids",
        "calendar_id",
        "slots"
    ],
    "properties": {
        "slots": {
            "type": "array",
            "items": {
                "type": "object",
                "required": [
                    "start_time",
                    "end_time"
                ],
                "properties": {
                    "weight": {
                        "type": "number",
                        "default": 1,
                        "maximum": 10,
                        "minimum": 0,
                        "description": "Preference for this slot, 0–10 (higher = more preferred). Used to rank candidate slots when the proposal is resolved. Defaults to 1."
                    },
                    "end_time": {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                        "description": "Slot end time (ISO 8601), after start_time"
                    },
                    "start_time": {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                        "description": "Slot start time (ISO 8601)"
                    },
                    "calendar_id": {
                        "type": "string",
                        "description": "Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id."
                    }
                }
            },
            "maxItems": 20,
            "minItems": 1,
            "description": "Candidate time slots (up to 20)"
        },
        "title": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "Short description of what the meeting is about"
        },
        "expires_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
            "description": "Auto-cancel cutoff if unresolved"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar the resolved event will be created on"
        },
        "description": {
            "type": "string",
            "maxLength": 5000,
            "description": "Longer context/agenda"
        },
        "organizer_agent_id": {
            "type": "string",
            "description": "Agent ID proposing the meeting"
        },
        "participant_agent_ids": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "maxItems": 50,
            "minItems": 1,
            "description": "Agent IDs invited to respond"
        }
    }
}

list_proposals

List scheduling proposals for the org. Filter by status (pending confirmed expired cancelled) or organizer agent id. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "limit": {
            "type": "integer",
            "maximum": 200,
            "minimum": 1,
            "description": "Max results (default 50)"
        },
        "offset": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset (default 0)"
        },
        "status": {
            "enum": [
                "pending",
                "confirmed",
                "expired",
                "cancelled"
            ],
            "type": "string",
            "description": "Filter by proposal status"
        },
        "organizer_agent_id": {
            "type": "string",
            "description": "Filter by organizer agent"
        }
    }
}

get_proposal

Get a scheduling proposal by id, including its slots and per-participant responses. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "proposal_id"
    ],
    "properties": {
        "proposal_id": {
            "type": "string",
            "description": "Proposal to fetch"
        }
    }
}

respond_to_proposal

Submit a response (accept / decline / counter) on behalf of one participant agent to an open proposal. An "accept" requires the slot id from the proposal; a "counter" can suggest alternative slots. When all participants have responded the proposal auto-resolves — no separate resolve call needed in the normal flow. Requires an org-level API key. Pro plan only.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "proposal_id",
        "agent_id",
        "response"
    ],
    "properties": {
        "message": {
            "type": "string",
            "maxLength": 2000,
            "description": "Optional note for the organizer"
        },
        "agent_id": {
            "type": "string",
            "description": "Participant agent responding"
        },
        "response": {
            "enum": [
                "accept",
                "decline",
                "counter"
            ],
            "type": "string",
            "description": "Decision from this agent"
        },
        "proposal_id": {
            "type": "string",
            "description": "Proposal to respond to"
        },
        "counter_slots": {
            "type": "array",
            "items": {
                "type": "object",
                "required": [
                    "start_time",
                    "end_time"
                ],
                "properties": {
                    "weight": {
                        "type": "number",
                        "default": 1,
                        "maximum": 10,
                        "minimum": 0,
                        "description": "Preference for this slot, 0–10 (higher = more preferred). Used to rank candidate slots when the proposal is resolved. Defaults to 1."
                    },
                    "end_time": {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                        "description": "Slot end time (ISO 8601), after start_time"
                    },
                    "start_time": {
                        "type": "string",
                        "format": "date-time",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                        "description": "Slot start time (ISO 8601)"
                    },
                    "calendar_id": {
                        "type": "string",
                        "description": "Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id."
                    }
                }
            },
            "maxItems": 20,
            "description": "Alternative slots when response is \"counter\""
        },
        "selected_slot_id": {
            "type": "string",
            "description": "Required when response is \"accept\""
        }
    }
}

resolve_proposal

Force-resolve an open proposal using responses collected so far. Picks the highest-scoring slot among those accepted by the most participants and creates a confirmed calendar event. If every response was "decline", the proposal is cancelled instead. Use when you want to close out a proposal without waiting for every participant. Requires an org-level API key. Pro plan only.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "proposal_id"
    ],
    "properties": {
        "proposal_id": {
            "type": "string",
            "description": "Proposal to resolve"
        }
    }
}

cancel_proposal

Cancel an open proposal. Fires a proposal.cancelled webhook with reason="organizer cancelled". Requires an org-level API key. Pro plan only.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "proposal_id"
    ],
    "properties": {
        "proposal_id": {
            "type": "string",
            "description": "Proposal to cancel"
        }
    }
}

set_availability_rules

Set or replace the availability rules on a calendar — buffer times before/after events and optional per-day working hours. When these rules are set, every availability query on this calendar automatically applies them (busy-block expansion for buffers, masking outside working hours). Upsert: overwrites any existing rules.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "timezone": {
            "type": "string",
            "default": "UTC",
            "maxLength": 64,
            "minLength": 1,
            "description": "IANA timezone used to interpret working_hours (e.g. America/New_York)"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar to configure"
        },
        "working_hours": {
            "anyOf": [
                {
                    "type": "object",
                    "properties": {
                        "fri": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "mon": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "sat": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "sun": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "thu": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "tue": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        },
                        "wed": {
                            "type": "object",
                            "required": [
                                "start",
                                "end"
                            ],
                            "properties": {
                                "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")"
                                },
                                "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")"
                                }
                            },
                            "description": "A single day's working hours window"
                        }
                    }
                },
                {
                    "type": "null"
                }
            ],
            "default": null,
            "description": "Per-day working hours map in the calendar's timezone; omit keys for off-days. Pass null to remove any working-hours constraint."
        },
        "buffer_after_minutes": {
            "type": "integer",
            "default": 0,
            "maximum": 120,
            "minimum": 0,
            "description": "Minutes of buffer after each event (0–120)"
        },
        "buffer_before_minutes": {
            "type": "integer",
            "default": 0,
            "maximum": 120,
            "minimum": 0,
            "description": "Minutes of buffer before each event (0–120)"
        }
    }
}

get_availability_rules

Read the buffer times and working-hours rules configured on a calendar. Returns the rules row, or an error if none are set.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "description": "Calendar to read"
        }
    }
}

clear_availability_rules

Remove the availability rules from a calendar, reverting to the default (no buffers, no working-hours mask). Returns the deleted row, or an error if none were set.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "description": "Calendar whose rules should be cleared"
        }
    }
}

create_scoped_key

Create an agent-scoped API key (chr ak ) that can only act on behalf of a single agent. Use this to self-provision or rotate per-agent credentials. The plaintext key is returned exactly once in the response — store it immediately, it cannot be retrieved later. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "label": {
            "type": "string",
            "maxLength": 100,
            "minLength": 1,
            "description": "Human-readable label for the key"
        },
        "agent_id": {
            "type": "string",
            "pattern": "^agt_",
            "description": "Agent ID this key is scoped to"
        }
    }
}

list_scoped_keys

List all live (non-revoked) agent-scoped API keys for this org. Returns key metadata only (id, prefix, agent id, label, created at) — never the plaintext secret. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": []
}

revoke_scoped_key

Revoke an agent-scoped API key by ID. Revocation is permanent (cannot be un-revoked); the key stops authenticating within about a minute. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "key_id"
    ],
    "properties": {
        "key_id": {
            "type": "string",
            "description": "ID of the scoped key to revoke"
        }
    }
}

create_webhook

Create a webhook subscription so the org receives HTTP POST notifications when events occur (e.g. event.created, proposal.confirmed). The signing secret is returned ONCE in this response — store it to verify the HMAC-SHA256 signature on delivered payloads. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "url",
        "events"
    ],
    "properties": {
        "url": {
            "type": "string",
            "format": "uri",
            "description": "HTTPS endpoint that will receive event deliveries"
        },
        "events": {
            "type": "array",
            "items": {
                "enum": [
                    "agent.created",
                    "agent.updated",
                    "event.created",
                    "event.updated",
                    "event.deleted",
                    "event.started",
                    "event.ended",
                    "event.reminder",
                    "event.hold_created",
                    "event.hold_expired",
                    "event.hold_released",
                    "event.hold_confirmed",
                    "proposal.created",
                    "proposal.responded",
                    "proposal.confirmed",
                    "proposal.expired",
                    "proposal.cancelled",
                    "webhook.deactivated"
                ],
                "type": "string"
            },
            "minItems": 1,
            "description": "Event types to subscribe to"
        }
    }
}

list_webhooks

List the org's webhook subscriptions with their subscribed event types and active state. Signing secrets are never returned. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "limit": {
            "type": "integer",
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        }
    }
}

get_webhook

Get a single webhook subscription by id, including its subscribed event types and active state. The signing secret is never returned. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "webhook_id"
    ],
    "properties": {
        "webhook_id": {
            "type": "string",
            "description": "Webhook subscription to fetch"
        }
    }
}

update_webhook

Update a webhook subscription — change its delivery URL, the set of subscribed event types, or pause/resume it via active. At least one field must be supplied. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "webhook_id"
    ],
    "properties": {
        "url": {
            "type": "string",
            "format": "uri",
            "description": "New HTTPS delivery endpoint"
        },
        "active": {
            "type": "boolean",
            "description": "Set false to pause deliveries, true to resume"
        },
        "events": {
            "type": "array",
            "items": {
                "enum": [
                    "agent.created",
                    "agent.updated",
                    "event.created",
                    "event.updated",
                    "event.deleted",
                    "event.started",
                    "event.ended",
                    "event.reminder",
                    "event.hold_created",
                    "event.hold_expired",
                    "event.hold_released",
                    "event.hold_confirmed",
                    "proposal.created",
                    "proposal.responded",
                    "proposal.confirmed",
                    "proposal.expired",
                    "proposal.cancelled",
                    "webhook.deactivated"
                ],
                "type": "string"
            },
            "minItems": 1,
            "description": "Replacement set of event types to subscribe to"
        },
        "webhook_id": {
            "type": "string",
            "description": "Webhook subscription to update"
        }
    }
}

delete_webhook

Permanently delete a webhook subscription. This frees its endpoint slot against the per-plan cap. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "webhook_id"
    ],
    "properties": {
        "webhook_id": {
            "type": "string",
            "description": "Webhook subscription to delete"
        }
    }
}

list_webhook_deliveries

List delivery attempts for a webhook subscription, with per-status counts (pending/delivered/failed). Use this to debug failing deliveries. Requires an org-level API key.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "webhook_id"
    ],
    "properties": {
        "limit": {
            "type": "integer",
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        },
        "status": {
            "enum": [
                "pending",
                "delivered",
                "failed"
            ],
            "type": "string",
            "description": "Filter to a single delivery status"
        },
        "webhook_id": {
            "type": "string",
            "description": "Webhook subscription whose deliveries to list"
        },
        "include_payload": {
            "type": "boolean",
            "description": "Include the full event payload sent on each delivery"
        }
    }
}

get_agent

Fetch a single agent by ID. An agent represents an AI assistant, human, or shared resource (e.g. a meeting room). Agent-scoped API keys may only read their own agent.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "agent_id": {
            "type": "string",
            "description": "Agent ID to fetch"
        }
    }
}

update_agent

Update an agent's name, description, metadata, or status (active/paused). Requires an org-level API key — agent-scoped keys cannot mutate agents.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "New display name"
        },
        "status": {
            "enum": [
                "active",
                "paused"
            ],
            "type": "string",
            "description": "Operational status"
        },
        "agent_id": {
            "type": "string",
            "description": "Agent ID to update"
        },
        "metadata": {
            "type": "object",
            "description": "Arbitrary metadata (max 16KB)",
            "propertyNames": {
                "type": "string"
            },
            "additionalProperties": []
        },
        "description": {
            "type": [
                "string",
                "null"
            ],
            "description": "New description (null to clear)"
        }
    }
}

delete_agent

Decommission an agent. This marks the agent as decommissioned and revokes all of its scoped API keys. Requires an org-level API key — agent-scoped keys cannot delete agents.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "agent_id"
    ],
    "properties": {
        "agent_id": {
            "type": "string",
            "description": "Agent ID to decommission"
        }
    }
}

list_calendars

List calendars in the org. Org-level API keys see every calendar (agent-owned and shared); agent-scoped keys see only their own agent's calendars. Use this to discover calendar IDs before creating or listing events.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        },
        "include": {
            "enum": [
                "all"
            ],
            "type": "string",
            "description": "Pass \"all\" to include calendars across all agents (org keys only)"
        },
        "agent_id": {
            "type": "string",
            "description": "Filter to calendars owned by this agent. Org keys only — agent-scoped keys are always limited to their own agent and ignore this."
        }
    }
}

get_calendar

Fetch a single calendar by ID, including its name, timezone, agent status, and default reminders. Agent-scoped keys may only read calendars owned by their agent.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to fetch"
        }
    }
}

update_calendar

Update a calendar's name, timezone, agent status, default reminders, or metadata. Agent-scoped keys may only update calendars owned by their agent.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "New calendar name"
        },
        "metadata": {
            "type": "object",
            "description": "Arbitrary metadata (max 16KB)",
            "propertyNames": {
                "type": "string"
            },
            "additionalProperties": []
        },
        "timezone": {
            "type": "string",
            "minLength": 1,
            "description": "New IANA timezone (e.g. America/New_York)"
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to update"
        },
        "agent_status": {
            "enum": [
                "idle",
                "working",
                "waiting",
                "error"
            ],
            "type": "string",
            "description": "Owning agent's status"
        },
        "default_reminders": {
            "anyOf": [
                {
                    "type": "array",
                    "items": {
                        "type": "integer",
                        "maximum": 40320,
                        "minimum": 1
                    },
                    "maxItems": 5
                },
                {
                    "type": "null"
                }
            ],
            "description": "Default reminder offsets in minutes; null for system default, [] for none"
        }
    }
}

delete_calendar

Delete a calendar (soft delete). Its events are no longer returned and it stops contributing to availability. Agent-scoped keys may only delete calendars owned by their agent.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "description": "Calendar ID to delete"
        }
    }
}

create_booking_page

Create a public booking page (a hosted scheduling link) for a calendar. Returns a booking url to send to a human; when they pick a slot, a confirmed event is created on the calendar and an event.created webhook fires with a booking page id field. Set availability constraints to restrict to weekly working hours; existing calendar events always block slots.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id",
        "title"
    ],
    "properties": {
        "title": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Meeting title shown on the page."
        },
        "active": {
            "type": "boolean",
            "description": "Whether the page accepts bookings (default true)."
        },
        "timezone": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "description": "IANA timezone for display + working hours (default UTC)."
        },
        "calendar_id": {
            "type": "string",
            "description": "Calendar a booking resolves to (from create_calendar/list_calendars)."
        },
        "description": {
            "type": "string",
            "maxLength": 2000,
            "description": "Optional description shown to the booker."
        },
        "window_days": {
            "type": "integer",
            "maximum": 365,
            "minimum": 1,
            "description": "How far ahead bookings are allowed (default 14)."
        },
        "buffer_minutes": {
            "type": "integer",
            "maximum": 120,
            "minimum": 0,
            "description": "Padding before/after existing events (default 0)."
        },
        "duration_minutes": {
            "type": "integer",
            "maximum": 480,
            "minimum": 5,
            "description": "Slot length in minutes (default 30)."
        },
        "min_notice_minutes": {
            "type": "integer",
            "maximum": 40320,
            "minimum": 0,
            "description": "Minimum lead time before a bookable slot (default 0)."
        },
        "availability_constraints": {
            "anyOf": [
                {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "object",
                        "required": [
                            "start",
                            "end"
                        ],
                        "properties": {
                            "end": {
                                "type": "string"
                            },
                            "start": {
                                "type": "string"
                            }
                        }
                    }
                },
                {
                    "type": "null"
                }
            ],
            "description": "Weekly working hours, e.g. {\"mon\":{\"start\":\"09:00\",\"end\":\"17:00\"}}. Omit/null for any time in the window."
        }
    }
}

list_booking_pages

List booking pages in the org. Agent-scoped keys see only pages on their own agent's calendars.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return"
        },
        "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "Pagination offset"
        }
    }
}

get_booking_page

Fetch a single booking page by ID, including its public booking url and settings.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "booking_page_id"
    ],
    "properties": {
        "booking_page_id": {
            "type": "string",
            "description": "Booking page ID to fetch (bkp_...)"
        }
    }
}

delete_booking_page

Delete (deactivate) a booking page. Its hosted URL stops resolving; already-booked events are unaffected.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "booking_page_id"
    ],
    "properties": {
        "booking_page_id": {
            "type": "string",
            "description": "Booking page ID to delete (bkp_...)"
        }
    }
}

get_usage

Get the calling org's current-period usage and plan limits (agents, calendars, events, API calls, webhooks, availability queries, iCal subscriptions, proposals, scoped keys, holds, cross-calendar queries). Requires an org-level API key (chr sk ); agent-scoped keys cannot read org-wide usage.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": []
}

get_audit_log

List audit-log entries for the calling org — mutating operations and auth-lifecycle events, newest first. Results are clamped to the plan's retention window. Requires an org-level API key (chr sk ); agent-scoped keys cannot read the org-wide audit log.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
        "to": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "description": "End of the window (ISO 8601)"
        },
        "from": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "description": "Start of the window (ISO 8601). Silently clamped to the plan retention window if older."
        },
        "limit": {
            "type": "integer",
            "maximum": 200,
            "minimum": 1,
            "description": "Max results to return (default 50)"
        },
        "action": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "description": "Filter by action name (e.g. event.created)"
        },
        "cursor": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1,
            "description": "Opaque pagination cursor from a previous response"
        },
        "actor_key_prefix": {
            "type": "string",
            "maxLength": 32,
            "minLength": 1,
            "description": "Filter by the API key prefix that performed the action"
        }
    }
}

accept_terms

Re-accept the current Chronary terms of service on behalf of the calling org. Use this when responses carry the Chronary-Terms-Upgrade-Required header — a material ToS bump otherwise leaves MCP-only agents stuck without a console session. Pass the current tos version (read it from GET /v1/auth/terms/current). Requires an org-level API key (chr sk ); agent-scoped keys cannot accept org-wide terms.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "tos_version"
    ],
    "properties": {
        "tos_version": {
            "type": "string",
            "minLength": 1,
            "description": "The terms-of-service version to accept; must match the current version"
        }
    }
}

create_connection_link

Request human setup of Google Calendar or Microsoft Outlook for a Chronary calendar. Give setup url to a human; the agent never receives OAuth credentials, provider calendar names, or event data. The secret URL is returned only on first creation. If reused=true and setup url is null, retain the original URL or cancel this link and create a replacement.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "calendar_id"
    ],
    "properties": {
        "calendar_id": {
            "type": "string",
            "format": "starts_with",
            "pattern": "^cal_.*",
            "description": "Chronary calendar whose owning agent will receive authorized availability"
        },
        "capabilities": {
            "type": "array",
            "items": {
                "enum": [
                    "availability",
                    "publishing"
                ],
                "type": "string"
            },
            "default": [
                "availability"
            ],
            "maxItems": 2,
            "minItems": 1,
            "description": "Request opaque availability, plus optional opt-in event publishing permission"
        },
        "publication_policy": {
            "enum": [
                "none",
                "confirmed",
                "confirmed_tentative"
            ],
            "type": "string",
            "default": "none",
            "description": "Desired publishing policy; a human still chooses the destination"
        }
    }
}

get_connection_link

Poll a human-calendar setup request. Returns provider-neutral status and resulting connection ID when complete, but never replays the bearer setup URL or exposes human calendar data.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "connection_link_id"
    ],
    "properties": {
        "connection_link_id": {
            "type": "string",
            "format": "starts_with",
            "pattern": "^csl_.*",
            "description": "Connection setup link ID"
        }
    }
}

cancel_connection_link

Cancel a pending human-calendar setup request. This invalidates the setup URL and does not disconnect an already completed Google or Microsoft connection.

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "connection_link_id"
    ],
    "properties": {
        "connection_link_id": {
            "type": "string",
            "format": "starts_with",
            "pattern": "^csl_.*",
            "description": "Connection setup link ID"
        }
    }
}