API Reference - Meridian

Getting Started

Meridian provides a powerful API built on the Model Context Protocol (MCP) with JSON-RPC 2.0 for AI tool integrations, plus standard REST endpoints for specific operations. The API exposes 40 tools covering event types, bookings, availability, scheduling polls, links, webhooks, and more.

All MCP tool calls are made via a single POST /api/mcp endpoint using JSON-RPC 2.0. You can also browse and download the OpenAPI 3.1 specification for use with code generators and API clients.

Authentication

Meridian supports three authentication methods. Choose the one that best fits your integration.

API Keys (Recommended)

Generate API keys in Dashboard > Settings > API Keys. Keys are prefixed with mk_ and should be sent as a Bearer token in the Authorization header.

cURL example

curl -X POST https://your-domain/api/mcp \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

OAuth 2.1

For MCP-compatible clients that support OAuth-based authentication. Discovery metadata is available at /.well-known/oauth-protected-resource. The authorization server metadata is auto-discovered per RFC 8414.

Session Cookie

For browser-based access. When authenticated via the Meridian dashboard, API calls from the same browser session are automatically authenticated using the session cookie.

Base URL

Production

https://i60-meridian-production.up.railway.app

All API endpoints are relative to this base URL. For local development, use http://localhost:3000.

MCP Protocol

Meridian implements the Model Context Protocol (MCP) over HTTP using JSON-RPC 2.0. All tool interactions go through a single endpoint: POST /api/mcp

Supported Methods

Method	Description
initialize	Handshake with the server. Returns protocol version and server capabilities.
notifications/initialized	Notification sent after successful initialization.
tools/list	List all available tools with schemas and annotations.
tools/call	Execute a tool by name with the provided arguments.
ping	Health check. Returns a pong response.

Request Format

tools/call request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_types",
    "arguments": {
      "status": "active"
    }
  },
  "id": 1
}

Response Envelope

All tool responses are wrapped in a profiled envelope that includes success status, the data payload, and contextual metadata.

tools/call response

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"success\":true,\"status\":\"completed\",\"data\":[\"...\"],\"context\":{\"warnings\":[],\"itemsProcessed\":3,\"suggestedNextActions\":[\"get_event_type\",\"create_event_type\"]}}"
      }
    ]
  },
  "id": 1
}

REST Endpoints

In addition to the MCP protocol, Meridian provides the following REST endpoints for specific operations.

GET/api/mcp

Server discovery information. Returns protocol version, server name, and capabilities. Used by MCP clients during initial discovery.

Auth: None

GET/api/booking/{uid}/ics

Download an ICS calendar file for a specific booking. The {uid} parameter is the unique booking identifier.

Auth: None (public link)

POST/api/cron/reminders

Trigger processing of pending booking reminders. Sends reminder emails for upcoming bookings based on configured reminder windows.

Auth: CRON_SECRET header

GET/api/openapi

Download the OpenAPI 3.1 specification for the Meridian API. Useful for code generation and API client libraries.

Auth: None

Tool Reference

Meridian exposes 40 tools through the MCP protocol, organized into the categories below. Each tool can be called via the tools/call JSON-RPC method.

Event Types6 tools

list_event_types

List Event TypesreadOnly

List all event types for the current user. Returns title, slug, duration, location type, active status, and booking link.

Parameters

Name	Type	Required	Description
status	`string` activeinactiveall	No	Filter by active status (default: all)

statusstring

Filter by active status (default: all)

activeinactiveall

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_types",
    "arguments": {
      "status": "active"
    }
  },
  "id": 1
}

get_event_type

Get Event TypereadOnly

Get full details of a specific event type by ID, including custom questions and scheduling rules.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID

idstringrequired

Event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_event_type",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

create_event_type

Create Event Typedestructive

