Server definition
- Hash
- sha256:d4aa5f0cecfaca4018134c3966ae2d040209f501a5c01754a0ea9d6052afb96c
- What it is
- What a remote MCP server returned when asked what it offers: 54 tools
The blob, as servednamed by its sha256
{
"instructions": "Chronary is calendar-as-a-service for AI agents. Use these tools to give an agent its own calendars and events, request human-approved Google Calendar or Microsoft Outlook connections, check and coordinate combined availability, run multi-party scheduling proposals, place auto-expiring holds, manage availability rules, sync external iCal feeds, and configure webhooks.\n\nTypical flow: create_agent -> create_calendar -> create_event / get_availability / find_meeting_time. IDs are prefixed (agt_, cal_, evt_); timestamps are ISO 8601 (UTC recommended).\n\nWhen checking availability, always inspect availability_state and warnings before treating returned slots as complete. Human-calendar setup requires a human to open setup_url and consent; agents never receive provider credentials or calendar contents.\n\nOrg keys (chr_sk_) can use every tool; agent-scoped keys (chr_ak_) are limited to their own agent and cannot use org-only tools such as create_agent or find_meeting_time. Temporal holds, cross-agent availability, and scheduling proposals require a Pro plan.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tos_version": {
"description": "The terms-of-service version to accept; must match the current version",
"minLength": 1,
"type": "string"
}
},
"required": [
"tos_version"
],
"type": "object"
},
"name": "accept_terms",
"outputSchema": null
},
{
"description": "Cancel a pending human-calendar setup request. This invalidates the setup URL and does not disconnect an already completed Google or Microsoft connection.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"connection_link_id": {
"description": "Connection setup link ID",
"format": "starts_with",
"pattern": "^csl_.*",
"type": "string"
}
},
"required": [
"connection_link_id"
],
"type": "object"
},
"name": "cancel_connection_link",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"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.",
"type": "string"
},
"event_id": {
"description": "Event ID to cancel",
"type": "string"
},
"occurrence_start": {
"description": "For recurring events only: ISO 8601 start of the single occurrence to cancel. The rest of the series is unaffected.",
"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))$",
"type": "string"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "cancel_event",
"outputSchema": null
},
{
"description": "Cancel an open proposal. Fires a proposal.cancelled webhook with reason=\"organizer_cancelled\". Requires an org-level API key. Pro plan only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"proposal_id": {
"description": "Proposal to cancel",
"type": "string"
}
},
"required": [
"proposal_id"
],
"type": "object"
},
"name": "cancel_proposal",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar whose rules should be cleared",
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "clear_availability_rules",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"event_id": {
"description": "Event ID of the hold to confirm",
"type": "string"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "confirm_event",
"outputSchema": null
},
{
"description": "Register your agent (AI assistant, human participant, or resource) with Chronary so it can own calendars, events, and webhooks.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"description": {
"description": "Optional description",
"type": "string"
},
"name": {
"description": "Display name for the agent",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"type": {
"description": "Agent type",
"enum": [
"ai",
"human",
"resource"
],
"type": "string"
}
},
"required": [
"name",
"type"
],
"type": "object"
},
"name": "create_agent",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"active": {
"description": "Whether the page accepts bookings (default true).",
"type": "boolean"
},
"availability_constraints": {
"anyOf": [
{
"additionalProperties": {
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Weekly working hours, e.g. {\"mon\":{\"start\":\"09:00\",\"end\":\"17:00\"}}. Omit/null for any time in the window."
},
"buffer_minutes": {
"description": "Padding before/after existing events (default 0).",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"calendar_id": {
"description": "Calendar a booking resolves to (from create_calendar/list_calendars).",
"type": "string"
},
"description": {
"description": "Optional description shown to the booker.",
"maxLength": 2000,
"type": "string"
},
"duration_minutes": {
"description": "Slot length in minutes (default 30).",
"maximum": 480,
"minimum": 5,
"type": "integer"
},
"min_notice_minutes": {
"description": "Minimum lead time before a bookable slot (default 0).",
"maximum": 40320,
"minimum": 0,
"type": "integer"
},
"timezone": {
"description": "IANA timezone for display + working hours (default UTC).",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"title": {
"description": "Meeting title shown on the page.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"window_days": {
"description": "How far ahead bookings are allowed (default 14).",
"maximum": 365,
"minimum": 1,
"type": "integer"
}
},
"required": [
"calendar_id",
"title"
],
"type": "object"
},
"name": "create_booking_page",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to own this calendar (omit for org-level)",
"type": "string"
},
"default_reminders": {
"anyOf": [
{
"items": {
"maximum": 40320,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"type": "array"
},
{
"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."
},
"name": {
"description": "Calendar name",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. America/New_York)",
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"timezone"
],
"type": "object"
},
"name": "create_calendar",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Chronary calendar whose owning agent will receive authorized availability",
"format": "starts_with",
"pattern": "^cal_.*",
"type": "string"
},
"capabilities": {
"default": [
"availability"
],
"description": "Request opaque availability, plus optional opt-in event publishing permission",
"items": {
"enum": [
"availability",
"publishing"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"publication_policy": {
"default": "none",
"description": "Desired publishing policy; a human still chooses the destination",
"enum": [
"none",
"confirmed",
"confirmed_tentative"
],
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "create_connection_link",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"all_day": {
"default": false,
"description": "Whether this is an all-day event",
"type": "boolean"
},
"calendar_id": {
"description": "Calendar ID to add the event to",
"type": "string"
},
"description": {
"description": "Optional event description",
"type": "string"
},
"end_time": {
"description": "End time (ISO 8601)",
"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))$",
"type": "string"
},
"hold_expires_at": {
"description": "Required when status=\"hold\". ISO 8601 timestamp 30s-15min in the future. Auto-releases the hold when reached.",
"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))$",
"type": "string"
},
"hold_priority": {
"description": "Only valid with status=\"hold\". Higher-priority overlapping holds pre-empt lower-priority ones. Defaults to 0.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"recurrence_rule": {
"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.",
"maxLength": 256,
"type": "string"
},
"reminders": {
"anyOf": [
{
"items": {
"maximum": 40320,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"type": "array"
},
{
"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": {
"description": "Start time (ISO 8601)",
"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))$",
"type": "string"
},
"status": {
"description": "Event status. \"hold\" creates a tentative reservation that auto-expires at hold_expires_at. Defaults to \"confirmed\".",
"enum": [
"confirmed",
"tentative",
"hold"
],
"type": "string"
},
"title": {
"description": "Event title",
"maxLength": 500,
"minLength": 1,
"type": "string"
}
},
"required": [
"calendar_id",
"title",
"start_time",
"end_time"
],
"type": "object"
},
"name": "create_event",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar the resolved event will be created on",
"type": "string"
},
"description": {
"description": "Longer context/agenda",
"maxLength": 5000,
"type": "string"
},
"expires_at": {
"description": "Auto-cancel cutoff if unresolved",
"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))$",
"type": "string"
},
"organizer_agent_id": {
"description": "Agent ID proposing the meeting",
"type": "string"
},
"participant_agent_ids": {
"description": "Agent IDs invited to respond",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"slots": {
"description": "Candidate time slots (up to 20)",
"items": {
"properties": {
"calendar_id": {
"description": "Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id.",
"type": "string"
},
"end_time": {
"description": "Slot end time (ISO 8601), after start_time",
"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))$",
"type": "string"
},
"start_time": {
"description": "Slot start time (ISO 8601)",
"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))$",
"type": "string"
},
"weight": {
"default": 1,
"description": "Preference for this slot, 0–10 (higher = more preferred). Used to rank candidate slots when the proposal is resolved. Defaults to 1.",
"maximum": 10,
"minimum": 0,
"type": "number"
}
},
"required": [
"start_time",
"end_time"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"title": {
"description": "Short description of what the meeting is about",
"maxLength": 500,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"organizer_agent_id",
"participant_agent_ids",
"calendar_id",
"slots"
],
"type": "object"
},
"name": "create_proposal",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID this key is scoped to",
"pattern": "^agt_",
"type": "string"
},
"label": {
"description": "Human-readable label for the key",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "create_scoped_key",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"events": {
"description": "Event types to subscribe to",
"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,
"type": "array"
},
"url": {
"description": "HTTPS endpoint that will receive event deliveries",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"events"
],
"type": "object"
},
"name": "create_webhook",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to decommission",
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "delete_agent",
"outputSchema": null
},
{
"description": "Delete (deactivate) a booking page. Its hosted URL stops resolving; already-booked events are unaffected.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"booking_page_id": {
"description": "Booking page ID to delete (bkp_...)",
"type": "string"
}
},
"required": [
"booking_page_id"
],
"type": "object"
},
"name": "delete_booking_page",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar ID to delete",
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "delete_calendar",
"outputSchema": null
},
{
"description": "Delete an external iCal feed subscription. Events previously synced from the feed are no longer refreshed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"subscription_id": {
"description": "iCal subscription ID to delete",
"type": "string"
}
},
"required": [
"subscription_id"
],
"type": "object"
},
"name": "delete_ical_subscription",
"outputSchema": null
},
{
"description": "Permanently delete a webhook subscription. This frees its endpoint slot against the per-plan cap. Requires an org-level API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"webhook_id": {
"description": "Webhook subscription to delete",
"type": "string"
}
},
"required": [
"webhook_id"
],
"type": "object"
},
"name": "delete_webhook",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_ids": {
"description": "Alias for `agents` (matches REST/scheduling-proposal naming).",
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"agents": {
"description": "Array of agent IDs to find common free time for. All agents must be free during the returned slots. Alias: agent_ids.",
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"calendars": {
"description": "Additional shared calendar IDs to treat as busy",
"items": {
"type": "string"
},
"type": "array"
},
"duration": {
"description": "Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m.",
"enum": [
"15m",
"30m",
"45m",
"1h",
"2h"
],
"type": "string"
},
"end": {
"description": "Search range end (ISO 8601). Alias: end_time.",
"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))$",
"type": "string"
},
"end_time": {
"description": "Alias for `end` (matches REST events naming).",
"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))$",
"type": "string"
},
"include_busy": {
"default": false,
"description": "Include per-agent busy blocks in response",
"type": "boolean"
},
"slot_duration": {
"description": "Deprecated alias for `duration` — minimum slot length. Prefer `duration`.",
"enum": [
"15m",
"30m",
"45m",
"1h",
"2h"
],
"type": "string"
},
"start": {
"description": "Search range start (ISO 8601). Alias: start_time.",
"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))$",
"type": "string"
},
"start_time": {
"description": "Alias for `start` (matches REST events naming).",
"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))$",
"type": "string"
}
},
"type": "object"
},
"name": "find_meeting_time",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to fetch",
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "get_agent",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"action": {
"description": "Filter by action name (e.g. event.created)",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"actor_key_prefix": {
"description": "Filter by the API key prefix that performed the action",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"cursor": {
"description": "Opaque pagination cursor from a previous response",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"from": {
"description": "Start of the window (ISO 8601). Silently clamped to the plan retention window if older.",
"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)))$",
"type": "string"
},
"limit": {
"description": "Max results to return (default 50)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "End of the window (ISO 8601)",
"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)))$",
"type": "string"
}
},
"type": "object"
},
"name": "get_audit_log",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to check availability for",
"type": "string"
},
"duration": {
"description": "Requested slot length (15m/30m/45m/1h/2h). Preferred over the deprecated slot_duration. Defaults to 30m.",
"enum": [
"15m",
"30m",
"45m",
"1h",
"2h"
],
"type": "string"
},
"end": {
"description": "Range end (ISO 8601). Alias: end_time.",
"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))$",
"type": "string"
},
"end_time": {
"description": "Alias for `end` (matches REST events naming).",
"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))$",
"type": "string"
},
"include_busy": {
"default": false,
"description": "Include busy blocks in response",
"type": "boolean"
},
"slot_duration": {
"description": "Deprecated alias for `duration` — minimum slot length. Prefer `duration`.",
"enum": [
"15m",
"30m",
"45m",
"1h",
"2h"
],
"type": "string"
},
"start": {
"description": "Range start (ISO 8601). Alias: start_time.",
"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))$",
"type": "string"
},
"start_time": {
"description": "Alias for `start` (matches REST events naming).",
"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))$",
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "get_availability",
"outputSchema": null
},
{
"description": "Read the buffer times and working-hours rules configured on a calendar. Returns the rules row, or an error if none are set.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar to read",
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "get_availability_rules",
"outputSchema": null
},
{
"description": "Fetch a single booking page by ID, including its public booking_url and settings.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"booking_page_id": {
"description": "Booking page ID to fetch (bkp_...)",
"type": "string"
}
},
"required": [
"booking_page_id"
],
"type": "object"
},
"name": "get_booking_page",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar ID to fetch",
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "get_calendar",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar ID",
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "get_calendar_context",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"connection_link_id": {
"description": "Connection setup link ID",
"format": "starts_with",
"pattern": "^csl_.*",
"type": "string"
}
},
"required": [
"connection_link_id"
],
"type": "object"
},
"name": "get_connection_link",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calendar_id": {
"description": "Calendar ID that owns the event. Optional — if omitted the calendar is resolved from the event.",
"type": "string"
},
"event_id": {
"description": "Event ID to retrieve",
"type": "string"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "get_event",
"outputSchema": null
},
{
"description": "Get a single external iCal feed subscription by id, including its sync status, last sync time, and last error.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"subscription_id": {
"description": "iCal subscription ID to fetch",
"type": "string"
}
},
"required": [
"subscription_id"
],
"type": "object"
},
"name": "get_ical_subscription",
"outputSchema": null
},
{
"description": "Get a scheduling proposal by id, including its slots and per-participant responses. Requires an org-level API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"proposal_id": {
"description": "Proposal to fetch",
"type": "string"
}
},
"required": [
"proposal_id"
],
"type": "object"
},
"name": "get_proposal",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_usage",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"webhook_id": {
"description": "Webhook subscription to fetch",
"type": "string"
}
},
"required": [
"webhook_id"
],
"type": "object"
},
"name": "get_webhook",
"outputSchema": null
},
{
"description": "List all agents in your organization",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 50,
"description": "Max results to return",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"description": "Filter by status",
"enum": [
"active",
"paused",
"decommissioned"
],
"type": "string"
},
"type": {
"description": "Filter by agent type",
"enum": [
"ai",
"human",
"resource"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_agents",
"outputSchema": null
},
{
"description": "List booking pages in the org. Agent-scoped keys see only pages on their own agent's calendars.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 50,
"description": "Max results to return",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "list_booking_pages",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Filter to calendars owned by this agent. Org keys only — agent-scoped keys are always limited to their own agent and ignore this.",
"type": "string"
},
"include": {
"description": "Pass \"all\" to include calendars across all agents (org keys only)",
"enum": [
"all"
],
"type": "string"
},
"limit": {
"default": 50,
"description": "Max results to return",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "list_calendars",
"outputSchema": null
},
{
"description": "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`.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to list events for across all of the agent's calendars. Provide this or calendar_id.",
"type": "string"
},
"calendar_id": {
"description": "Calendar ID to list events from. Provide this or agent_id.",
"type": "string"
},
"expand": {
"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.",
"type": "boolean"
},
"limit": {
"default": 50,
"description": "Max results to return",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"source": {
"description": "Filter by source: \"internal\" (created via the API) or \"external_ical\" (synced from an iCal subscription)",
"enum": [
"internal",
"external_ical"
],
"type": "string"
},
"start_after": {
"description": "Only events starting after this ISO 8601 time",
"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))$",
"type": "string"
},
"start_before": {
"description": "Only events starting before this ISO 8601 time",
"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))$",
"type": "string"
},
"status": {
"description": "Filter by event status",
"enum": [
"confirmed",
"tentative",
"cancelled",
"hold"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_events",
"outputSchema": null
},
{
"description": "List an agent's external iCal feed subscriptions (e.g. linked Google Calendar / Outlook feeds), including their sync status and last sync time.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID whose iCal subscriptions to list",
"type": "string"
},
"limit": {
"default": 50,
"description": "Max results to return",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"description": "Filter by subscription status",
"enum": [
"active",
"error",
"paused"
],
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "list_ical_subscriptions",
"outputSchema": null
},
{
"description": "List scheduling proposals for the org. Filter by status (pending|confirmed|expired|cancelled) or organizer_agent_id. Requires an org-level API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"description": "Max results (default 50)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Pagination offset (default 0)",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"organizer_agent_id": {
"description": "Filter by organizer agent",
"type": "string"
},
"status": {
"description": "Filter by proposal status",
"enum": [
"pending",
"confirmed",
"expired",
"cancelled"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_proposals",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_scoped_keys",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"include_payload": {
"description": "Include the full event payload sent on each delivery",
"type": "boolean"
},
"limit": {
"default": 20,
"description": "Max results to return",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"description": "Filter to a single delivery status",
"enum": [
"pending",
"delivered",
"failed"
],
"type": "string"
},
"webhook_id": {
"description": "Webhook subscription whose deliveries to list",
"type": "string"
}
},
"required": [
"webhook_id"
],
"type": "object"
},
"name": "list_webhook_deliveries",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 20,
"description": "Max results to return",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "list_webhooks",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"event_id": {
"description": "Event ID of the hold to release",
"type": "string"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "release_event",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"proposal_id": {
"description": "Proposal to resolve",
"type": "string"
}
},
"required": [
"proposal_id"
],
"type": "object"
},
"name": "resolve_proposal",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Participant agent responding",
"type": "string"
},
"counter_slots": {
"description": "Alternative slots when response is \"counter\"",
"items": {
"properties": {
"calendar_id": {
"description": "Calendar to create the event on if this slot is chosen. Defaults to the proposal's top-level calendar_id.",
"type": "string"
},
"end_time": {
"description": "Slot end time (ISO 8601), after start_time",
"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))$",
"type": "string"
},
"start_time": {
"description": "Slot start time (ISO 8601)",
"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))$",
"type": "string"
},
"weight": {
"default": 1,
"description": "Preference for this slot, 0–10 (higher = more preferred). Used to rank candidate slots when the proposal is resolved. Defaults to 1.",
"maximum": 10,
"minimum": 0,
"type": "number"
}
},
"required": [
"start_time",
"end_time"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"message": {
"description": "Optional note for the organizer",
"maxLength": 2000,
"type": "string"
},
"proposal_id": {
"description": "Proposal to respond to",
"type": "string"
},
"response": {
"description": "Decision from this agent",
"enum": [
"accept",
"decline",
"counter"
],
"type": "string"
},
"selected_slot_id": {
"description": "Required when response is \"accept\"",
"type": "string"
}
},
"required": [
"proposal_id",
"agent_id",
"response"
],
"type": "object"
},
"name": "respond_to_proposal",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"key_id": {
"description": "ID of the scoped key to revoke",
"type": "string"
}
},
"required": [
"key_id"
],
"type": "object"
},
"name": "revoke_scoped_key",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"buffer_after_minutes": {
"default": 0,
"description": "Minutes of buffer after each event (0–120)",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"buffer_before_minutes": {
"default": 0,
"description": "Minutes of buffer before each event (0–120)",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"calendar_id": {
"description": "Calendar to configure",
"type": "string"
},
"timezone": {
"default": "UTC",
"description": "IANA timezone used to interpret working_hours (e.g. America/New_York)",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"working_hours": {
"anyOf": [
{
"properties": {
"fri": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"mon": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"sat": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"sun": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"thu": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"tue": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"wed": {
"description": "A single day's working hours window",
"properties": {
"end": {
"description": "End of the working window, HH:MM 24-hour, after start (e.g. \"17:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"start": {
"description": "Start of the working window, HH:MM 24-hour, in the rules timezone (e.g. \"09:00\")",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
}
},
"required": [
"start",
"end"
],
"type": "object"
}
},
"type": "object"
},
{
"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."
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "set_availability_rules",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID that will own this subscription",
"type": "string"
},
"calendar_id": {
"description": "Calendar ID to sync external events into",
"type": "string"
},
"label": {
"description": "Optional label for this subscription",
"type": "string"
},
"url": {
"description": "HTTPS URL of the iCal feed (.ics) to subscribe to",
"format": "uri",
"type": "string"
}
},
"required": [
"agent_id",
"calendar_id",
"url"
],
"type": "object"
},
"name": "subscribe_ical",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"subscription_id": {
"description": "iCal subscription ID to sync",
"type": "string"
}
},
"required": [
"subscription_id"
],
"type": "object"
},
"name": "sync_ical_subscription",
"outputSchema": null
},
{
"description": "Update an agent's name, description, metadata, or status (active/paused). Requires an org-level API key — agent-scoped keys cannot mutate agents.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_id": {
"description": "Agent ID to update",
"type": "string"
},
"description": {
"description": "New description (null to clear)",
"type": [
"string",
"null"
]
},
"metadata": {
"additionalProperties": {},
"description": "Arbitrary metadata (max 16KB)",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"name": {
"description": "New display name",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"status": {
"description": "Operational status",
"enum": [
"active",
"paused"
],
"type": "string"
}
},
"required": [
"agent_id"
],
"type": "object"
},
"name": "update_agent",
"outputSchema": null
},
{
"description": "Update a calendar's name, timezone, agent status, default reminders, or metadata. Agent-scoped keys may only update calendars owned by their agent.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agent_status": {
"description": "Owning agent's status",
"enum": [
"idle",
"working",
"waiting",
"error"
],
"type": "string"
},
"calendar_id": {
"description": "Calendar ID to update",
"type": "string"
},
"default_reminders": {
"anyOf": [
{
"items": {
"maximum": 40320,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"type": "array"
},
{
"type": "null"
}
],
"description": "Default reminder offsets in minutes; null for system default, [] for none"
},
"metadata": {
"additionalProperties": {},
"description": "Arbitrary metadata (max 16KB)",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"name": {
"description": "New calendar name",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"timezone": {
"description": "New IANA timezone (e.g. America/New_York)",
"minLength": 1,
"type": "string"
}
},
"required": [
"calendar_id"
],
"type": "object"
},
"name": "update_calendar",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"all_day": {
"description": "Whether this is an all-day event",
"type": "boolean"
},
"calendar_id": {
"description": "Calendar ID that owns the event. Optional — if omitted the calendar is resolved from the event.",
"type": "string"
},
"description": {
"description": "New description, or null to clear it",
"type": [
"string",
"null"
]
},
"end_time": {
"description": "New end time (ISO 8601)",
"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))$",
"type": "string"
},
"event_id": {
"description": "Event ID to update",
"type": "string"
},
"metadata": {
"additionalProperties": {},
"description": "Replacement metadata object",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"recurrence_rule": {
"anyOf": [
{
"maxLength": 256,
"type": "string"
},
{
"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."
},
"reminders": {
"anyOf": [
{
"items": {
"maximum": 40320,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"type": "array"
},
{
"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": {
"description": "New start time (ISO 8601)",
"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))$",
"type": "string"
},
"status": {
"description": "New event status",
"enum": [
"confirmed",
"tentative",
"cancelled"
],
"type": "string"
},
"title": {
"description": "New event title",
"maxLength": 500,
"minLength": 1,
"type": "string"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "update_event",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"label": {
"description": "New label for this subscription",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"subscription_id": {
"description": "iCal subscription ID to update",
"type": "string"
},
"url": {
"description": "New HTTPS URL of the iCal feed (.ics)",
"format": "starts_with",
"pattern": "^https:\\/\\/.*",
"type": "string"
}
},
"required": [
"subscription_id"
],
"type": "object"
},
"name": "update_ical_subscription",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"active": {
"description": "Set false to pause deliveries, true to resume",
"type": "boolean"
},
"events": {
"description": "Replacement set of event types to subscribe to",
"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,
"type": "array"
},
"url": {
"description": "New HTTPS delivery endpoint",
"format": "uri",
"type": "string"
},
"webhook_id": {
"description": "Webhook subscription to update",
"type": "string"
}
},
"required": [
"webhook_id"
],
"type": "object"
},
"name": "update_webhook",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:d4aa5f0cecfaca4018134c3966ae2d040209f501a5c01754a0ea9d6052afb96c | sha256sum