Merge Unified's Hex integration Merge Agent Handler's Hex MCP server

Connect your AI Agents to Hex in minutes

Merge lets you securely connect your agents to Hex and thousands of tools instantly

Start building for free

Read docs

Hex

Learn more about Merge Agent Handler

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

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: {"type": "DATABASE"|"SCHEMA"|"TABLE", "name": "", "status": "INCLUDED"|"EXCLUDED"}.

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 pagination. Use cursor from page_info for next page.

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_users to find user IDs.

share_project_groups

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

share_project_collections

Add a project to collections with specific access levels (APP_ONLY, CAN_VIEW, CAN_EDIT, FULL_ACCESS, NONE). Use list_collections to find collection IDs.

update_project_visibility

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

run_project

Trigger a run of a published project. Optionally pass input parameters, notification configs, and cache settings. Project must be published first.

list_project_runs

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

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 cell's static ID.

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.

validate_credential

Validate Hex API token by retrieving the current user profile.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Hex MCP server

Explore other MCP servers built and managed by Merge

ActiveCampaign

Adobe PDF Services

Ahrefs

Airtable

Amadeus

Amazon S3

Amplitude

Anaplan

Apollo

Arize

Articulate Reach 360

Asana

Attio

Aviationstack

BambooHR

Basecamp

Bitbucket

Bitly

Box

CMS Coverage

Calendly

Canva

ClickUp

ClinicalTrials.gov

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now