Create a new event type. Requires title, slug, and duration. Returns the created event type.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Event type title
slug	`string`	Yes	URL-friendly slug (lowercase, hyphens only, e.g. 'quick-chat')
description	`string`	No	Optional description of the event
duration	`integer`	Yes	Duration in minutes (5-480, default 30)
color	`string`	No	Hex color code (default #6366f1)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	Meeting location type (default google_meet)
locationValue	`string`	No	Location details (address, phone, URL) — required for non-google_meet types
bufferBefore	`integer`	No	Buffer minutes before event (0-120, default 0)
bufferAfter	`integer`	No	Buffer minutes after event (0-120, default 0)
minNotice	`integer`	No	Minimum notice in minutes before booking (default 240 = 4 hours)
maxDaysAhead	`integer`	No	Max days into the future for booking (default 60)
requiresConfirmation	`boolean`	No	Require host confirmation for bookings (default false)
slotInterval	`integer`	No	Slot interval in minutes. If omitted, uses duration.
dailyLimit	`integer`	No	Max bookings per day for this event type
weeklyLimit	`integer`	No	Max bookings per week for this event type
allowReschedule	`boolean`	No	Allow invitees to reschedule (default true)
allowCancellation	`boolean`	No	Allow invitees to cancel (default true)
reminderEnabled	`boolean`	No	Enable email reminders (default true)
reminderHoursBefore	`number[]`	No	Hours before meeting to send reminders (default [24, 1])
recurringEnabled	`boolean`	No	Allow recurring bookings (default false)
recurringConfig	`object`	No	Recurring event configuration
maxInvitees	`integer`	No	Max invitees per slot. 1=1:1, >1=group, 0=unlimited (default 1)
schedulingType	`string` individualround_robincollective	No	Scheduling type (default individual)
isSecret	`boolean`	No	Hide from public booking page (only accessible via direct link)
durationOptions	`number[]`	No	Additional duration options invitees can choose from (e.g. [15, 30, 60])
monthlyLimit	`integer`	No	Max bookings per month for this event type
maxDaysAheadMode	`string` rollingrangeindefinite	No	How to calculate the booking window cutoff (default 'days')
maxDaysAheadEnd	`string`	No	Fixed end date for booking window (YYYY-MM-DD). Only used when maxDaysAheadMode is 'date'.
roundRobinMode	`string` round_robinavailability	No	Round-robin assignment mode: strict rotation or most-available-first

titlestringrequired

Event type title

slugstringrequired

URL-friendly slug (lowercase, hyphens only, e.g. 'quick-chat')

descriptionstring

Optional description of the event

durationintegerrequired

Duration in minutes (5-480, default 30)

colorstring

Hex color code (default #6366f1)

locationTypestring

Meeting location type (default google_meet)

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

Location details (address, phone, URL) — required for non-google_meet types

bufferBeforeinteger

Buffer minutes before event (0-120, default 0)

bufferAfterinteger

Buffer minutes after event (0-120, default 0)

minNoticeinteger

Minimum notice in minutes before booking (default 240 = 4 hours)

maxDaysAheadinteger

Max days into the future for booking (default 60)

requiresConfirmationboolean

Require host confirmation for bookings (default false)

slotIntervalinteger

Slot interval in minutes. If omitted, uses duration.

dailyLimitinteger

Max bookings per day for this event type

weeklyLimitinteger

Max bookings per week for this event type

allowRescheduleboolean

Allow invitees to reschedule (default true)

allowCancellationboolean

Allow invitees to cancel (default true)

reminderEnabledboolean

Enable email reminders (default true)

reminderHoursBeforenumber[]

Hours before meeting to send reminders (default [24, 1])

recurringEnabledboolean

Allow recurring bookings (default false)

recurringConfigobject

Recurring event configuration

maxInviteesinteger

Max invitees per slot. 1=1:1, >1=group, 0=unlimited (default 1)

schedulingTypestring

Scheduling type (default individual)

individualround_robincollective

isSecretboolean

Hide from public booking page (only accessible via direct link)

durationOptionsnumber[]

Additional duration options invitees can choose from (e.g. [15, 30, 60])

monthlyLimitinteger

Max bookings per month for this event type

maxDaysAheadModestring

How to calculate the booking window cutoff (default 'days')

rollingrangeindefinite

maxDaysAheadEndstring

Fixed end date for booking window (YYYY-MM-DD). Only used when maxDaysAheadMode is 'date'.

roundRobinModestring

Round-robin assignment mode: strict rotation or most-available-first

round_robinavailability

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_event_type",
    "arguments": {
      "title": "<title>",
      "slug": "<slug>"
    }
  },
  "id": 1
}

update_event_type

Update Event Typedestructiveidempotent

