How do I use hex-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hex-mcp-server list my recent Hex project runs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

hex-mcp-server

by chuotdelongchamp

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

hex-mcp-server

A standalone Model Context Protocol (MCP) server for the Hex API. Zero dependencies, runs anywhere Node.js is available.

Connect your AI assistant (Cortex Code, Claude Desktop, Cursor, etc.) to your Hex workspace to audit projects, users, data connections, trigger runs, and more.

Features

58 tools covering the entire Hex public API
Zero npm dependencies — single self-contained Node.js file
MCP-native — JSON-RPC 2.0 over stdio, works with any MCP client
Cursor-based pagination on all list endpoints
Sensitive token handling — token never hardcoded, passed via environment variable

Related MCP server: Databricks MCP Server

Tools

Users

Tool	Description
`hex-get-me`	Get current authenticated user (validates token)
`hex-list-users`	List workspace users (paginated)
`hex-deactivate-user`	Deactivate a user (their tokens stop working)

Projects

Tool	Description
`hex-list-projects`	List all projects with filters (status, category, creator, owner)
`hex-get-project`	Get detailed project metadata
`hex-create-project`	Create a new project
`hex-update-project`	Add/remove status or endorsements
`hex-export-project`	Export a project as `.hex.yaml`
`hex-batch-update-compute-profile`	Batch update kernel image/size on multiple projects

Project Runs

Tool	Description
`hex-run-project`	Trigger a published project run
`hex-get-run-status`	Check status of a project run
`hex-get-project-runs`	List runs for a project (filter by status/trigger)
`hex-cancel-run`	Cancel an active project run
`hex-get-queried-tables`	Get warehouse tables queried by a project (Enterprise)
`hex-get-chart-image-from-run`	Get PNG of a chart cell from a completed run

Tool	Description
`hex-edit-project-sharing-collections`	Add/remove project from collections
`hex-edit-project-sharing-groups`	Add/update/remove group sharing access
`hex-edit-project-sharing-users`	Add/update/remove user sharing access
`hex-edit-project-sharing-workspace`	Update workspace or public-web sharing

Cells

Tool	Description
`hex-list-cells`	List cells in a project (code, SQL, markdown)
`hex-get-cell`	Get a single cell by ID
`hex-create-cell`	Create a new cell in project draft
`hex-update-cell`	Update cell source and/or data connection
`hex-delete-cell`	Delete a cell from project draft
`hex-get-chart-image-from-logic`	Get rendered PNG of a chart cell from draft
`hex-get-cell-output`	Get cell output (unstable)

Groups

Tool	Description
`hex-list-groups`	List workspace groups
`hex-get-group`	Get group details with members
`hex-create-group`	Create a new group
`hex-edit-group`	Edit group name/members
`hex-delete-group`	Delete a group

Collections

Tool	Description
`hex-list-collections`	List workspace collections
`hex-get-collection`	Get collection details
`hex-create-collection`	Create a new collection
`hex-edit-collection`	Edit collection name/description/sharing

Data Connections

Tool	Description
`hex-list-data-connections`	List all data connections
`hex-get-data-connection`	Get data connection details
`hex-create-data-connection`	Create a new data connection
`hex-edit-data-connection`	Edit connection details/credentials/sharing
`hex-update-data-connection-schema`	Add/remove endorsements on schemas/tables

Embedding

Tool	Description
`hex-create-presigned-url`	Create an embedded URL for iframe embedding

Agent Threads

Tool	Description
`hex-list-threads`	List agent threads (filter by source, user, type)
`hex-get-thread`	Get thread details and status
`hex-create-thread`	Start a new agent thread with a prompt
`hex-continue-thread`	Send a follow-up prompt to an idle thread
`hex-get-thread-messages`	List messages in a thread
`hex-list-topics`	List thread topics in the workspace

Guides

Tool	Description
`hex-upsert-guide-draft`	Create or update guide drafts
`hex-list-draft-guides`	List draft guides
`hex-delete-guide-draft`	Delete a guide draft
`hex-publish-guide-drafts`	Publish all drafted guides

