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

# Hex

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

## Sample use cases

* Run the `Daily KPI` Hex project and post the summary in #leadership.
* List Hex projects shared with `external@partner.com` for a security review.
* Find projects that haven't been opened in 90 days.

## Available Tools

#### list_cells

List cells in a project with pagination. Use cursor from page_info for next page.

#### get_cell

Get a cell by ID within a project.

#### create_cell

Create a new cell in a project. Pass cell type and content in cell_data.

#### update_cell

Update a cell's content or configuration within a project.

#### delete_cell

Delete a cell from a project permanently.

#### list_collections

List collections in the workspace with pagination. Use cursor from page_info for next page.

#### get_collection

Get a collection by ID including name, description, creator, and sharing settings.

#### create_collection

Create a new collection to organize projects.

#### update_collection

Update a collection's name or description.

#### list_data_connections

List accessible data connections with pagination. Use cursor from page_info for next page.

#### get_data_connection

Get a data connection by ID including configuration, sharing, and schema settings.

#### create_data_connection

Create a new data connection. Requires name, type (e.g. snowflake, postgres, bigquery), and type-specific connection...

#### update_data_connection

Update a data connection's name, description, configuration, or sharing settings.

#### update_connection_schema

Update a data connection's schema filters to include or exclude databases, schemas, or tables. Each update: .

#### list_groups

List workspace groups with pagination. Sort by CREATED_AT or NAME. Use cursor from page_info for next page.

#### get_group

Get a group by ID including name and creation date.

#### create_group

Create a new workspace group with optional initial members. Use list_users to find user IDs for members.

#### update_group

Update a group's name and membership. Add or remove users by ID. Use list_users to find user IDs.

#### delete_group

Delete a workspace group permanently. This cannot be undone.

#### list_guide_drafts

List guide drafts with pagination. Use cursor from page_info for next page.

#### upsert_guide_draft

Create or update a guide draft. Pass guide data including title, content, and configuration.

#### publish_guide_drafts

Publish guide drafts. Optionally specify guide IDs, or omit to publish all drafts.

#### delete_guide_draft

Delete a guide draft permanently. Use list_guide_drafts to find IDs.

#### get_queried_tables

Get warehouse tables queried within a project. Enterprise plan only. Use list_projects to find project IDs.

#### list_projects

List projects in the workspace. Filter by status, category, creator, owner, or collection. Supports sorting and pagin...

#### get_project

Get metadata for a single project by ID. Optionally include sharing details.

#### create_project

Create a new project in the workspace with a title and optional description.

#### update_project

Update a project's status or endorsements.

#### share_project_users

Share a project with specific users. Set access level per user (CAN_VIEW, CAN_EDIT, FULL_ACCESS, NONE). Use list_user...

#### share_project_groups

Share a project with groups. Set access level per group (CAN_VIEW, CAN_EDIT, FULL_ACCESS, NONE). Use list_groups to f...

#### share_project_collections

Add a project to collections with specific access levels (APP_ONLY, CAN_VIEW, CAN_EDIT, FULL_ACCESS, NONE). Use list\_...

#### update_project_visibility

Update workspace-wide and public web sharing for a project. Access levels: NONE, APP_ONLY, CAN_VIEW, CAN_EDIT, FULL_A...

#### run_project

Trigger a run of a published project. Optionally pass input parameters, notification configs, and cache settings. Pro...

#### list_project_runs

List run history for a project. Filter by status (PENDING, RUNNING, ERRORED, COMPLETED, KILLED) or trigger type (API,...

#### get_run_status

Get detailed status of a specific project run including timing, state events, and notifications.

#### cancel_run

Cancel an in-progress project run. Only works on runs with PENDING or RUNNING status.

#### get_run_chart_image

Get a rendered PNG chart image from a completed project run. Returns base64-encoded image data. Requires the chart ce...

#### get_current_user

Get the authenticated user's profile including name, email, and workspace role.

#### list_users

List workspace users with pagination. Use cursor from page_info for next page.

#### deactivate_user

Deactivate a workspace user. Use list_users to find user IDs. This action cannot be undone via API.