Update fields on an existing event type. Only provided fields are changed.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID to update
title	`string`	No	New title
description	`string`	No	New description
duration	`integer`	No	New duration in minutes
color	`string`	No	New hex color
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	--
locationValue	`string`	No	--
bufferBefore	`integer`	No	--
bufferAfter	`integer`	No	--
minNotice	`integer`	No	--
maxDaysAhead	`integer`	No	--
requiresConfirmation	`boolean`	No	--
allowReschedule	`boolean`	No	--
allowCancellation	`boolean`	No	--
slotInterval	`integer`	No	Slot interval in minutes
dailyLimit	`integer`	No	Max bookings per day
weeklyLimit	`integer`	No	Max bookings per week
reminderEnabled	`boolean`	No	Enable email reminders
reminderHoursBefore	`number[]`	No	Hours before to send reminders
recurringEnabled	`boolean`	No	Allow recurring bookings
recurringConfig	`object`	No	--
maxInvitees	`integer`	No	Max invitees per slot
schedulingType	`string` individualround_robincollective	No	--
isSecret	`boolean`	No	Hide from public booking page
durationOptions	`number[]`	No	Additional duration options for invitees
monthlyLimit	`integer`	No	Max bookings per month
maxDaysAheadMode	`string` rollingrangeindefinite	No	Booking window cutoff mode
maxDaysAheadEnd	`string`	No	Fixed end date for booking window (YYYY-MM-DD)
roundRobinMode	`string` round_robinavailability	No	Round-robin assignment mode

idstringrequired

Event type UUID to update

titlestring

New title

descriptionstring

New description

durationinteger

New duration in minutes

colorstring

New hex color

locationTypestring

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

bufferBeforeinteger

bufferAfterinteger

minNoticeinteger

maxDaysAheadinteger

requiresConfirmationboolean

allowRescheduleboolean

allowCancellationboolean

slotIntervalinteger

Slot interval in minutes

dailyLimitinteger

Max bookings per day

weeklyLimitinteger

Max bookings per week

reminderEnabledboolean

Enable email reminders

reminderHoursBeforenumber[]

Hours before to send reminders

recurringEnabledboolean

Allow recurring bookings

recurringConfigobject

maxInviteesinteger

Max invitees per slot

schedulingTypestring

individualround_robincollective

isSecretboolean

Hide from public booking page

durationOptionsnumber[]

Additional duration options for invitees

monthlyLimitinteger

Max bookings per month

maxDaysAheadModestring

Booking window cutoff mode

rollingrangeindefinite

maxDaysAheadEndstring

Fixed end date for booking window (YYYY-MM-DD)

roundRobinModestring

Round-robin assignment mode

round_robinavailability

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_event_type",
    "arguments": {
      "id": "<id>",
      "title": "<title>"
    }
  },
  "id": 1
}

toggle_event_type

Toggle Event Typedestructiveidempotent

Enable or disable an event type. Disabled types cannot be booked.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID
isActive	`boolean`	Yes	true to enable, false to disable

idstringrequired

Event type UUID

isActivebooleanrequired

true to enable, false to disable

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "toggle_event_type",
    "arguments": {
      "id": "<id>",
      "isActive": true
    }
  },
  "id": 1
}

delete_event_type

Delete Event Typedestructive

Permanently delete an event type. This cannot be undone. Existing bookings are preserved.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID to delete

idstringrequired

Event type UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_event_type",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Bookings3 tools

list_bookings

List BookingsreadOnly

List bookings for the current user. Can filter by status and time period.

Parameters

Name	Type	Required	Description
status	`string` confirmedpendingcancelledall	No	Filter by booking status (default: confirmed)
timeframe	`string` upcomingpastall	No	Filter by time period relative to now (default: upcoming)
limit	`integer`	No	Max results to return (default: 50)
startDate	`string`	No	Filter bookings on or after this date (YYYY-MM-DD)
endDate	`string`	No	Filter bookings on or before this date (YYYY-MM-DD, inclusive)

statusstring

Filter by booking status (default: confirmed)

confirmedpendingcancelledall

timeframestring

Filter by time period relative to now (default: upcoming)

upcomingpastall

limitinteger

Max results to return (default: 50)

startDatestring

Filter bookings on or after this date (YYYY-MM-DD)

endDatestring

Filter bookings on or before this date (YYYY-MM-DD, inclusive)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_bookings",
    "arguments": {
      "status": "confirmed",
      "timeframe": "upcoming"
    }
  },
  "id": 1
}