Semantic Projects

Tool	Description
`hex-update-semantic-project`	Add/remove statuses from datasets and views
`hex-ingest-semantic-project`	Ingest a semantic project

Suggestions

Tool	Description
`hex-list-suggestions`	List context suggestions
`hex-get-suggestion`	Get suggestion with evidence and proposed changes
`hex-update-suggestion`	Update suggestion status
`hex-update-suggestion-change`	Update status of an individual proposed change
`hex-trigger-suggestion-review`	Trigger a background review agent run

Quick Start

1. Get a Hex API token

Go to Hex > Settings > API Keys and create a Personal Access Token (hxtp_...) or a Workspace Token (hxtw_...).

2. Configure your MCP client

Cortex Code / Claude Desktop / Cursor

Add to your MCP config file:

{
  "servers": {
    "hex": {
      "command": "node",
      "args": ["/path/to/hex-mcp-server/build/index.js"],
      "env": {
        "HEX_BASE_URL": "https://app.hex.tech",
        "HEX_API_TOKEN": "hxtw_your_token_here"
      }
    }
  }
}

EU customers: Use https://eu.hex.tech as the base URL.
Single-tenant: Use your custom Hex domain (e.g., https://yourorg.hex.tech).

3. Restart your MCP client

The Hex tools will appear automatically.

Environment Variables

Variable	Required	Description
`HEX_API_TOKEN`	Yes	Hex API token (`hxtp_...` or `hxtw_...`)
`HEX_BASE_URL`	No	Hex instance URL (default: `https://app.hex.tech`)

API Coverage

This server implements all 58 endpoints of the Hex Public API. Some endpoints may require specific token scopes or plan levels (Team/Enterprise).

Requirements

Node.js 18+ (no npm install needed)

License

MIT

Available Tools

58 tools

hex-batch-update-compute-profileC

Batch update kernel image/size on multiple projects.

Inputs: projectIds (required), computeProfile (required).

hex-cancel-runC

Cancel an active project run.

Inputs: runId (required), projectId (required).

hex-continue-threadC

Send a follow-up prompt to an idle agent thread.

Inputs: prompt (required), threadId (required).

hex-create-cellC

Create a new cell in the draft version of a project.

Inputs: cellType (required), projectId (required), source, afterCellId.

hex-create-collectionC

Create a new collection in the workspace.

Inputs: name (required), members, description.

hex-create-data-connectionC

Create a new data connection in the workspace.

Inputs: name (required), type (required), connectionDetails (required), description.

hex-create-groupC

Create a new group in the workspace.

Inputs: name (required), members.

hex-create-presigned-urlC

Create an embedded URL for a project (for iframe embedding).

Inputs: projectId (required), scope, expiresIn, inputParameters, +1 more.

hex-create-projectC

Create a new project with title and optional description.

Inputs: title (required), description.

hex-create-threadB

Start a new agent thread with a prompt (runs asynchronously).

Inputs: prompt (required), projectId.

hex-deactivate-userB

Deactivate a user in the workspace. Their tokens will stop working.

Inputs: userId (required).

hex-delete-cellC

Delete a cell from the draft version of a project.

Inputs: cellId (required).

hex-delete-groupC

Delete a group from the workspace.

Inputs: groupId (required).

hex-delete-guide-draftC

Delete a guide draft by ID.

Inputs: orgGuideFileId (required).

hex-edit-collectionC

Edit a collection (name, description, sharing).

Inputs: collectionId (required), name, sharing, description.

hex-edit-data-connectionC

Edit a data connection (name, description, credentials, sharing).

Inputs: dataConnectionId (required), name, sharing, description, +1 more.

hex-edit-groupC

Edit a group (name, members).

Inputs: groupId (required), name, members.

hex-export-projectC

Export a project as .hex.yaml format.

Inputs: projectId (required).

hex-get-cellC

Get a single cell by ID.

Inputs: cellId (required).

hex-get-cell-outputC

Get cell output (unstable API). Returns the output of a cell.

Inputs: cellId (required).

hex-get-chart-image-from-logicB

Get rendered PNG of a chart cell from the draft session.

Inputs: cellId (required), width, height.

hex-get-chart-image-from-runC

Get PNG of a chart cell from a completed project run.

Inputs: runId (required), staticId (required), projectId (required), width, +1 more.

hex-get-collectionB

Get details of a single collection by ID.

Inputs: collectionId (required).

hex-get-data-connectionC

Get details of a single data connection by ID.

Inputs: dataConnectionId (required).

hex-get-groupA

Get details of a single group by ID, including members.

Inputs: groupId (required).

hex-get-meA

Get the currently authenticated Hex user (validates token).

Inputs: no named parameters.

hex-get-projectC

Get detailed metadata for a single Hex project by ID.

Inputs: projectId (required), includeSharing.

hex-get-project-runsC

List all API-triggered runs for a project. Filter by status or trigger type.

Inputs: projectId (required), limit, offset, statusFilter, +1 more.

hex-get-queried-tablesA

Get the list of warehouse tables queried by a project (Enterprise plan only).

Inputs: projectId (required).

hex-get-run-statusC

Get the status of a specific project run.

Inputs: runId (required), projectId (required).

hex-get-suggestionC

Get a suggestion including evidence sources and proposed changes.

Inputs: suggestionId (required).

hex-get-threadC

Get details and status of an agent thread.

Inputs: threadId (required).

hex-get-thread-messagesC

List messages in a thread (chronological, paginated).

Inputs: threadId (required), after, limit.

hex-ingest-semantic-projectC

Ingest a semantic project from uploaded data.

Inputs: semanticProjectId (required), data.

hex-list-cellsC

List cells (code, SQL, markdown) from the draft version of a project.

Inputs: projectId (required), after, limit.

hex-list-collectionsC

List all collections in the Hex workspace.

Inputs: after, limit, sortBy, sortDirection.

hex-list-data-connectionsC

List all data connections configured in the Hex workspace.

Inputs: after, limit, sortBy, sortDirection.

hex-list-draft-guidesC

List draft guides (paginated).

Inputs: after, limit.

hex-list-groupsC

List all groups in the Hex workspace.

Inputs: after, limit, sortBy, sortDirection.

hex-list-projectsB

List all viewable projects. Supports filtering by status, category, creator, owner, collection.

Inputs: after, limit, sortBy, statuses, +9 more.

hex-list-suggestionsC

List context suggestions (paginated, filterable by status).

Inputs: after, limit, sortBy, status, +1 more.

hex-list-threadsC

List agent threads in the workspace. Filter by source, user, type.

Inputs: type, after, limit, source, +1 more.

hex-list-topicsB

List thread topics in the workspace, sorted by name.

Inputs: no named parameters.

hex-list-usersB

List all users in the Hex workspace. Supports pagination (limit, after).

Inputs: after, limit, sortBy, sortDirection.

hex-publish-guide-draftsB

Publish all currently drafted guides.

Inputs: no named parameters.

hex-run-projectB

Trigger a run of a published Hex project. Optionally provide input parameters and cache control.

Inputs: projectId (required), inputParams, useCachedSqlResults, updatePublishedResults.

hex-trigger-suggestion-reviewC

Trigger a background review agent run for a suggestion.

Inputs: suggestionId (required).

hex-update-cellC

Update a cell's source and/or data connection.

Inputs: cellId (required), source, dataConnectionId.

hex-update-data-connection-schemaC

Add/remove statuses (endorsements) from databases, schemas, tables in a data connection.

Inputs: updates (required), dataConnectionId (required).

hex-update-projectC

Add or remove a status (including endorsements) from a project.

Inputs: projectId (required), status.

hex-update-semantic-projectC

Add/remove statuses from datasets and views in a semantic project.

Inputs: semanticProjectId (required), status.

hex-update-suggestionC

Update a suggestion status (OPEN, COMPLETED, DISMISSED, etc.).

Inputs: status (required), suggestionId (required).

hex-update-suggestion-changeC

Update the status of an individual proposed change within a suggestion.

Inputs: changeId (required), suggestionId (required), status.

hex-upsert-guide-draftC

Update or create guide drafts by filePath.

Inputs: guides (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.7/5.0

Scored 2026-09-28 15:00 across 58 tools

Disambiguation4/5

Most tools target distinct resource+action pairs, with clear descriptions separating similar operations like chart image from draft vs run, or suggestion vs suggestion-change updates. A few boundaries are fuzzy (e.g. hex-update-project for status/endorsements vs hex-update-semantic-project, and edit/update verb overlap across resources), but these are minor and descriptions disambiguate.

Naming Consistency4/5

The hex-<verb>-<resource> pattern is largely consistent across hyphenated names. Minor deviations appear in verb choice (edit vs update for similar operations) and edge cases like hex-get-me and hex-batch-update-compute-profile, but the overall convention remains predictable.

Tool Count1/5

58 tools is far beyond the typical 3-15 well-scoped range and exceeds the 50+ threshold for extreme mismatch. Even accounting for the broad Hex platform surface, this volume creates a heavy cognitive load for an agent.

Completeness3/5

Core lifecycle coverage exists for many resources (projects, cells, collections, data connections, groups, threads, suggestions), but notable gaps remain: no delete for projects, collections, data connections, or threads; no single-guide get; users only have deactivate, not create. These gaps are significant enough that agents will hit dead ends for some administrative workflows.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcp
com.skopik
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Agent Orchestration Knowledge & Memory Search
2
https://api.skopik.com/mcp
LiveContext
ai.livecontext
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Agent Orchestration App Automation Data Platforms
1
https://livecontext.ai/mcp
AI Agent
io.github.supnim
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
Agent Orchestration Project Management Search
1
https://aiagent.app/mcp
Priorify
app.priorify
Agent-complete, permission-scoped product operations for Priorify workspaces.
Product Management
1
https://priorify.app/mcp

Related MCP Servers

Holaspirit MCP Server
App Automation Project Management Developer Tools
syucream
A
license
Not graded
quality
D
maintenance
Provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with organizational data such as tasks, circles, roles, and meetings through a standardized interface.
Updated a year ago (2025-07-01 08:35 UTC)
54 npm
1
MIT
Databricks MCP Server
Cloud Platforms Data Platforms Developer Tools
nainikayakkali
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with Databricks workspaces programmatically, providing comprehensive tools for cluster management, notebook operations, job orchestration, Unity Catalog data governance, user management, permissions control, and FinOps cost analytics.
Updated a year ago (2025-11-06 00:50 UTC)
335 npm
MIT
mcp-openhexa
Data Platforms Developer Tools Search
mcrimi
F
license
Not graded
quality
D
maintenance
Enables interaction with OpenHEXA platform through Claude Desktop, allowing users to query workspaces, list datasets, search pipelines, and view pipeline runs using natural language.
Updated a year ago (2025-07-04 16:03 UTC)
1
-
Dock
Databases Data Platforms Workplace & Productivity
try-dock-ai
A
license
Not graded
quality
D
maintenance
Enables MCP-capable agents to interact with Dock workspaces, including reading, creating, updating, and deleting rows, managing workspaces, and retrieving activity logs.
Updated 7 months ago (2026-04-21 00:01 UTC)
5 npm
MIT

hex-mcp-server

Features

Tools

Users

Projects

Project Runs

Project Sharing

Cells

Groups

Collections

Data Connections

Embedding

Agent Threads

Guides

Semantic Projects

Suggestions

Quick Start

1. Get a Hex API token

2. Configure your MCP client

Cortex Code / Claude Desktop / Cursor

3. Restart your MCP client

Environment Variables

API Coverage

Requirements

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Holaspirit MCP Server

Databricks MCP Server

mcp-openhexa

Dock