> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Goldcast

**Authentication:** API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Create a new event for our Q3 product launch webinar.
* List the agenda items for next week's virtual conference.
* Show me the recordings from last month's user summit.
* Add a sponsor booth for Acme to the partner expo.

## Available Tools

#### list\_agenda\_items

List agenda items with paging, optionally filtered to one event. Pass `event` in almost all cases: unfiltered this sp...

#### get\_agenda\_item

Get one agenda item by ID. Use list\_agenda\_items to find agenda item IDs.

#### create\_agenda\_item

Add an agenda item to an event. Requires event, title, start\_time, and end\_time. Use list\_events to find event IDs an...

#### update\_agenda\_item

Update an agenda item. Only the fields you pass are changed. Use list\_agenda\_items to find agenda item IDs.Passing nu...

#### delete\_agenda\_item

Delete an agenda item permanently. This cannot be undone. Use list\_agenda\_items to find agenda item IDs.

#### list\_booths

List booths with paging and filters. Organization-wide this collection is very large, so filter by `event`. Use list\_...

#### get\_booth

Get one booth by ID, including its branding, resources, tags, and demo-request setup. Use list\_booths to find booth I...

#### create\_booth

Create a booth on an event. Requires event and name. Use list\_events to find event IDs, list\_tags for tags, and list\_...

#### update\_booth

Update a booth. Only the fields you pass are changed. Use list\_booths to find booth IDs.Passing null does not clear a...

#### delete\_booth

Delete a booth permanently. This cannot be undone. Use list\_booths to find booth IDs.

#### list\_broadcasts

List an event's broadcasts (streamed sessions) with paging and filters. `event` is required: the API returns 404 with...

#### get\_broadcast

Get one broadcast by ID with its streaming and stage configuration. Returns all 109 fields by default — pass `fields`...

#### create\_broadcast

Create a broadcast (streamed session) on an event. Requires event, title, start\_time, end\_time, and — because the API...

#### update\_broadcast

Update a broadcast. Only the fields you pass are changed. Use `extra_fields` for stage or streaming settings this too...

#### delete\_broadcast

Delete a broadcast permanently, including its polls and Q\&A. This cannot be undone. Use list\_broadcasts to find broad...

#### list\_discussion\_groups

List discussion groups (breakout and booth rooms) for an event, with paging and filters. Always pass `event`: org-wid...

#### get\_discussion\_group

Get one discussion group by ID. Use list\_discussion\_groups to find discussion group IDs.

#### create\_discussion\_group

Create a discussion group on an event. Requires event, title, and capacity. Use list\_events to find event IDs and lis...

#### update\_discussion\_group

Update a discussion group. Only the fields you pass are changed. Use list\_discussion\_groups to find discussion group...

#### delete\_discussion\_group

Delete a discussion group permanently. This cannot be undone. Use list\_discussion\_groups to find discussion group IDs.

#### list\_event\_members

List an event's registrants and attendees with paging and filters. `event` is required. Filter by attendance, status,...

#### get\_event\_member

Get one event member by ID, including attendance, consent, and UTM attribution. The ID is an integer, not a UUID. Use...

#### create\_event\_member

Register a person for an event. `user` is a bare user UUID, not an object — get it from list\_event\_members on an even...

#### list\_events

List Goldcast events with paging, filters, and sorting. Use this to browse or find event IDs for nearly every other t...

#### get\_event

Get one Goldcast event by ID: schedule, timezone, type, branding, registration and integration settings. Returns all...

#### create\_event

Create a Goldcast event. Requires title, start\_time, end\_time, timezone, plus an organization ID from list\_organizati...

#### update\_event

Update a Goldcast event. Only the fields you pass are changed. Use `extra_fields` to set event settings this tool doe...

#### delete\_event

Permanently delete a Goldcast event, including its sessions, agenda, and registrant records. This cannot be undone. U...

#### duplicate\_event

Duplicate a Goldcast event into a new one, optionally copying speakers and staff. `fields` selects which parts of the...

#### get\_event\_agenda

Get an event's assembled agenda as a single object, including its associated broadcast. This endpoint is not paginate...

#### get\_event\_recordings

List the recordings available for an event, with paging. Use list\_events to find event IDs. Returns an empty list whe...

#### list\_organizations

List Goldcast organizations visible to this API token, with paging and filters. A token is normally scoped to one org...

#### get\_organization

Get one Goldcast organization by ID, including its full settings and feature flags. Use list\_organizations to find or...

#### list\_polls

List every poll on a broadcast. Not paginated — returns them all at once. Use list\_broadcasts to find broadcast IDs....

#### create\_poll

Add a poll to a broadcast. Requires the question text, a poll type, and the answer options. Goldcast publishes no enu...