get_booking

Get BookingreadOnly

Get full details of a specific booking by UID, including invitee info, responses, and meeting link.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID (the short public-facing ID)

uidstringrequired

Booking UID (the short public-facing ID)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_booking",
    "arguments": {
      "uid": "<uid>"
    }
  },
  "id": 1
}

cancel_booking

Cancel BookingdestructiveopenWorld

Cancel a confirmed booking as the host. Optionally provide a cancellation reason.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID to cancel
reason	`string`	No	Optional cancellation reason

uidstringrequired

Booking UID to cancel

reasonstring

Optional cancellation reason

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "cancel_booking",
    "arguments": {
      "uid": "<uid>",
      "reason": "<reason>"
    }
  },
  "id": 1
}

Availability & Slots3 tools

get_available_slots

Get Available SlotsreadOnly

Get available time slots for a specific event type on a given date. Returns times formatted in the specified timezone.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID to check
date	`string`	Yes	Date in ISO format (YYYY-MM-DD)
timezone	`string`	No	IANA timezone for display (e.g. 'America/New_York'). Defaults to user's timezone.
duration	`integer`	No	Override event type duration in minutes. Useful when the event type offers multiple duration options.

eventTypeIdstringrequired

Event type UUID to check

datestringrequired

Date in ISO format (YYYY-MM-DD)

timezonestring

IANA timezone for display (e.g. 'America/New_York'). Defaults to user's timezone.

durationinteger

Override event type duration in minutes. Useful when the event type offers multiple duration options.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_available_slots",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "date": "<date>"
    }
  },
  "id": 1
}

get_availability_schedule

Get Availability SchedulereadOnly

Get the user's availability schedule with all rules (days and time windows).

Parameters

Name	Type	Required	Description
scheduleId	`string`	No	Specific schedule UUID. If omitted, returns the default schedule.

scheduleIdstring

Specific schedule UUID. If omitted, returns the default schedule.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_availability_schedule",
    "arguments": {
      "scheduleId": "<scheduleId>"
    }
  },
  "id": 1
}

update_availability

Update Availabilitydestructiveidempotent

Update availability rules for a schedule. Replaces all rules for the specified days.

Parameters

Name	Type	Required	Description
scheduleId	`string`	Yes	Schedule UUID to update
days	`object`	Yes	Map of day-of-week (0=Sun..6=Sat) to availability. Each value: { "enabled": boolean, "windows": [{ "start": "HH:MM", "end": "HH:MM" }] }

scheduleIdstringrequired

Schedule UUID to update

daysobjectrequired

Map of day-of-week (0=Sun..6=Sat) to availability. Each value: { "enabled": boolean, "windows": [{ "start": "HH:MM", "end": "HH:MM" }] }

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_availability",
    "arguments": {
      "scheduleId": "<scheduleId>"
    }
  },
  "id": 1
}

Calendar Integration1 tool

list_connected_calendars

List Connected CalendarsreadOnly

List Google calendars connected to the user's account, showing which are used for conflict checking and booking creation.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_connected_calendars",
    "arguments": {}
  },
  "id": 1
}

User Profile2 tools

get_user_profile

Get User ProfilereadOnly

Get the current user's profile including name, email, username, and timezone.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_user_profile",
    "arguments": {}
  },
  "id": 1
}

update_profile

Update Profiledestructiveidempotent

Update the current user's profile (name, username, timezone, bio, branding).

Parameters

Name	Type	Required	Description
name	`string`	No	Display name
username	`string`	No	Unique username for booking page URL (lowercase, no spaces)
timezone	`string`	No	IANA timezone (e.g. 'America/New_York')
bio	`string`	No	Short bio displayed on booking page
brandColor	`string`	No	Hex color for booking page branding (e.g. '#6366f1')
brandLogoUrl	`string`	No	Logo URL for booking page branding
hideBranding	`boolean`	No	Hide 'Powered by Meridian' footer on booking pages

namestring

Display name

usernamestring

Unique username for booking page URL (lowercase, no spaces)

timezonestring

IANA timezone (e.g. 'America/New_York')

biostring

Short bio displayed on booking page

brandColorstring

Hex color for booking page branding (e.g. '#6366f1')

brandLogoUrlstring

Logo URL for booking page branding

hideBrandingboolean

