Integration

Hex integration

Hex is a collaborative data workspace of SQL and Python notebooks published as data apps. Run published projects with input values and track or cancel runs, list and inspect projects, read and edit draft notebook cells, get chart images and SQL cell output, export a project as YAML, start and follow Hex agent threads, manage collections, groups, users, sharing, data connections, guides and context suggestions, create embedding URLs, and read agent credit usage. Semantic model ingestion and endorsement routes are not exposed. Authentication is a personal access or workspace token sent as a Bearer token; the host is app.hex.tech for most workspaces, or the workspace's own Hex host (eu, a single-tenant or HIPAA name).

Connect Hex How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Hex.Built from the 58 Hex tools below, on the connection you add once.

What you can do with Hex

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Group, 6 operations

create_groupCreate groupPOSTCreates a user group with a name and optional members (users by id). Returns the group with its id.
delete_groupDelete groupDELETEDeletes a user group by id.
edit_groupEdit groupPATCHRenames a user group, or adds and removes its members (members.add and members.remove, by user id).
edit_project_sharing_groupsEdit project sharing groupsPATCHAdd groups to a project or update/remove their project sharing access. Use CAN_VIEW for the UI permission labeled "Can explore" and APP_ONLY for "Can view app". Use NONE to remove a group's access.
get_groupGet groupGETReturns one user group by id with its name and creation date.
list_groupsList groupsGETLists the user groups of the workspace with their id, name and creation date; userId returns only the groups that user belongs to.

Cell, 5 operations

create_cellCreate cellPOSTCreates a CODE, SQL or MARKDOWN cell in a project's draft notebook, appended at the end unless location says where. Returns the new cell with its id. Limited to 30 requests per minute.
delete_cellDelete cellDELETEDeletes a cell from a project's draft notebook by its id. Limited to 30 requests per minute.
get_cellGet cellGETReturns one cell of a project's draft notebook by id: its type, label, source contents, static id and, for a SQL cell, its data connection. Limited to 30 requests per minute.
list_cellsList cellsGETList cells from the draft version of a project. Returns code, SQL, and markdown cell contents.
update_cellUpdate cellPATCHUpdate a cell's source and/or data connection. For SQL cells, can update the SQL source, output dataframe, and data connection. For code and markdown cells, can update the source. Returns the updated cell.

Collection, 5 operations

create_collectionCreate collectionPOSTCreates a collection with a name, an optional description and optional sharing with users, groups or the whole workspace. Returns the collection with its id.
edit_collectionEdit collectionPATCHRenames a collection, changes its description, or adds, updates or removes the users, groups or workspace it is shared with (sharing.upsert).
edit_project_sharing_collectionsEdit project sharing collectionsPATCHAdd a project to collections or remove it from collections. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
get_collectionGet collectionGETReturns one collection by id with its name, description, creator and sharing.
list_collectionsList collectionsGETLists the collections of the workspace (groups of projects shared together) with their id, name, description and creator, one page at a time.

Data connection, 4 operations

create_data_connectionCreate data connectionPOSTCreates a workspace data connection of the given type (athena, bigquery, clickhouse, databricks, postgres, redshift, snowflake, trino) with its connection details and optional sharing and schema settings.
edit_data_connectionEdit data connectionPATCHUpdates a workspace data connection: name, description, connection details, sharing, schema refresh schedule and access, schema filters, sensitivity, writeback, SSH and AI settings. Only the fields sent change.
get_data_connectionGet data connectionGETReturns one workspace data connection by id with its type, name, description, connection details, sharing, sensitivity, schema refresh and filter settings.
list_data_connectionsList data connectionsGETLists the workspace's data connections with their type, name, description, connection details, sharing, sensitivity and schema settings, one page at a time.

Project, 4 operations

create_projectCreate projectPOSTCreate a new project in the workspace with the specified title, and optionally a description.
get_projectGet projectGETReturns one project's metadata: title, description, type, creator, owner, status, categories, app analytics, schedules and timestamps, plus its sharing when includeSharing is true.
list_projectsList projectsGETLists the projects the token can view, newest first by default, filterable by status, category, creator, owner or collection; archived, trashed and unlisted projects and components are opt-in.
update_project_statusUpdate project statusPATCHAdd or remove a status, including endorsements, from a project.

Run, 4 operations

cancel_runCancel runDELETECancels a running project run, identified by its project and runId (from run_project or list_project_runs).
get_run_statusGet run statusGETReturns one project run: its status, trigger, start and end time, elapsed time, run URL and notifications; send enable-expanded-stats=true for its state events.
list_project_runsList project runsGETGet the status of runs of a project. By default, all run types are returned (API-triggered, scheduled, and publish/refresh runs). Use the `runTriggerFilter` parameter to filter to a specific type.
run_projectRun projectPOSTRuns the latest published version of a project, optionally with input values, a saved view or notifications. Returns runId and runStatusUrl right away; follow the run with get_run_status.

Suggestion, 3 operations

get_suggestionGet suggestionGETGet a single context suggestion by id, including its evidence sources and the proposed changes from its most recent review run.
list_suggestionsList suggestionsGETLists the workspace's context suggestions (title, summary, status, dates, review agent status), filtered by status (OPEN by default), one page at a time.
update_suggestionUpdate suggestionPOSTSets the status of a context suggestion (OPEN, IN_PROGRESS, COMPLETED, RESOLVED or DISMISSED, with a rejectionReason when dismissing) and returns the updated suggestion.

