hex-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HEX_BASE_URL | No | Hex instance URL (default: `https://app.hex.tech`) | https://app.hex.tech |
| HEX_API_TOKEN | Yes | Hex API token (`hxtp_...` or `hxtw_...`) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hex-get-meA | Get the currently authenticated Hex user (validates token). |
| hex-list-usersB | List all users in the Hex workspace. Supports pagination (limit, after). |
| hex-list-projectsB | List all viewable projects. Supports filtering by status, category, creator, owner, collection. |
| hex-get-projectC | Get detailed metadata for a single Hex project by ID. |
| hex-list-groupsC | List all groups in the Hex workspace. |
| hex-get-groupA | Get details of a single group by ID, including members. |
| hex-list-collectionsC | List all collections in the Hex workspace. |
| hex-list-data-connectionsC | List all data connections configured in the Hex workspace. |
| hex-get-data-connectionC | Get details of a single data connection by ID. |
| hex-run-projectB | Trigger a run of a published Hex project. Optionally provide input parameters and cache control. |
| hex-get-run-statusC | Get the status of a specific project run. |
| hex-get-project-runsC | List all API-triggered runs for a project. Filter by status or trigger type. |
| hex-cancel-runC | Cancel an active project run. |
| hex-list-cellsC | List cells (code, SQL, markdown) from the draft version of a project. |
| hex-get-queried-tablesA | Get the list of warehouse tables queried by a project (Enterprise plan only). |
| hex-list-threadsC | List agent threads in the workspace. Filter by source, user, type. |
| hex-get-threadC | Get details and status of an agent thread. |
| hex-create-cellC | Create a new cell in the draft version of a project. |
| hex-get-cellC | Get a single cell by ID. |
| hex-update-cellC | Update a cell's source and/or data connection. |
| hex-delete-cellC | Delete a cell from the draft version of a project. |
| hex-get-chart-image-from-logicB | Get rendered PNG of a chart cell from the draft session. |
| hex-get-cell-outputC | Get cell output (unstable API). Returns the output of a cell. |
| hex-create-collectionC | Create a new collection in the workspace. |
| hex-get-collectionB | Get details of a single collection by ID. |
| hex-edit-collectionC | Edit a collection (name, description, sharing). |
| hex-list-topicsB | List thread topics in the workspace, sorted by name. |
| hex-create-data-connectionC | Create a new data connection in the workspace. |
| hex-edit-data-connectionC | Edit a data connection (name, description, credentials, sharing). |
| hex-update-data-connection-schemaC | Add/remove statuses (endorsements) from databases, schemas, tables in a data connection. |
| hex-create-presigned-urlC | Create an embedded URL for a project (for iframe embedding). |
| hex-create-groupC | Create a new group in the workspace. |
| hex-delete-groupC | Delete a group from the workspace. |
| hex-edit-groupC | Edit a group (name, members). |
| hex-upsert-guide-draftC | Update or create guide drafts by filePath. |
| hex-list-draft-guidesC | List draft guides (paginated). |
| hex-delete-guide-draftC | Delete a guide draft by ID. |
| hex-publish-guide-draftsB | Publish all currently drafted guides. |
| hex-create-projectC | Create a new project with title and optional description. |
| hex-batch-update-compute-profileC | Batch update kernel image/size on multiple projects. |
| hex-export-projectC | Export a project as .hex.yaml format. |
| hex-update-projectC | Add or remove a status (including endorsements) from a project. |
| hex-get-chart-image-from-runC | Get PNG of a chart cell from a completed project run. |
| hex-edit-project-sharing-collectionsC | Add or remove a project from collections. |
| hex-edit-project-sharing-groupsC | Add, update, or remove group sharing access for a project. |
| hex-edit-project-sharing-usersB | Add, update, or remove user sharing access for a project. |
| hex-edit-project-sharing-workspaceC | Update workspace or public-web sharing settings for a project. |
| hex-update-semantic-projectC | Add/remove statuses from datasets and views in a semantic project. |
| hex-ingest-semantic-projectC | Ingest a semantic project from uploaded data. |
| hex-list-suggestionsC | List context suggestions (paginated, filterable by status). |
| hex-get-suggestionC | Get a suggestion including evidence sources and proposed changes. |
| hex-update-suggestionC | Update a suggestion status (OPEN, COMPLETED, DISMISSED, etc.). |
| hex-update-suggestion-changeC | Update the status of an individual proposed change within a suggestion. |
| hex-trigger-suggestion-reviewC | Trigger a background review agent run for a suggestion. |
| hex-create-threadB | Start a new agent thread with a prompt (runs asynchronously). |
| hex-continue-threadC | Send a follow-up prompt to an idle agent thread. |
| hex-get-thread-messagesC | List messages in a thread (chronological, paginated). |
| hex-deactivate-userB | Deactivate a user in the workspace. Their tokens will stop working. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 58 tools
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.
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.
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.
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.