Skip to main content
Hex is a collaborative data platform for analytics, data science, and reporting. The Hex MCP server lets you manage projects, trigger runs, organize collections, and administer users and groups using natural language.

​
What Can It Do?

  • List and manage projects including status updates and sharing permissions
  • Trigger and monitor project runs with optional input parameters
  • Organize work with collections for grouping related projects
  • Manage data connections to external databases and warehouses
  • Administer users and groups for workspace access control

​
Where to Use It

Add Hex as a tool to any agent. The agent can then manage your Hex workspace conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Hex tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Run my weekly analytics project”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

​
Projects

​
Runs

​
Collections

​
Data Connections

​
Administration

​
Example Prompts

Use these with your agent or in the Agent Node: List projects:
Run a project:
Check run status:
Cancel a run:
Manage collections:
Share a project:
Manage groups:

​
Troubleshooting

Agents are smart enough to chain multiple API calls together. For example, asking “Run my latest project and check the status” will find the project, trigger a run, and poll for completion. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Hex MCP server using credentials from your Connectors page.