Connect Hex to AI agents

Connect Hex to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

create_embedding_url

Create Embedding URL

Generate a presigned URL for embedding a Hex app in an external application. Supports custom user attributes, input parameter defaults, display options (theme, padding, headers), export scopes, and configurable URL expiration.

manage_collection

Manage Collection

Create a new collection or update an existing collection's name and description. Collections serve as organizational containers for Hex projects.

manage_group

Manage Group

Create a new group or update an existing group's name and membership. When creating, provide a name and optionally initial member user IDs. When updating, provide the group ID and any combination of new name, users to add, and users to remove.

cancel_run

Cancel Run

Cancel an active project run. Only runs with PENDING or RUNNING status can be cancelled.

run_project

Run Project

Trigger a run of the latest published version of a Hex project. Supports custom input parameters, saved views, cache control, and notifications for run completion (via Slack, users, or groups).

deactivate_user

Deactivate User

Deactivate a user from the Hex workspace. The user will lose access to the workspace. If your workspace uses Directory Sync, users should be managed there instead.

list_projects

List Projects

List Hex projects in the workspace. Supports filtering by status, category, creator, owner, or collection. Returns paginated results sorted by most recently created first.

get_data_connection

Get Data Connection

Retrieve detailed configuration for a specific data connection, including connection type, description, and metadata.

get_run_status

Get Run Status

Get the current status and details of a specific project run. Returns the run status (PENDING, RUNNING, ERRORED, COMPLETED, KILLED), timestamps, and elapsed time.

list_collections

List Collections

List all collections in the Hex workspace. Collections are organizational containers for projects. Returns paginated results with collection names, descriptions, and timestamps.

update_project_status

Update Project Status

Add or remove a status (including endorsements) from a Hex project. Set status to null to remove the current status.

list_users

List Users

List workspace users with their name, email, role, and last login date. Results are paginated and can be sorted.

list_groups

List Groups

List all groups in the Hex workspace. Returns group names, IDs, and creation dates with pagination support.

list_data_connections

List Data Connections

List all data connections configured in the Hex workspace. Returns connection names, types, and metadata with pagination support.

delete_group

Delete Group

Delete a group from the Hex workspace. This removes the group and its associated permissions.

get_project

Get Project

Retrieve detailed metadata about a single Hex project, including title, description, status, categories, creator, owner, timestamps, and optionally sharing permissions.

list_project_runs

List Project Runs

List API-triggered runs of a Hex project. Can filter by run status (PENDING, RUNNING, ERRORED, COMPLETED, KILLED). Returns run details including status, timestamps, and notifications.

get_queried_tables

Get Queried Tables

Retrieve the list of warehouse tables queried by a Hex project. Useful for observability and understanding data dependencies. Returns connection and table information.

manage_project_sharing

Manage Project Sharing

Configure sharing permissions for a Hex project. Supports setting access at multiple levels: individual users, groups, collections, workspace-wide, and public web. Access levels include NONE, APP_ONLY, CAN_VIEW, CAN_EDIT, and FULL_ACCESS. You can update one or more sharing levels in a single call.

create_project

Create Project

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

More integrations teams use with Hex

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Heroku

Deploy, manage, and scale applications on Heroku's cloud platform. Create and configure apps, scale dynos, provision add-ons (databases, caching, etc.), manage configuration variables, build and release code, add custom domains and SSL certificates, manage collaborators and team permissions, configure pipelines for continuous delivery, set up log drains, and sync data with Salesforce via Heroku Connect. Subscribe to webhooks for real-time notifications on app changes, builds, releases, dyno lifecycle events, and more.

Technical notes for Hex

Manage and orchestrate data projects in a collaborative Hex workspace. List, create, and retrieve projects. Trigger and monitor runs of published projects with custom input parameters. Manage project sharing and access controls for users, groups, and collections. Generate presigned URLs for embedding Hex apps externally. Create, list, and manage users, groups, and collections. Configure data connections to external databases (Snowflake, BigQuery, Databricks, PostgreSQL, etc.) with schema filters and sharing permissions. Manage cells (SQL and code) within project drafts. Create, update, and publish guides. Ingest and manage semantic models. Retrieve observability data on queried tables.

Connect Hex to production AI agents

See how Metorial gives Hex access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Hex to AI agents with Metorial.

  1. Can Metorial connect Hex to AI agents?
    Yes. Metorial connects AI agents to Hex through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.