Hide 'Powered by Meridian' footer on booking pages

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_profile",
    "arguments": {
      "name": "<name>",
      "username": "<username>"
    }
  },
  "id": 1
}

Scheduling Polls7 tools

create_poll

Create Scheduling PolldestructiveopenWorld

Create a scheduling poll with proposed time slots. Invitees vote on which slots work for them. Returns a public voting URL to share.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Poll title (e.g. 'IDRS Discussion')
description	`string`	No	Optional description
duration	`integer`	No	Meeting duration in minutes (default 30)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	Meeting location type (default google_meet)
locationValue	`string`	No	Location details (address, phone, URL)
eventTypeId	`string`	No	Event type UUID. Required for booking creation when poll resolves. If omitted, must be provided at resolve time.
slots	`object[]`	Yes	Proposed time slots for voting
inviteeEmails	`string[]`	No	Expected voter email addresses. When all have voted, auto-resolve triggers (if enabled).
autoResolve	`boolean`	No	Automatically book the best slot when all invitees have voted (default true)
deadline	`string`	No	Optional voting deadline as ISO 8601 timestamp

titlestringrequired

Poll title (e.g. 'IDRS Discussion')

descriptionstring

Optional description

durationinteger

Meeting duration in minutes (default 30)

locationTypestring

Meeting location type (default google_meet)

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

Location details (address, phone, URL)

eventTypeIdstring

Event type UUID. Required for booking creation when poll resolves. If omitted, must be provided at resolve time.

slotsobject[]required

Proposed time slots for voting

inviteeEmailsstring[]

Expected voter email addresses. When all have voted, auto-resolve triggers (if enabled).

autoResolveboolean

Automatically book the best slot when all invitees have voted (default true)

deadlinestring

Optional voting deadline as ISO 8601 timestamp

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_poll",
    "arguments": {
      "title": "<title>",
      "description": "<description>"
    }
  },
  "id": 1
}

update_poll

Update Polldestructiveidempotent

Update an open scheduling poll's details or time slots. Only open polls can be edited. Slots with votes cannot be removed.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to update
title	`string`	No	New poll title
description	`string`	No	New description (or null to clear)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	New meeting location type
locationValue	`string`	No	New location details
deadline	`string`	No	New voting deadline (ISO 8601) or null to remove
autoResolve	`boolean`	No	Enable/disable auto-resolve when all invitees vote
eventTypeId	`string`	No	Event type UUID for booking creation at resolve time
inviteeEmails	`string[]`	No	Replace expected voter emails. Existing voters are preserved.
addSlots	`object[]`	No	New time slots to add to the poll
removeSlotIds	`string[]`	No	Slot UUIDs to remove. Fails if any slot has votes.

pollIdstringrequired

Poll UUID or UID to update

titlestring

New poll title

descriptionstring

New description (or null to clear)

locationTypestring

New meeting location type

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

New location details

deadlinestring

New voting deadline (ISO 8601) or null to remove

autoResolveboolean

Enable/disable auto-resolve when all invitees vote

eventTypeIdstring

Event type UUID for booking creation at resolve time

inviteeEmailsstring[]

Replace expected voter emails. Existing voters are preserved.

addSlotsobject[]

New time slots to add to the poll

removeSlotIdsstring[]

Slot UUIDs to remove. Fails if any slot has votes.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_poll",
    "arguments": {
      "pollId": "<pollId>",
      "title": "<title>"
    }
  },
  "id": 1
}

get_poll_results

Get Poll ResultsreadOnly

Get vote tallies per slot, who has/hasn't voted, and the best matching slot for a scheduling poll.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID

pollIdstringrequired

Poll UUID or UID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_poll_results",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

resolve_poll

Resolve PolldestructiveopenWorld

Resolve a scheduling poll by selecting a winning slot. Creates a real booking for that slot and discards the rest.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID
slotId	`string`	No	Winning slot UUID. If omitted, auto-picks the best match.
eventTypeId	`string`	No	Event type UUID for the booking. Required if not set on the poll.

pollIdstringrequired

Poll UUID or UID

slotIdstring

Winning slot UUID. If omitted, auto-picks the best match.

eventTypeIdstring

Event type UUID for the booking. Required if not set on the poll.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "resolve_poll",
    "arguments": {
      "pollId": "<pollId>",
      "slotId": "<slotId>"
    }
  },
  "id": 1
}

