---
name: agency-events
description: Events actions of the Favorited Agency Dashboard MCP server (8): events.cancel, events.cancelSeries, events.create, events.get, events.list, events.members, events.types, events.update.
metadata:
  area: events
  actions: 8
  server: https://mcp.agency.preprod.favorited.app/mcp
---

# Events via the Favorited Agency MCP server

Connect to `https://mcp.agency.preprod.favorited.app/mcp` (Streamable HTTP, OAuth — see `https://mcp.agency.preprod.favorited.app/auth.md`). Call `whoami` first, then `agency.search` / `agency.describe` / `agency.execute` for the actions below, or the front-door tools where one exists.

## Actions

### agency/events.cancel

Cancel one event.

- Class: `destructive` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `events.cancel` and the events feature.
- REST equivalent: `DELETE /api/v1/events/{id}`.
- Parameters:
  - `id` (string, required)

### agency/events.cancelSeries

Cancel a whole recurring series.

- Class: `destructive` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `events.cancel` and the events feature.
- REST equivalent: `DELETE /api/v1/events/series/{seriesId}`.
- Parameters:
  - `seriesId` (string, required)

### agency/events.create

Schedule an event (optionally recurring).

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `events.create` and the events feature.
- REST equivalent: `POST /api/v1/events`.
- Parameters:
  - `description` (string)
  - `endTime` (string, required)
  - `eventTypeId` (string)
  - `hostUserId` (string)
  - `memberUserIds` (array, required)
  - `repeatCadence` (`weekly` | `bi-weekly` | `monthly`)
  - `repeatWeeks` (integer)
  - `startTime` (string, required)
  - `title` (string, required)

### agency/events.get

One event.

- Class: `read`.
- Requires: `events.get` and the events feature.
- REST equivalent: `GET /api/v1/events/{id}`.
- Parameters:
  - `id` (string, required)

### agency/events.list

Scheduled events in a date range.

- Class: `read`.
- Requires: `events.get` and the events feature.
- REST equivalent: `GET /api/v1/events`.
- Parameters:
  - `from` (string)
  - `to` (string)

### agency/events.members

Agency members available as event participants.

- Class: `read`.
- Requires: `events.get` and the events feature.
- REST equivalent: `GET /api/v1/events/agency-members`.
- Parameters: none.

### agency/events.types

The event types an agency can schedule.

- Class: `read`.
- Requires: `events.get` and the events feature.
- REST equivalent: `GET /api/v1/events/types`.
- Parameters: none.

### agency/events.update

Edit an event's details or time.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `events.update` and the events feature.
- REST equivalent: `PATCH /api/v1/events/{id}`.
- Parameters:
  - `description` (string)
  - `endTime` (string)
  - `eventTypeId` (string)
  - `hostUserId` (string)
  - `id` (string, required)
  - `memberUserIds` (array)
  - `startTime` (string)
  - `status` (`scheduled` | `cancelled` | `completed`)
  - `title` (string)