#### update\_poll

Replace a poll's question, type, and answer options. This is a full replacement, not a merge: the answers you pass be...

#### delete\_polls

Delete one or more polls from a broadcast, by poll ID. Only the polls you list are removed, and several can go in one...

#### get\_public\_agenda

Get the publicly visible agenda from an event's registration page. Needs no credential and shows only what a prospect...

#### get\_public\_speakers

Get the publicly visible speakers from an event's registration page. Needs no credential. Use list\_event\_members with...

#### get\_public\_booths

Get the publicly visible booths from an event's registration page, split into primary and secondary tiers. Needs no c...

#### get\_public\_overview

Get an event's public overview as shown on its registration page: title, description, schedule, timezone, and the pub...

#### list\_resources

List event resources with paging and filters. This is the largest collection in a Goldcast organization, so always fi...

#### get\_resource

Get one resource by ID. Use list\_resources to find resource IDs.

#### create\_resource

Attach a resource to an event, booth, or broadcast. Requires event, name, key\_or\_url, and content\_type. Use list\_even...

#### update\_resource

Update a resource. Only the fields you pass are changed. Use list\_resources to find resource IDs.Passing null does no...

#### delete\_resource

Delete a resource permanently. This cannot be undone. Use list\_resources to find resource IDs.

#### create\_event\_sponsor

Grant someone sponsor access to an event. `user` is an object with at least an email address, not a user ID — a bare...

#### get\_sponsor\_booth

Get one sponsor booth by ID, including its branding, resources, and demo-request setup. Goldcast has no sponsor-booth...

#### update\_sponsor\_booth

Update a sponsor booth. Call create\_event\_sponsor for this event FIRST: `email` must belong to an existing sponsor th...

#### create\_sponsor\_resource

Attach a resource to a sponsor booth. Requires event, name, key\_or\_url, and object\_id (the booth ID) — the API return...

#### get\_sponsor\_resource

Get one sponsor booth resource by ID. Goldcast has no sponsor-resource list endpoint; the IDs appear in the \`resource...

#### update\_sponsor\_resource

Update a sponsor booth resource. Only the fields you pass are changed. Resource IDs appear in the `resources` field o...

#### delete\_sponsor\_resource

Delete a sponsor booth resource permanently. This cannot be undone. Resource IDs appear in the `resources` field of g...

#### list\_tags

List tags in the organization's tag library, with paging and filters. Tags returned here are the valid values for the...

#### get\_tag

Get one tag-library entry by ID. Use list\_tags to find tag IDs.

#### create\_tag

Create a tag in the organization's tag library. Tags are the values that events, booths, broadcasts, and discussion g...

#### update\_tag

Rename a tag, or move it to another organization. Only the fields you pass are changed. Renaming affects every event,...

#### delete\_tag

Delete a tag from the organization's tag library permanently. This removes it from every event, booth, and broadcast...

#### list\_ticket\_types

List ticket types with paging, optionally filtered to one event. Ticket types are the valid values for a track's allo...

#### get\_ticket\_type

Get one ticket type by ID. Use list\_ticket\_types to find ticket type IDs.

#### create\_ticket\_type

Create a ticket type on an event. Requires event and label. Use list\_events to find event IDs and list\_tracks for all...

#### update\_ticket\_type

Update a ticket type. Only the fields you pass are changed. Use list\_ticket\_types to find ticket type IDs.Passing nul...

#### delete\_ticket\_type

Delete a ticket type permanently. This cannot be undone. Use list\_ticket\_types to find ticket type IDs.

#### list\_tracks

List tracks with paging, filtered to one event. Tracks group an event's sessions and gate access by ticket type. Alwa...

#### get\_track

Get one track by ID, including its allowed ticket types and assigned agenda items. Use list\_tracks to find track IDs....

#### create\_track

Create a track on an event. Only `event` is required; add a title and ordering to make it useful. Use list\_events to...

#### update\_track

Update a track. Only the fields you pass are changed. Use list\_tracks to find track IDs.Passing null does not clear a...

#### delete\_track

Delete a track permanently. This cannot be undone. Use list\_tracks to find track IDs.

#### get\_user\_magic\_link

Get a registrant's magic link for an event: a URL that signs them in and drops them straight into it. Identify the pe...

#### create\_webinar

Create a webinar: an event with a single broadcast. Needs only title, start\_time, end\_time, timezone, and broadcast\_t...

#### get\_webinar

Get one webinar by ID, including its broadcast and speaker configuration. Use list\_events with event\_type=\['Webinar']...

#### update\_webinar

Update a webinar. Only the fields you pass are changed. Use list\_events with event\_type=\['Webinar'] to find webinar I...