list_polls

List PollsreadOnly

List scheduling polls for the current user. Can filter by status.

Parameters

Name	Type	Required	Description
status	`string` openclosedbookedall	No	Filter by poll status (default: all)

statusstring

Filter by poll status (default: all)

openclosedbookedall

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_polls",
    "arguments": {
      "status": "open"
    }
  },
  "id": 1
}

close_poll

Close Polldestructiveidempotent

Close an open poll to stop voting. Does not create a booking. Use resolve_poll to pick a winner first if needed.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to close

pollIdstringrequired

Poll UUID or UID to close

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "close_poll",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

delete_poll

Delete Polldestructive

Permanently delete a scheduling poll and all its votes. This cannot be undone.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to delete

pollIdstringrequired

Poll UUID or UID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_poll",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

Scheduling Links6 tools

create_scheduling_link

Create Scheduling LinkdestructiveopenWorld

Create a scheduling link (single-use or offer-times). Optionally sends an invitation email. Returns the shareable booking URL.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID for this link
type	`string` single_useoffer_times	Yes	Link type: single_use (one booking) or offer_times (invitee picks from offered slots)
inviteeName	`string`	No	Name of the invitee
inviteeEmail	`string`	No	Email of the invitee (required if sendEmail is true)
offeredSlots	`object[]`	No	Specific time slots to offer (required for offer_times type)
allowOutsideAvailability	`boolean`	No	Allow booking outside normal availability hours (default false)
reserveHolds	`boolean`	No	Create tentative calendar holds for offered slots (default false)
singleUse	`boolean`	No	Link can only be used once (default true for single_use type)
expiresIn	`string` 24h48h7d30d	No	Link expiry duration
sendEmail	`boolean`	No	Send invitation email to invitee (default false)
message	`string`	No	Optional message included in the invitation email

eventTypeIdstringrequired

Event type UUID for this link

typestringrequired

Link type: single_use (one booking) or offer_times (invitee picks from offered slots)

single_useoffer_times

inviteeNamestring

Name of the invitee

inviteeEmailstring

Email of the invitee (required if sendEmail is true)

offeredSlotsobject[]

Specific time slots to offer (required for offer_times type)

allowOutsideAvailabilityboolean

Allow booking outside normal availability hours (default false)

reserveHoldsboolean

Create tentative calendar holds for offered slots (default false)

singleUseboolean

Link can only be used once (default true for single_use type)

expiresInstring

Link expiry duration

24h48h7d30d

sendEmailboolean

Send invitation email to invitee (default false)

messagestring

Optional message included in the invitation email

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_scheduling_link",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "type": "single_use"
    }
  },
  "id": 1
}

list_scheduling_links

List Scheduling LinksreadOnly

List scheduling links for the current user. Can filter by status and event type.

Parameters

Name	Type	Required	Description
status	`string` allactiveusedexpiredcancelled	No	Filter by link status (default: all)
eventTypeId	`string`	No	Filter by event type UUID

statusstring

Filter by link status (default: all)

allactiveusedexpiredcancelled

eventTypeIdstring

Filter by event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_scheduling_links",
    "arguments": {
      "status": "all",
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

get_scheduling_link

Get Scheduling LinkreadOnly

Get full details of a scheduling link by ID or token, including calendar holds.

Parameters

Name	Type	Required	Description
linkId	`string`	No	Scheduling link UUID
token	`string`	No	Scheduling link token

linkIdstring

Scheduling link UUID

tokenstring

Scheduling link token

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_scheduling_link",
    "arguments": {
      "linkId": "<linkId>",
      "token": "<token>"
    }
  },
  "id": 1
}

cancel_scheduling_link

Cancel Scheduling Linkdestructive

Cancel an active scheduling link. Releases any calendar holds.

Parameters

Name	Type	Required	Description
linkId	`string`	Yes	Scheduling link UUID to cancel

linkIdstringrequired

Scheduling link UUID to cancel

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "cancel_scheduling_link",
    "arguments": {
      "linkId": "<linkId>"
    }
  },
  "id": 1
}

delete_scheduling_link

Delete Scheduling Linkdestructive

Permanently delete a non-active scheduling link. Active links must be cancelled first.

Parameters

