> 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.

# Make

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

## Sample use cases

* List every scenario in the `Marketing Ops` folder that errored in the last 24 hours.
* Pause the `Daily Sync` scenario while we run the migration.
* Find scenarios that haven't been edited in over 6 months.

## Available Tools

#### list\_connections

List connections for a team. Requires teamId - use list\_teams first to get valid team IDs.

#### get\_connection

Get connection details by ID including account info and scopes. Use list\_connections first to find valid IDs.

#### delete\_connection

Delete a connection. Set confirmed=true if the connection is used in scenarios to force deletion.

#### verify\_connection

Verify a connection is working by testing it against the external service. Returns verified=true if successful.

#### list\_hooks

List webhooks for a team. Requires teamId - use list\_teams first. Filter by assigned status or hook type.

#### get\_hook

Get webhook details by ID including URL, status, and queue info. Use list\_hooks first to find valid IDs.

#### create\_hook

Create a new webhook to receive external data. Set method, headers, and stringify options for request handling.

#### update\_hook

Update webhook name or enabled status. Use get\_hook first to see current values.

#### delete\_hook

Delete a webhook. Set confirmed=true if the hook is used in scenarios to force deletion.

#### enable\_hook

Enable a webhook to start receiving data. The hook URL will accept incoming requests.

#### disable\_hook

Disable a webhook to stop receiving data. Incoming requests will be rejected until re-enabled.

#### list\_organizations

List organizations the authenticated user has access to. Use this to get organization IDs for other operations.

#### get\_organization

Get organization details by ID including license info and datacenter zone. Use list\_organizations first.

#### list\_apps

List installed apps for an organization. Use appName values as accountType when creating connections with create\_connection.

#### list\_scenarios

List scenarios in a team with optional filtering by folder, active status, or type. Use list\_organizations and list\_teams first to get valid IDs.

#### get\_scenario

Get scenario details by ID including blueprint, scheduling, and status. Use list\_scenarios first to find valid scenario IDs.

#### create\_scenario

Create a new scenario. Blueprint needs 'name', 'flow', 'metadata.version'. Use scheduling type 'on-demand' for manual trigger or 'indefinitely' with interval for recurring.

#### update\_scenario

Update scenario name, blueprint, scheduling, or folder. Use get\_scenario first to see current values.

#### delete\_scenario

Permanently delete a scenario. This action cannot be undone. Use get\_scenario to verify before deletion.

#### run\_scenario

Execute a scenario immediately with optional input data. Set responsive=true to wait for results.

#### start\_scenario

Activate a scenario to enable scheduled execution. The scenario will run according to its scheduling configuration.

#### stop\_scenario

Deactivate a scenario to stop scheduled execution. The scenario can be reactivated later with start\_scenario.

#### clone\_scenario

Clone a scenario to a new team. Use list\_organizations and list\_teams to get valid target IDs.

#### list\_teams

List teams in an organization. Requires organizationId - use list\_organizations first to get valid IDs.

#### get\_team

Get team details by ID. Use list\_teams first to find valid team IDs.

#### create\_team

Create a new team. May require license upgrade if team limit reached. Requires organizationId from list\_organizations.

#### delete\_team

Delete a team. This will delete all scenarios, connections, and hooks in the team. Cannot be undone.