Thread, 3 operations

create_threadCreate threadPOSTStarts a Hex agent thread with a prompt; the agent analyzes data and answers asynchronously. Returns the thread id and URL: call get_thread until its status is IDLE to read the answer.
get_threadGet threadGETGet the response of an agent thread. Returns the current status (RUNNING, IDLE, or ERROR) and the agent's response content when available.
list_threadsList threadsGETList agent threads in the workspace, sorted by most recently created first. Requires Manager org role or higher.

Draft, 2 operations

delete_guide_draftDelete guide draftDELETEDeletes the draft of a guide file by its id, as returned by list_draft_guides.
upsert_guide_draftUpsert guide draftPUTCreates or updates guide drafts by filePath: a missing guide is created, otherwise its draft is created or replaced. forceWrite overwrites a same-named guide synced from another source. Publish them with publish_guide_drafts.

Image, 2 operations

get_cell_chart_imageGet cell chart imageGETGet the rendered PNG image of a chart cell from the project's current notebook (draft) session. The cell must have been executed and must not be in an error state. Only chart-type cells are supported.
get_run_chart_imageGet run chart imageGETGet the rendered PNG image of a chart cell from a completed run by staticCellId. The cell must have been executed and must not be in an error state. Only chart-type cells are supported.

User, 2 operations

edit_project_sharing_usersEdit project sharing usersPATCHAdd users to a project or update/remove their project sharing access. Use CAN_VIEW for the UI permission labeled "Can explore" and APP_ONLY for "Can view app". Use NONE to remove a user's access.
list_usersList usersGETLists the users of the workspace with their id, name, email, role and last login date, optionally filtered by group or user ids, one page at a time.

Agent usage, 1 operation

list_agent_usageList agent usageGETList per-agent-run credit usage for the workspace, most recent run first. Requires workspace admin, or a workspace token with the agent usage read scope. Each row aggregates one agent run's credit consumption.

Batch, 1 operation

batch_update_compute_profileBatch update compute profilePOSTUpdate the compute profile (kernel image and/or kernel size) on one or more projects in a single request. At least one of kernelImage or kernelSize must be provided; the change applies to both the logic and published compute profiles.

Change, 1 operation

update_suggestion_changeUpdate suggestion changePOSTUpdate the status of an individual proposed change within a context suggestion. The change is either a file update or a data-warehouse update, selected by `updateTarget`.

Create presigned url, 1 operation

create_presigned_urlCreate presigned urlPOSTCreates a signed URL that embeds a project's published app, with optional user attributes, input values, display options, extra scopes and an expiry in milliseconds. Returns url.

Credit grant, 1 operation

list_credit_grantsList credit grantsGETList the workspace's credit grants, most recent first. Requires workspace admin, or a workspace token with the agent usage read scope. Each row is one credit grant.

Deactivate, 1 operation

deactivate_userDeactivate userPOSTDeactivates a workspace user. A deactivated user's personal access tokens stop working.

Export, 1 operation

export_projectExport projectPOSTExports a project, its draft or latest published version, in the *.hex.yaml format. Returns filename and the YAML text in content.

Followup, 1 operation

continue_threadContinue threadPOSTContinue an existing agent thread with a follow-up prompt. This endpoint does not support queuing: the thread must be idle before a follow-up can be sent.

List, 1 operation

list_draft_guidesList draft guidesGETLists the draft guide files of the workspace with their id and file path, one page at a time. Limited to 30 requests per minute.

Me, 1 operation

get_current_userGet current userGETReturns information about the current logged in user. User metadata will be omitted when authenticating with a workspace token.

Message, 1 operation

list_thread_messagesList thread messagesGETList the messages in an agent thread, rendered as a single flat list of text blocks. Within a page messages are chronological (oldest first); each text block is prefixed with the authoring role, and thinking and error blocks are tagged.

Output, 1 operation

get_cell_outputGet cell outputGETUnstable: This endpoint is unstable API. Hex may make breaking changes to this endpoint without notice. Get the latest output preview for a SQL cell in the active draft notebook session.

Publish, 1 operation

publish_guide_draftsPublish guide draftsPOSTPublishes draft guides: the listed orgGuideFileIds, or every draft when publishAllDraftGuides is true. Returns the published guides with their file paths.

Queried table, 1 operation

list_queried_tablesList queried tablesGETGiven a project ID, return the list of warehouse tables queried in the project.

Review, 1 operation

trigger_suggestion_reviewTrigger suggestion reviewPOSTTrigger a background review agent run for the given context suggestion. If a review is already in flight for this suggestion, returns the current run.

Schema, 1 operation

update_data_connection_schema_statusUpdate data connection schema statusPATCHAdds or removes a status (including endorsements) on databases, schemas and tables of a data connection. The batch is atomic: if one update fails validation, nothing is applied.

Topic, 1 operation

list_topicsList topicsGETList thread topics in the workspace, sorted by name.

Workspace and public, 1 operation

edit_project_sharing_workspace_and_publicEdit project sharing workspace and publicPATCHUpdate workspace or public-web sharing for a project. For projects, use CAN_VIEW to grant the UI permission labeled "Can explore" and APP_ONLY for "Can view app". Use NONE to remove access. Omitted fields are left unchanged.

Use Hex from Claude Code, Cursor or Codex

Connect Hex in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Hex operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Hex

Create your workspace
Sign up free. Nothing to install.
Connect Hex once
Add your Hex connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.