Name	Type	Required	Description
linkId	`string`	Yes	Scheduling link UUID to delete

linkIdstringrequired

Scheduling link UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_scheduling_link",
    "arguments": {
      "linkId": "<linkId>"
    }
  },
  "id": 1
}

offer_times

Offer TimesdestructiveopenWorld

Convenience tool: create an offer-times scheduling link from a list of start times. Automatically calculates end times from duration, reserves calendar holds, and sends an invitation email.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
inviteeEmail	`string`	Yes	Email of the invitee
inviteeName	`string`	No	Name of the invitee
slots	`string[]`	Yes	Array of ISO 8601 UTC start times to offer (e.g. ['2025-01-15T10:00:00Z', '2025-01-15T14:00:00Z'])
duration	`integer`	No	Meeting duration in minutes. If omitted, uses the event type's default duration.
reserveHolds	`boolean`	No	Create tentative calendar holds for offered slots (default true)
sendEmail	`boolean`	No	Send invitation email to invitee (default true)
expiresIn	`string` 24h48h7d30d	No	Link expiry duration (default '48h')
message	`string`	No	Optional message included in the invitation email

eventTypeIdstringrequired

Event type UUID

inviteeEmailstringrequired

Email of the invitee

inviteeNamestring

Name of the invitee

slotsstring[]required

Array of ISO 8601 UTC start times to offer (e.g. ['2025-01-15T10:00:00Z', '2025-01-15T14:00:00Z'])

durationinteger

Meeting duration in minutes. If omitted, uses the event type's default duration.

reserveHoldsboolean

Create tentative calendar holds for offered slots (default true)

sendEmailboolean

Send invitation email to invitee (default true)

expiresInstring

Link expiry duration (default '48h')

24h48h7d30d

messagestring

Optional message included in the invitation email

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "offer_times",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "inviteeEmail": "<inviteeEmail>"
    }
  },
  "id": 1
}

Availability Overrides1 tool

add_availability_override

Add Availability Overridedestructiveidempotent

Block off a specific date or set custom hours for a date. Omit start/end times to block the entire day.

Parameters

Name	Type	Required	Description
date	`string`	Yes	Date to override (YYYY-MM-DD)
startTime	`string`	No	Custom start time (HH:MM). Omit to block the entire day.
endTime	`string`	No	Custom end time (HH:MM). Omit to block the entire day.
scheduleId	`string`	No	Schedule UUID. If omitted, uses the default schedule.

datestringrequired

Date to override (YYYY-MM-DD)

startTimestring

Custom start time (HH:MM). Omit to block the entire day.

endTimestring

Custom end time (HH:MM). Omit to block the entire day.

scheduleIdstring

Schedule UUID. If omitted, uses the default schedule.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add_availability_override",
    "arguments": {
      "date": "<date>",
      "startTime": "<startTime>"
    }
  },
  "id": 1
}

Webhooks4 tools

register_webhook

Parameters

Name	Type	Required	Description
url	`string`	Yes	Endpoint URL to receive webhook POSTs
events	`string[]`	Yes	Events to subscribe to

urlstringrequired

Endpoint URL to receive webhook POSTs

eventsstring[]required

Events to subscribe to

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "register_webhook",
    "arguments": {
      "url": "<url>"
    }
  },
  "id": 1
}

list_webhooks

List WebhooksreadOnly

List all registered webhooks for the current user.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_webhooks",
    "arguments": {}
  },
  "id": 1
}

delete_webhook

Delete Webhookdestructive

Delete a registered webhook.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Webhook UUID to delete

idstringrequired

Webhook UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_webhook",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

test_webhook

Test WebhookdestructiveopenWorld

Send a test delivery to a registered webhook.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Webhook UUID to test

idstringrequired

Webhook UUID to test

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "test_webhook",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Team Members3 tools

add_event_type_member

Add Event Type Memberdestructive

Add a team member to an event type for round-robin or collective scheduling.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
userId	`string`	Yes	User ID of the team member to add

eventTypeIdstringrequired

Event type UUID

userIdstringrequired

User ID of the team member to add

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add_event_type_member",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "userId": "<userId>"
    }
  },
  "id": 1
}

remove_event_type_member

Remove Event Type Memberdestructive

Remove a team member from an event type.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
userId	`string`	Yes	User ID of the member to remove

eventTypeIdstringrequired

Event type UUID

userIdstringrequired

User ID of the member to remove

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "remove_event_type_member",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "userId": "<userId>"
    }
  },
  "id": 1
}

list_event_type_members

List Event Type MembersreadOnly

List all team members assigned to an event type.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID

eventTypeIdstringrequired

Event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_type_members",
    "arguments": {
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

Routing Forms4 tools

create_routing_form

Create Routing Formdestructive

Create a routing form to qualify leads and direct them to the right event type.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Form title
slug	`string`	Yes	URL slug (lowercase, hyphens)
description	`string`	No	Optional form description
fields	`object[]`	Yes	Form fields
rules	`object[]`	Yes	Routing rules (first match wins)

titlestringrequired

Form title

slugstringrequired

URL slug (lowercase, hyphens)

descriptionstring

Optional form description

fieldsobject[]required

Form fields

rulesobject[]required

Routing rules (first match wins)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_routing_form",
    "arguments": {
      "title": "<title>",
      "slug": "<slug>"
    }
  },
  "id": 1
}

update_routing_form

Update Routing Formdestructiveidempotent

Update an existing routing form's fields, rules, or settings.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Routing form UUID
title	`string`	No	--
slug	`string`	No	--
description	`string`	No	--
fields	`object[]`	No	--
rules	`object[]`	No	--
isActive	`boolean`	No	--

idstringrequired

Routing form UUID

titlestring

slugstring

descriptionstring

fieldsobject[]

rulesobject[]

isActiveboolean

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_routing_form",
    "arguments": {
      "id": "<id>",
      "title": "<title>"
    }
  },
  "id": 1
}

list_routing_forms

List Routing FormsreadOnly

List all routing forms for the current user.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_routing_forms",
    "arguments": {}
  },
  "id": 1
}

delete_routing_form

Delete Routing Formdestructive

Permanently delete a routing form.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Routing form UUID to delete

idstringrequired

Routing form UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_routing_form",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Error Codes

The API uses standard JSON-RPC 2.0 error codes. When an error occurs, the response will contain an error object instead of a result.

Code	Name	Description
-32700	Parse error	Invalid JSON was received by the server.
-32600	Invalid request	The JSON sent is not a valid JSON-RPC request.
-32601	Method not found	The method does not exist or is not available.
-32602	Invalid params	Invalid method parameter(s). Check required fields and types.
-32001	Authentication error	Missing or invalid authentication credentials.
-32603	Internal error	Internal JSON-RPC error. An unexpected server-side issue.

Error response example

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication required"
  },
  "id": 1
}

Rate Limiting

Limits are applied per client IP on a rolling one-minute window. Exceeding a limit returns 429 Too Many Requests with a Retry-After header (seconds until the window reopens).

Endpoint	Limit	Window
/api/mcp	60 req	1 min
/api/auth/* (POST)	5 req	1 min
createBooking (public)	10 req	1 min

429 responses include headers: X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After. Build exponential backoff into your client for robustness.

40 tools across 11 categories

Meridian API Reference

Getting Started

Authentication

API Keys (Recommended)

OAuth 2.1

Session Cookie

Base URL

MCP Protocol

Supported Methods

Request Format

Response Envelope

REST Endpoints

Tool Reference

Event Types6 tools

list_event_types

Parameters

get_event_type

Parameters

create_event_type

Parameters

update_event_type

Parameters

toggle_event_type

Parameters

delete_event_type

Parameters

Bookings3 tools

list_bookings

Parameters

get_booking

Parameters

cancel_booking

Parameters

Availability & Slots3 tools

get_available_slots

Parameters

get_availability_schedule

Parameters

update_availability

Parameters

Calendar Integration1 tool

list_connected_calendars

Parameters

User Profile2 tools

get_user_profile

Parameters

update_profile

Parameters

Scheduling Polls7 tools

create_poll

Parameters

update_poll

Parameters

get_poll_results

Parameters

resolve_poll

Parameters

list_polls

Parameters

close_poll

Parameters

delete_poll

Parameters

Scheduling Links6 tools

create_scheduling_link

Parameters

list_scheduling_links

Parameters

get_scheduling_link

Parameters

cancel_scheduling_link

Parameters

delete_scheduling_link

Parameters

offer_times

Parameters

Availability Overrides1 tool

add_availability_override

Parameters

Webhooks4 tools